Bug 1440530 - add options (sss, systemd, myhostname) 'nsswitch.conf' documentation
Summary: add options (sss, systemd, myhostname) 'nsswitch.conf' documentation
Keywords:
Status: NEW
Alias: None
Product: Fedora
Classification: Fedora
Component: man-pages
Version: 39
Hardware: Unspecified
OS: Unspecified
unspecified
unspecified
Target Milestone: ---
Assignee: Nikola Forró
QA Contact: Fedora Extras Quality Assurance
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2017-04-09 17:01 UTC by René Genz
Modified: 2023-08-16 07:04 UTC (History)
3 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed:
Type: Bug
Embargoed:


Attachments (Terms of Use)

Description René Genz 2017-04-09 17:01:33 UTC
Description of problem:
`realm join` added some options to /etc/nsswitch.conf.
I tried to look them up with `man nsswitch.conf` and `info nsswitch.conf` to no avail. They are not explained.

Version-Release number of selected component (if applicable):
$ rpm -qf /usr/share/man/man5/nsswitch.conf.5.gz
man-pages-4.09-3.fc26.noarch

How reproducible:
100% and easy

Steps to Reproduce:
1.man nsswitch.conf

Actual results:
Options not listed are:
-at passwd: 'sss' and 'systemd'
-at hosts: 'myhostname'

Expected results:
Add description to documentation for said options.

Additional info:
Maybe more options are missing.

The upstream version is affected:
http://man7.org/linux/man-pages/man5/nsswitch.conf.5.html

Comment 1 John Dodson 2017-11-29 12:30:30 UTC
See also: https://bugzilla.redhat.com/show_bug.cgi?id=1517403

Comment 2 Fedora End Of Life 2018-05-03 08:35:57 UTC
This message is a reminder that Fedora 26 is nearing its end of life.
Approximately 4 (four) weeks from now Fedora will stop maintaining
and issuing updates for Fedora 26. It is Fedora's policy to close all
bug reports from releases that are no longer maintained. At that time
this bug will be closed as EOL if it remains open with a Fedora  'version'
of '26'.

Package Maintainer: If you wish for this bug to remain open because you
plan to fix it in a currently maintained version, simply change the 'version'
to a later Fedora version.

Thank you for reporting this issue and we are sorry that we were not
able to fix it before Fedora 26 is end of life. If you would still like
to see this bug fixed and are able to reproduce it against a later version
of Fedora, you are encouraged  change the 'version' to a later Fedora
version prior this bug is closed as described in the policy above.

Although we aim to fix as many bugs as possible during every release's
lifetime, sometimes those efforts are overtaken by events. Often a
more recent Fedora release includes newer upstream software that fixes
bugs or makes them obsolete.

Comment 3 Ben Cotton 2018-11-27 15:50:42 UTC
This message is a reminder that Fedora 27 is nearing its end of life.
On 2018-Nov-30  Fedora will stop maintaining and issuing updates for
Fedora 27. It is Fedora's policy to close all bug reports from releases
that are no longer maintained. At that time this bug will be closed as
EOL if it remains open with a Fedora  'version' of '27'.

Package Maintainer: If you wish for this bug to remain open because you
plan to fix it in a currently maintained version, simply change the 'version' 
to a later Fedora version.

Thank you for reporting this issue and we are sorry that we were not 
able to fix it before Fedora 27 is end of life. If you would still like 
to see this bug fixed and are able to reproduce it against a later version 
of Fedora, you are encouraged  change the 'version' to a later Fedora 
version prior this bug is closed as described in the policy above.

Although we aim to fix as many bugs as possible during every release's 
lifetime, sometimes those efforts are overtaken by events. Often a 
more recent Fedora release includes newer upstream software that fixes 
bugs or makes them obsolete.

Comment 4 Ben Cotton 2019-05-02 20:13:04 UTC
This message is a reminder that Fedora 28 is nearing its end of life.
On 2019-May-28 Fedora will stop maintaining and issuing updates for
Fedora 28. It is Fedora's policy to close all bug reports from releases
that are no longer maintained. At that time this bug will be closed as
EOL if it remains open with a Fedora 'version' of '28'.

