diff options
author | David Michael <fedora.dm0@gmail.com> | 2020-01-30 20:04:14 +0100 |
---|---|---|
committer | Lennart Poettering <lennart@poettering.net> | 2020-02-02 16:53:22 +0100 |
commit | 649916d3561ac41b41bfc5be6297a78847509abe (patch) | |
tree | 0aa48c2357b33511ef8697aac1b1a4c3edbfb894 /man/sysusers.d.xml | |
parent | Merge pull request #14672 from yuwata/network-routing-policy-uidrange (diff) | |
download | systemd-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.xml | 11 |
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 |