nss-systemd(8) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | EXAMPLE | SEE ALSO | NOTES | COLOPHON

NSS-SYSTEMD(8)                   nss-systemd                  NSS-SYSTEMD(8)

NAME         top

       nss-systemd, libnss_systemd.so.2 - Provide UNIX user and group name
       resolution for user/group lookup via Varlink

SYNOPSIS         top

       libnss_systemd.so.2

DESCRIPTION         top

       nss-systemd is a plug-in module for the GNU Name Service Switch (NSS)
       functionality of the GNU C Library (glibc), providing UNIX user and
       group name resolution for services implementing the User/Group Record
       Lookup API via Varlink[1], such as the system and service manager
       systemd(1) (for its DynamicUser= feature, see systemd.exec(5) for
       details) or systemd-homed.service(8).

       This module also ensures that the root and nobody users and groups
       (i.e. the users/groups with the UIDs/GIDs 0 and 65534) remain
       resolvable at all times, even if they aren't listed in /etc/passwd or
       /etc/group, or if these files are missing.

       This module preferably utilizes systemd-userdbd.service(8) for
       resolving users and groups, but also works without the service
       running.

       To activate the NSS module, add "systemd" to the lines starting with
       "passwd:" and "group:" in /etc/nsswitch.conf.

       It is recommended to place "systemd" after the "files" or "compat"
       entry of the /etc/nsswitch.conf lines so that /etc/passwd and
       /etc/group based mappings take precedence.

EXAMPLE         top

       Here is an example /etc/nsswitch.conf file that enables nss-systemd
       correctly:

           passwd:         compat mymachines systemd
           group:          compat [SUCCESS=merge] mymachines [SUCCESS=merge] systemd
           shadow:         compat

           hosts:          mymachines resolve [!UNAVAIL=return] myhostname files dns
           networks:       files

           protocols:      db files
           services:       db files
           ethers:         db files
           rpc:            db files

           netgroup:       nis

SEE ALSO         top

       systemd(1), systemd.exec(5), nss-resolve(8), nss-myhostname(8),
       nss-mymachines(8), nsswitch.conf(5), getent(1)

NOTES         top

        1. User/Group Record Lookup API via Varlink
           https://systemd.io/USER_GROUP_API

COLOPHON         top

       This page is part of the systemd (systemd system and service manager)
       project.  Information about the project can be found at 
       ⟨http://www.freedesktop.org/wiki/Software/systemd⟩.  If you have a bug
       report for this manual page, see
       ⟨http://www.freedesktop.org/wiki/Software/systemd/#bugreports⟩.  This
       page was obtained from the project's upstream Git repository
       ⟨https://github.com/systemd/systemd.git⟩ on 2020-06-09.  (At that
       time, the date of the most recent commit that was found in the repos‐
       itory was 2020-06-09.)  If you discover any rendering problems in
       this HTML version of the page, or you believe there is a better or
       more up-to-date source for the page, or you have corrections or
       improvements to the information in this COLOPHON (which is not part
       of the original manual page), send a mail to man-pages@man7.org

systemd 245                                                   NSS-SYSTEMD(8)

Pages that refer to this page: userdbctl(1)systemd.exec(5)30-systemd-environment-d-generator(7)systemd.directives(7)systemd.index(7)libnss_myhostname.so.2(8)libnss_mymachines.so.2(8)libnss_resolve.so.2(8)nss-myhostname(8)nss-mymachines(8)nss-resolve(8)systemd-userdbd(8)systemd-userdbd.service(8)