diff options
Diffstat (limited to 'man/sysusers.d.html')
| -rw-r--r-- | man/sysusers.d.html | 20 |
1 files changed, 10 insertions, 10 deletions
diff --git a/man/sysusers.d.html b/man/sysusers.d.html index d300edaa51..d86a3fccb8 100644 --- a/man/sysusers.d.html +++ b/man/sysusers.d.html @@ -18,8 +18,8 @@ </style><a href="index.html">Index </a>· <a href="systemd.directives.html">Directives </a>· <a href="../python-systemd/index.html">Python </a>· - <a href="../libudev/index.html">libudev </a>· - <a href="../libudev/index.html">gudev </a><span style="float:right">systemd 220</span><hr><div class="refentry"><a name="sysusers.d"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sysusers.d — Declarative allocation of system users and groups</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><p><code class="filename">/usr/lib/sysusers.d/*.conf</code></p></div><div class="refsect1"><a name="idm139648881461920"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><span class="command"><strong>systemd-sysusers</strong></span> uses the files from + + <span style="float:right">systemd 221</span><hr><div class="refentry"><a name="sysusers.d"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>sysusers.d — Declarative allocation of system users and groups</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><p><code class="filename">/usr/lib/sysusers.d/*.conf</code></p></div><div class="refsect1"><a name="idm47422841739680"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><span class="command"><strong>systemd-sysusers</strong></span> uses the files from <code class="filename">sysusers.d</code> directory to create system users and groups at package installation or boot time. This tool may be used to allocate system users and groups only, it is not useful @@ -27,7 +27,7 @@ <code class="filename">/etc/passwd</code> and <code class="filename">/etc/group</code> directly, bypassing any more complex user databases, for example any database involving NIS or - LDAP.</p></div><div class="refsect1"><a name="idm139648881457760"></a><h2 id="Configuration Format">Configuration Format<a class="headerlink" title="Permalink to this headline" href="#Configuration%20Format">¶</a></h2><p>Each configuration file shall be named in the style of + LDAP.</p></div><div class="refsect1"><a name="idm47422841735408"></a><h2 id="Configuration Format">Configuration Format<a class="headerlink" title="Permalink to this headline" href="#Configuration%20Format">¶</a></h2><p>Each configuration file shall be named in the style of <code class="filename"><em class="replaceable"><code>package</code></em>.conf</code> or <code class="filename"><em class="replaceable"><code>package</code></em>-<em class="replaceable"><code>part</code></em>.conf</code>. The second variant should be used when it is desirable to make it @@ -37,7 +37,7 @@ u httpd 440 "HTTP User" u authd /usr/bin/authd "Authorization user" g input - - m authd input -u root 0 "Superuser" /root</pre><div class="refsect2"><a name="idm139648876555664"></a><h3 id="Type">Type<a class="headerlink" title="Permalink to this headline" href="#Type">¶</a></h3><p>The type consists of a single letter. The following line +u root 0 "Superuser" /root</pre><div class="refsect2"><a name="idm47422836829072"></a><h3 id="Type">Type<a class="headerlink" title="Permalink to this headline" href="#Type">¶</a></h3><p>The type consists of a single letter. The following line types are understood:</p><div class="variablelist"><dl class="variablelist"><dt id="u"><span class="term"><code class="varname">u</code></span><a class="headerlink" title="Permalink to this term" href="#u">¶</a></dt><dd><p>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 @@ -56,7 +56,7 @@ u root 0 "Superuser" /root</pre><div class="refsect2"><a name="idm13964887655566 compiled-in default. Note that both UIDs and GIDs are allocated from the same pool, in order to ensure that users and groups of the same name are likely to carry the same - numeric UID and GID.</p></dd></dl></div></div><div class="refsect2"><a name="idm139648876545712"></a><h3 id="Name">Name<a class="headerlink" title="Permalink to this headline" href="#Name">¶</a></h3><p>The name field specifies the user or group name. It should + numeric UID and GID.</p></dd></dl></div></div><div class="refsect2"><a name="idm47422836819120"></a><h3 id="Name">Name<a class="headerlink" title="Permalink to this headline" href="#Name">¶</a></h3><p>The name field specifies the user or group name. It should be shorter than 31 characters and avoid any non-ASCII characters, and not begin with a numeric character. It is strongly recommended to pick user and group names that are @@ -65,7 +65,7 @@ u root 0 "Superuser" /root</pre><div class="refsect2"><a name="idm13964887655566 all system and group names with the underscore, and avoiding too generic names.</p><p>For <code class="varname">m</code> lines this field should contain the user name to add to a group.</p><p>For lines of type <code class="varname">r</code> this field should - be set to "<code class="literal">-</code>".</p></div><div class="refsect2"><a name="idm139648876541920"></a><h3 id="ID">ID<a class="headerlink" title="Permalink to this headline" href="#ID">¶</a></h3><p>For <code class="varname">u</code> and <code class="varname">g</code> the + be set to "<code class="literal">-</code>".</p></div><div class="refsect2"><a name="idm47422836815328"></a><h3 id="ID">ID<a class="headerlink" title="Permalink to this headline" href="#ID">¶</a></h3><p>For <code class="varname">u</code> and <code class="varname">g</code> the numeric 32bit UID or GID of the user/group. Do not use IDs 65535 or 4294967295, as they have special placeholder meanings. Specify "<code class="literal">-</code>" for automatic UID/GID allocation @@ -78,11 +78,11 @@ u root 0 "Superuser" /root</pre><div class="refsect2"><a name="idm13964887655566 be set to a UID/GID range in the format "<code class="literal">FROM-TO</code>" where both values are formatted as decimal ASCII numbers. Alternatively, a single UID/GID may be - specified formatted as decimal ASCII numbers.</p></div><div class="refsect2"><a name="idm139648876536432"></a><h3 id="GECOS">GECOS<a class="headerlink" title="Permalink to this headline" href="#GECOS">¶</a></h3><p>A short, descriptive string for users to be created, + specified formatted as decimal ASCII numbers.</p></div><div class="refsect2"><a name="idm47422836809936"></a><h3 id="GECOS">GECOS<a class="headerlink" title="Permalink to this headline" href="#GECOS">¶</a></h3><p>A short, descriptive string for users to be created, enclosed in quotation marks. Note that this field may not contain colons.</p><p>Only applies to lines of type <code class="varname">u</code> and should otherwise be left unset, or be set to - "<code class="literal">-</code>".</p></div><div class="refsect2"><a name="idm139648876533728"></a><h3 id="Home Directory">Home Directory<a class="headerlink" title="Permalink to this headline" href="#Home%20Directory">¶</a></h3><p>The home directory for a new system user. If omitted + "<code class="literal">-</code>".</p></div><div class="refsect2"><a name="idm47422836807232"></a><h3 id="Home Directory">Home Directory<a class="headerlink" title="Permalink to this headline" href="#Home%20Directory">¶</a></h3><p>The home directory for a new system user. If omitted defaults to the root directory. It is recommended to not unnecessarily specify home directories for system users, unless software strictly requires one to be set.</p><p>Only applies to lines of type <code class="varname">u</code> and @@ -107,11 +107,11 @@ u root 0 "Superuser" /root</pre><div class="refsect2"><a name="idm13964887655566 the vendor, the recommended way is to place a symlink to <code class="filename">/dev/null</code> in the configuration directory in <code class="filename">/etc/</code>, with the same filename as the vendor - configuration file.</p></div><div class="refsect1"><a name="idm139648876530064"></a><h2 id="Idempotence">Idempotence<a class="headerlink" title="Permalink to this headline" href="#Idempotence">¶</a></h2><p>Note that <span class="command"><strong>systemd-sysusers</strong></span> will do + configuration file.</p></div><div class="refsect1"><a name="idm47422836803568"></a><h2 id="Idempotence">Idempotence<a class="headerlink" title="Permalink to this headline" href="#Idempotence">¶</a></h2><p>Note that <span class="command"><strong>systemd-sysusers</strong></span> will do nothing if the specified users or groups already exist, so normally there no reason to override <code class="filename">sysusers.d</code> vendor configuration, except to - block certain users or groups from being created.</p></div><div class="refsect1"><a name="idm139648876527440"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p> + block certain users or groups from being created.</p></div><div class="refsect1"><a name="idm47422836801040"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p> <a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>, <a href="systemd-sysusers.html"><span class="citerefentry"><span class="refentrytitle">systemd-sysusers</span>(8)</span></a> </p></div></div></body></html> |