1NSS-SYSTEMD(8)                    nss-systemd                   NSS-SYSTEMD(8)
2
3
4

NAME

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

SYNOPSIS

10       libnss_systemd.so.2
11

DESCRIPTION

13       nss-systemd is a plug-in module for the GNU Name Service Switch (NSS)
14       functionality of the GNU C Library (glibc), providing UNIX user and
15       group name resolution for services implementing the User/Group Record
16       Lookup API via Varlink[1], such as the system and service manager
17       systemd(1) (for its DynamicUser= feature, see systemd.exec(5) for
18       details) or systemd-homed.service(8).
19
20       This module also ensures that the root and nobody users and groups
21       (i.e. the users/groups with the UIDs/GIDs 0 and 65534) remain
22       resolvable at all times, even if they aren't listed in /etc/passwd or
23       /etc/group, or if these files are missing.
24
25       This module preferably utilizes systemd-userdbd.service(8) for
26       resolving users and groups, but also works without the service running.
27
28       To activate the NSS module, add "systemd" to the lines starting with
29       "passwd:" and "group:" in /etc/nsswitch.conf.
30
31       It is recommended to place "systemd" after the "files" or "compat"
32       entry of the /etc/nsswitch.conf lines so that /etc/passwd and
33       /etc/group based mappings take precedence.
34

EXAMPLE

36       Here is an example /etc/nsswitch.conf file that enables nss-systemd
37       correctly:
38
39           passwd:         compat mymachines systemd
40           group:          compat [SUCCESS=merge] mymachines [SUCCESS=merge] systemd
41           shadow:         compat
42
43           hosts:          files mymachines resolve [!UNAVAIL=return] dns myhostname
44           networks:       files
45
46           protocols:      db files
47           services:       db files
48           ethers:         db files
49           rpc:            db files
50
51           netgroup:       nis
52

SEE ALSO

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

NOTES

58        1. User/Group Record Lookup API via Varlink
59           https://systemd.io/USER_GROUP_API
60
61
62
63systemd 245                                                     NSS-SYSTEMD(8)
Impressum