Package Maintainer: If you wish for this bug to remain open because you
plan to fix it in a currently maintained version, simply change the 'version' 
to a later Fedora version.

Thank you for reporting this issue and we are sorry that we were not 
able to fix it before Fedora 28 is end of life. If you would still like 
to see this bug fixed and are able to reproduce it against a later version 
of Fedora, you are encouraged  change the 'version' to a later Fedora 
version prior this bug is closed as described in the policy above.

Although we aim to fix as many bugs as possible during every release's 
lifetime, sometimes those efforts are overtaken by events. Often a 
more recent Fedora release includes newer upstream software that fixes 
bugs or makes them obsolete.

Comment 5 John Dodson 2019-11-11 01:02:53 UTC
There has been a minor improvement in FC30 (a comment added in /etc/nsswitch.conf for sss)
but the problem essentially persists in FC30.

Comment 6 Ben Cotton 2020-04-30 20:44:06 UTC
This message is a reminder that Fedora 30 is nearing its end of life.
Fedora will stop maintaining and issuing updates for Fedora 30 on 2020-05-26.
It is Fedora's policy to close all bug reports from releases that are no longer
maintained. At that time this bug will be closed as EOL if it remains open with a
Fedora 'version' of '30'.

Package Maintainer: If you wish for this bug to remain open because you
plan to fix it in a currently maintained version, simply change the 'version' 
to a later Fedora version.

Thank you for reporting this issue and we are sorry that we were not 
able to fix it before Fedora 30 is end of life. If you would still like 
to see this bug fixed and are able to reproduce it against a later version 
of Fedora, you are encouraged  change the 'version' to a later Fedora 
version prior this bug is closed as described in the policy above.

Although we aim to fix as many bugs as possible during every release's 
lifetime, sometimes those efforts are overtaken by events. Often a 
more recent Fedora release includes newer upstream software that fixes 
bugs or makes them obsolete.

Comment 7 Fedora Program Management 2021-04-29 15:53:07 UTC
This message is a reminder that Fedora 32 is nearing its end of life.
Fedora will stop maintaining and issuing updates for Fedora 32 on 2021-05-25.
It is Fedora's policy to close all bug reports from releases that are no longer
maintained. At that time this bug will be closed as EOL if it remains open with a
Fedora 'version' of '32'.

Package Maintainer: If you wish for this bug to remain open because you
plan to fix it in a currently maintained version, simply change the 'version' 
to a later Fedora version.

Thank you for reporting this issue and we are sorry that we were not 
able to fix it before Fedora 32 is end of life. If you would still like 
to see this bug fixed and are able to reproduce it against a later version 
of Fedora, you are encouraged  change the 'version' to a later Fedora 
version prior this bug is closed as described in the policy above.

Although we aim to fix as many bugs as possible during every release's 
lifetime, sometimes those efforts are overtaken by events. Often a 
more recent Fedora release includes newer upstream software that fixes 
bugs or makes them obsolete.

Comment 8 Ben Cotton 2022-05-12 16:17:08 UTC
This message is a reminder that Fedora Linux 34 is nearing its end of life.
Fedora will stop maintaining and issuing updates for Fedora Linux 34 on 2022-06-07.
It is Fedora's policy to close all bug reports from releases that are no longer
maintained. At that time this bug will be closed as EOL if it remains open with a
'version' of '34'.

Package Maintainer: If you wish for this bug to remain open because you
plan to fix it in a currently maintained version, change the 'version' 
to a later Fedora Linux version.

Thank you for reporting this issue and we are sorry that we were not 
able to fix it before Fedora Linux 34 is end of life. If you would still like 
to see this bug fixed and are able to reproduce it against a later version 
of Fedora Linux, you are encouraged to change the 'version' to a later version
prior to this bug being closed.

