Debian Codegraph @

upstream/debian-unstable/man8/systemd-userdbd.service.8

raw
1 '\" t
2 .TH "SYSTEMD\-USERDBD\&.SERVICE" "8" "" "systemd 261~rc3" "systemd-userdbd.service"
3 .\" -----------------------------------------------------------------
4 .\" * Define some portability stuff
5 .\" -----------------------------------------------------------------
6 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
7 .\" http://bugs.debian.org/507673
8 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
9 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
10 .ie \n(.g .ds Aq \(aq
11 .el .ds Aq '
12 .\" -----------------------------------------------------------------
13 .\" * set default formatting
14 .\" -----------------------------------------------------------------
15 .\" disable hyphenation
16 .nh
17 .\" disable justification (adjust text to left margin only)
18 .ad l
19 .\" -----------------------------------------------------------------
20 .\" * MAIN CONTENT STARTS HERE *
21 .\" -----------------------------------------------------------------
22 .SH "NAME"
23 systemd-userdbd.service, systemd-userdbd \- JSON User/Group Record Query Multiplexer/NSS Compatibility
24 .SH "SYNOPSIS"
25 .PP
26 systemd\-userdbd\&.service
27 .PP
28 /usr/lib/systemd/systemd\-userdbd
29 .SH "DESCRIPTION"
30 .PP
31 \fBsystemd\-userdbd\fR
32 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 JSON user/group records from classic UNIX/glibc NSS user/group records in order to provide full backwards compatibility\&. It may also pick up statically defined JSON user/group records from files in
33 /etc/userdb/,
34 /run/userdb/,
35 /run/host/userdb/
36 and
37 /usr/lib/userdb/
38 with the
39 "\&.user"
40 or
41 "\&.group"
42 extension\&. For more details about the extensions read the
43 \fBnss-systemd\fR(8)
44 manpage\&.
45 .PP
46 Most of
47 \fBsystemd\-userdbd\fR\*(Aqs functionality is accessible through the
48 \fBuserdbctl\fR(1)
49 command\&.
50 .PP
51 The user and group records this service provides access to follow the
52 \m[blue]\fBJSON User Records\fR\m[]\&\s-2\u[1]\d\s+2
53 and
54 \m[blue]\fBJSON Group Record\fR\m[]\&\s-2\u[2]\d\s+2
55 definitions\&. This service implements the
56 \m[blue]\fBUser/Group Record Lookup API via Varlink\fR\m[]\&\s-2\u[3]\d\s+2, and multiplexes access other services implementing this API, too\&. It is thus both server and client of this API\&.
57 .PP
58 This service provides three distinct
59 \m[blue]\fBVarlink\fR\m[]\&\s-2\u[4]\d\s+2
60 services:
61 \fBio\&.systemd\&.Multiplexer\fR
62 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 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 parallel\&.
63 \fBio\&.systemd\&.NameServiceSwitch\fR
64 provides compatibility with classic UNIX/glibc NSS user records, i\&.e\&. converts
65 \fBstruct passwd\fR
66 and
67 \fBstruct group\fR
68 records as acquired with APIs such as
69 \fBgetpwnam\fR(1)
70 to JSON user/group records, thus hiding the differences between the services as much as possible\&.
71 \fBio\&.systemd\&.DropIn\fR
72 makes JSON user/group records from the aforementioned drop\-in directories available\&.
73 .SH "SEE ALSO"
74 .PP
75 \fBsystemd\fR(1), \fBnss-systemd\fR(8), \fBuserdbctl\fR(1), \fBsystemd-homed.service\fR(8)
76 .SH "NOTES"
77 .IP " 1." 4
78 JSON User Records
79 .RS 4
80 \%https://systemd.io/USER_RECORD
81 .RE
82 .IP " 2." 4
83 JSON Group Record
84 .RS 4
85 \%https://systemd.io/GROUP_RECORD
86 .RE
87 .IP " 3." 4
88 User/Group Record Lookup API via Varlink
89 .RS 4
90 \%https://systemd.io/USER_GROUP_API
91 .RE
92 .IP " 4." 4
93 Varlink
94 .RS 4
95 \%https://varlink.org/
96 .RE