summaryrefslogtreecommitdiffstats
path: root/man/sysusers.d.xml
diff options
context:
space:
mode:
authorDavid Michael <fedora.dm0@gmail.com>2020-01-30 20:04:14 +0100
committerLennart Poettering <lennart@poettering.net>2020-02-02 16:53:22 +0100
commit649916d3561ac41b41bfc5be6297a78847509abe (patch)
tree0aa48c2357b33511ef8697aac1b1a4c3edbfb894 /man/sysusers.d.xml
parentMerge pull request #14672 from yuwata/network-routing-policy-uidrange (diff)
downloadsystemd-649916d3561ac41b41bfc5be6297a78847509abe.tar.xz
systemd-649916d3561ac41b41bfc5be6297a78847509abe.zip
sysusers: support creating users with a specific primary group
This extends the "uid:gid" syntax for "u" lines so that a group name can be given instead of a GID. This requires that the group is either queued for creation by sysusers, or it is already defined on the system. Closes #14340
Diffstat (limited to 'man/sysusers.d.xml')
-rw-r--r--man/sysusers.d.xml11
1 files changed, 6 insertions, 5 deletions
diff --git a/man/sysusers.d.xml b/man/sysusers.d.xml
index 2e93715be6..72d8f62399 100644
--- a/man/sysusers.d.xml
+++ b/man/sysusers.d.xml
@@ -101,8 +101,8 @@ u root 0 "Superuser" /root /bin/zsh</pro
<term><varname>u</varname></term>
<listitem><para>Create a system user and group of the specified name should
they not exist yet. The user's primary group will be set to the group
- bearing the same name. The account will be created disabled, so that logins
- are not allowed.</para></listitem>
+ bearing the same name unless the ID field specifies it. The account will be
+ created disabled, so that logins are not allowed.</para></listitem>
</varlistentry>
<varlistentry>
@@ -166,9 +166,10 @@ u root 0 "Superuser" /root /bin/zsh</pro
path's owner/group. This is useful to create users whose UID/GID
match the owners of pre-existing files (such as SUID or SGID
binaries).
- The syntax <literal><replaceable>uid</replaceable>:<replaceable>gid</replaceable></literal> is also supported to
- allow creating user and group pairs with different numeric UID and GID values. The group with the indicated GID must get created explicitly before or it must already exist. Specifying <literal>-</literal> for the UID in this syntax
- is also supported.
+ The syntaxes <literal><replaceable>uid</replaceable>:<replaceable>gid</replaceable></literal> and
+ <literal><replaceable>uid</replaceable>:<replaceable>groupname</replaceable></literal> are supported to
+ allow creating users with specific primary groups. The given group must be created explicitly, or it
+ must already exist. Specifying <literal>-</literal> for the UID in these syntaxes is also supported.
</para>
<para>For <varname>m</varname> lines, this field should contain