Comment 9 Ben Cotton 2022-11-29 16:45:06 UTC
This message is a reminder that Fedora Linux 35 is nearing its end of life.
Fedora will stop maintaining and issuing updates for Fedora Linux 35 on 2022-12-13.
It is Fedora's policy to close all bug reports from releases that are no longer
maintained. At that time this bug will be closed as EOL if it remains open with a
'version' of '35'.

Package Maintainer: If you wish for this bug to remain open because you
plan to fix it in a currently maintained version, change the 'version' 
to a later Fedora Linux version.

Thank you for reporting this issue and we are sorry that we were not 
able to fix it before Fedora Linux 35 is end of life. If you would still like 
to see this bug fixed and are able to reproduce it against a later version 
of Fedora Linux, you are encouraged to change the 'version' to a later version
prior to this bug being closed.

Comment 10 John Dodson 2022-11-29 21:03:40 UTC
Please update to FC36

Comment 11 Ben Cotton 2023-04-25 16:38:07 UTC
This message is a reminder that Fedora Linux 36 is nearing its end of life.
Fedora will stop maintaining and issuing updates for Fedora Linux 36 on 2023-05-16.
It is Fedora's policy to close all bug reports from releases that are no longer
maintained. At that time this bug will be closed as EOL if it remains open with a
'version' of '36'.

Package Maintainer: If you wish for this bug to remain open because you
plan to fix it in a currently maintained version, change the 'version' 
to a later Fedora Linux version. Note that the version field may be hidden.
Click the "Show advanced fields" button if you do not see it.

Thank you for reporting this issue and we are sorry that we were not 
able to fix it before Fedora Linux 36 is end of life. If you would still like 
to see this bug fixed and are able to reproduce it against a later version 
of Fedora Linux, you are encouraged to change the 'version' to a later version
prior to this bug being closed.

Comment 12 Nikola Forró 2023-04-25 17:26:28 UTC
The man page says:

On systems with additional libraries installed, you may have access to further services such as "hesiod", "ldap", "winbind", and "wins".

Are you suggesting it should include the 3 mentioned services in those examples?

"myhostname" is documented in nss-myhostname(8), "systemd" in nss-systemd(8), I don't see a man page documenting the "sss" service, but that should be reported to sssd, not man-pages.

Comment 13 René Genz 2023-04-25 18:21:12 UTC
> Are you suggesting it should include the 3 mentioned services in those examples?

That would OK if '"myhostname" is documented in nss-myhostname(8), "systemd" in nss-systemd(8)' is included somehow.
"/usr/share/man/man8/nss-systemd.8.gz" and "/usr/share/man/man8/nss-myhostname.8.gz" are provided by systemd package.

> I don't see a man page documenting the "sss" service, but that should be reported to sssd, not man-pages.

Due to your comment I found a hint in `man sssd-files`. In EXAMPLE section you can read:
>       To leverage caching of local users and groups by SSSD nss_sss module
>       must be listed before nss_files module in /etc/nsswitch.conf.
>
>           passwd:     sss files
>           group:      sss files

Indeed, "man nss-sss" does not exist. I filed: https://github.com/SSSD/sssd/issues/6704

Comment 14 John Dodson 2023-04-26 05:27:12 UTC
My original problem was that the file /etc/nsswitch.conf had inconsistent info.
And that in many cases manuals (man XXX) were either not clear or nonexistent
for /etc/nsswitch.conf related options.

It seems a lot of good work has been done.
The /etc/nsswitch.conf distributed with,

        FC37,
        authselect-libs-1.4.2-1.fc37.x86_64

is quite good in terms of information that points people in the right direction.

I've not had time to delve into all the manuals but I think that the info in
/etc/nsswitch.conf does now gives sufficient pointers & info.

Sadly one day some smarter person that us will consider those comments redundant &
remove them causing future suffering, but let's hope not.

Certainly if we are to follow the Unix philosophy man pages should exist for options
in /etc/nsswitch.conf unless documented elsewhere & relatively easily found.

Comment 15 Fedora Release Engineering 2023-08-16 07:04:05 UTC
This bug appears to have been reported against 'rawhide' during the Fedora Linux 39 development cycle.
Changing version to 39.


Note You need to log in before you can comment on or make changes to this bug.