X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsysusers.d.xml;h=1e079b21110397fcc80bce07048a0c276bb27c72;hb=ad95fd1d2b9c6344864857c2ba7634fd87753f8e;hp=40f8715bc0bbea51606c6508a3ece26c2b1d89bc;hpb=932ad62b84165b0acf690ea34c4b8083657ae244;p=elogind.git
diff --git a/man/sysusers.d.xml b/man/sysusers.d.xml
index 40f8715bc..1e079b211 100644
--- a/man/sysusers.d.xml
+++ b/man/sysusers.d.xml
@@ -53,32 +53,28 @@
Description
systemd-sysusers uses the
- files from /usr/lib/sysusers.d/
+ files from sysusers.d directory
to create system users and groups at package
- installation or boot time. This tool may be used for
- allocating system users and groups only, it is not
+ installation or boot time. This tool may be used to
+ allocate system users and groups only, it is not
useful for creating non-system users and groups, as it
- accessed /etc/passwd and
+ accesses /etc/passwd and
/etc/group directly, bypassing
- any more complex user database, for example any
+ any more complex user databases, for example any
database involving NIS or LDAP.
-
- File Format
-
- Each file shall be named in the style of
- package.conf.
+ Configuration Format
- All files are sorted by their filename in
- lexicographic order, regardless of which of the
- directories they reside in. If multiple files specify
- the same user or group, the entry in the file with the
- lexicographically earliest name will be applied, all
- all other conflicting entries will be logged as
- errors. Users and groups are
- processed in the order they are listed.
+ Each configuration file shall be named in the
+ style of
+ package.conf
+ or
+ package-part.conf.
+ The second variant should be used when it is desirable
+ to make it easy to override just this part of
+ configuration.
The file format is one line per user or group
containing name, ID and GECOS field description:
@@ -106,7 +102,7 @@ m authd input
group will be set to the group
bearing the same name. The
user's shell will be set to
- /sbin/login,
+ /sbin/nologin,
the home directory to
/. The
account will be created
@@ -192,11 +188,40 @@ m authd input
+
+ Overriding vendor configuration
+
+ Note that systemd-sysusers
+ will do nothing if the specified users or groups
+ already exist, so normally there no reason to override
+ sysusers.d vendor configuration,
+ except to block certain users or groups from being
+ created.
+
+ Files in /etc/sysusers.d
+ override files with the same name in
+ /usr/lib/sysusers.d and
+ /run/sysusers.d. Files in
+ /run/sysusers.d override files
+ with the same name in
+ /usr/lib/sysusers.d. The scheme is the same as for
+ tmpfiles.d5,
+ except for the directory name.
+
+ If the administrator wants to disable a
+ configuration file supplied by the vendor, the
+ recommended way is to place a symlink to
+ /dev/null in
+ /etc/sysusers.d/ bearing the
+ same filename.
+
+
See Also
systemd1,
- systemd-sysusers8
+ systemd-sysusers8,
+ tmpfiles.d5