shaba/systemd
1
0
Fork 0
mirror of https://github.com/systemd/systemd.git synced 2025-06-07 07:17:09 +03:00
Code

man: document new userdbd features

Browse Source
This commit is contained in:
Lennart Poettering 2021-05-07 12:17:57 +02:00
parent 71b5738030
commit 62a90b48d0
1 changed files with 11 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
man/systemd-userdbd.service.xml
View File

@ -32,7 +32,9 @@
<para><command>systemd-userdbd</command> is a system service that multiplexes user/group lookups to all <para><command>systemd-userdbd</command> is a system service that multiplexes user/group lookups to all
local services that provide JSON user/group record definitions to the system. In addition it synthesizes local services that provide JSON user/group record definitions to the system. In addition it synthesizes
JSON user/group records from classic UNIX/glibc NSS user/group records in order to provide full backwards JSON user/group records from classic UNIX/glibc NSS user/group records in order to provide full backwards
compatibility.</para> compatibility. It may also pick up statically defined JSON user/group records from drop-in files in
<filename>/etc/userdb/</filename>, <filename>/run/userdb/</filename>,
<filename>/run/host/userdb/</filename> and <filename>/use/lib/userdb/</filename>.</para>
<para>Most of <command>systemd-userdbd</command>'s functionality is accessible through the <para>Most of <command>systemd-userdbd</command>'s functionality is accessible through the
<citerefentry><refentrytitle>userdbctl</refentrytitle><manvolnum>1</manvolnum></citerefentry> <citerefentry><refentrytitle>userdbctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>
@ -45,16 +47,18 @@
multiplexes access other services implementing this API, too. It is thus both server and client of this multiplexes access other services implementing this API, too. It is thus both server and client of this
API.</para> API.</para>
<para>This service provides two distinct <ulink url="https://varlink.org/">Varlink</ulink> services: <para>This service provides three distinct <ulink url="https://varlink.org/">Varlink</ulink> services:
<constant>io.systemd.Multiplexer</constant> provides a single, unified API for querying JSON user and <constant>io.systemd.Multiplexer</constant> provides a single, unified API for querying JSON user and
group records. Internally it talks to all other user/group record services running on the system in group records. Internally it talks to all other user/group record services running on the system in
parallel and forwards any information discovered. This simplifies clients substantially since they need parallel and forwards any information discovered. This simplifies clients substantially since they need
to talk to a single service only instead of all of them in to talk to a single service only instead of all of them in
parallel. <constant>io.systemd.NameServiceSwitch</constant> provides compatibility with classic UNIX/glibc parallel. <constant>io.systemd.NameServiceSwitch</constant> provides compatibility with classic
NSS user records, i.e. converts <type>struct passwd</type> and <type>struct group</type> records as UNIX/glibc NSS user records, i.e. converts <type>struct passwd</type> and <type>struct group</type>
acquired with APIs such as <citerefentry records as acquired with APIs such as <citerefentry
project='man-pages'><refentrytitle>getpwnam</refentrytitle><manvolnum>1</manvolnum></citerefentry> to JSON project='man-pages'><refentrytitle>getpwnam</refentrytitle><manvolnum>1</manvolnum></citerefentry> to
user/group records, thus hiding the differences between the services as much as possible.</para> JSON user/group records, thus hiding the differences between the services as much as
possible. <constant>io.systemd.Dropin</constant> makes JSON user/group records from the aforementioned
drop-in directories available.</para>
</refsect1> </refsect1>
<refsect1> <refsect1>