diff options
| author | Lennart Poettering <lennart@poettering.net> | 2021-05-07 12:18:07 +0200 |
|---|---|---|
| committer | Lennart Poettering <lennart@poettering.net> | 2021-05-10 18:02:50 +0200 |
| commit | c96a30121399caf9ae458fd90ab1ad32ab2a0c92 (patch) | |
| tree | 480eee95edabe7e2b9e420aebeeef681d01f61b3 /man/userdbctl.xml | |
| parent | userdbctl: add two new switches --with-dropin=/--with-varlink= (diff) | |
| download | systemd-c96a30121399caf9ae458fd90ab1ad32ab2a0c92.tar.xz systemd-c96a30121399caf9ae458fd90ab1ad32ab2a0c92.zip | |
man: document new userdbctl features
Diffstat (limited to 'man/userdbctl.xml')
| -rw-r--r-- | man/userdbctl.xml | 37 |
1 files changed, 36 insertions, 1 deletions
diff --git a/man/userdbctl.xml b/man/userdbctl.xml index 896ad22256..0871306b20 100644 --- a/man/userdbctl.xml +++ b/man/userdbctl.xml @@ -39,7 +39,10 @@ url="https://systemd.io/USER_RECORD">JSON User Records</ulink> and <ulink url="https://systemd.io/GROUP_RECORD">JSON Group Records</ulink> definitions), and classic UNIX NSS/glibc user and group records. This tool is primarily a client to the <ulink - url="https://systemd.io/USER_GROUP_API">User/Group Record Lookup API via Varlink</ulink>.</para> + url="https://systemd.io/USER_GROUP_API">User/Group Record Lookup API via Varlink</ulink>, and may also + pick up drop-in JSON user and group records from <filename>/etc/userdb/</filename>, + <filename>/run/userdb/</filename>, <filename>/run/host/userdb/</filename>, + <filename>/use/lib/userdb/</filename>.</para> </refsect1> <refsect1> @@ -87,6 +90,27 @@ </varlistentry> <varlistentry> + <term><option>--with-varlink=</option><replaceable>BOOL</replaceable></term> + + <listitem><para>Controls whether to include Varlink user/group lookups in the output, i.e. those done + via the <ulink url="https://systemd.io/USER_GROUP_API">User/Group Record Lookup API via + Varlink</ulink>. If <option>--with-varlink=no</option> is used any attempts to resolve or enumerate + users/groups provided only via Varlink are suppressed. If <option>--with-varlink=yes</option> is + specified such users/groups are included in the output (which is the default).</para></listitem> + </varlistentry> + + <varlistentry> + <term><option>--with-dropin=</option><replaceable>BOOL</replaceable></term> + + <listitem><para>Controls whether to include user/group lookups in the output that are defined using + drop-in files in <filename>/etc/userdb/</filename>, <filename>/run/userdb/</filename>, + <filename>/run/host/userdb/</filename>, <filename>/use/lib/userdb/</filename>. If + <option>--with-dropin=no</option> is used these records are suppressed. If + <option>--with-dropin=yes</option> is specified such users/groups are included in the output (which + is the default).</para></listitem> + </varlistentry> + + <varlistentry> <term><option>--synthesize=</option><replaceable>BOOL</replaceable></term> <listitem><para>Controls whether to synthesize records for the root and nobody users/groups if they @@ -228,6 +252,17 @@ data, however the NSS/glibc APIs necessarily expose a more reduced set of fields only.</para></listitem> </varlistentry> + + <varlistentry> + <term><constant>io.systemd.DropIn</constant></term> + + <listitem><para>This service is (also) provided by + <citerefentry><refentrytitle>systemd-userdbd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry> + and picks up JSON user/group records from <filename>/etc/userdb/</filename>, + <filename>/run/userdb/</filename>, <filename>/run/host/userdb/</filename>, + <filename>/use/lib/userdb/</filename>.</para></listitem> + </varlistentry> + </variablelist> <para>Note that <command>userdbctl</command> has internal support for NSS-based lookups too. This means |