Debian Codegraph @

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

raw
1 '\" t
2 .TH "SYSTEMD\-LOGIND\&.SERVICE" "8" "" "systemd 261~rc3" "systemd-logind.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-logind.service, systemd-logind \- Login manager
24 .SH "SYNOPSIS"
25 .PP
26 systemd\-logind\&.service
27 .PP
28 /usr/lib/systemd/systemd\-logind
29 .SH "DESCRIPTION"
30 .PP
31 \fBsystemd\-logind\fR
32 is a system service that manages user logins\&. It is responsible for:
33 .sp
34 .RS 4
35 .ie n \{\
36 \h'-04'\(bu\h'+03'\c
37 .\}
38 .el \{\
39 .sp -1
40 .IP \(bu 2.3
41 .\}
42 Keeping track of users and sessions, their processes and their idle state\&. This is implemented by allocating a systemd slice unit for each user below
43 user\&.slice, and a scope unit below it for each concurrent session of a user\&. Also, a per\-user service manager is started as system service instance of
44 user@\&.service
45 for each logged in user\&.
46 .RE
47 .sp
48 .RS 4
49 .ie n \{\
50 \h'-04'\(bu\h'+03'\c
51 .\}
52 .el \{\
53 .sp -1
54 .IP \(bu 2.3
55 .\}
56 Generating and managing session IDs\&. If auditing is available and an audit session ID is already set for a session, then this ID is reused as the session ID\&. Otherwise, an independent session counter is used\&.
57 .RE
58 .sp
59 .RS 4
60 .ie n \{\
61 \h'-04'\(bu\h'+03'\c
62 .\}
63 .el \{\
64 .sp -1
65 .IP \(bu 2.3
66 .\}
67 Providing
68 \m[blue]\fBpolkit\fR\m[]\&\s-2\u[1]\d\s+2\-based access for users for operations such as system shutdown or sleep
69 .RE
70 .sp
71 .RS 4
72 .ie n \{\
73 \h'-04'\(bu\h'+03'\c
74 .\}
75 .el \{\
76 .sp -1
77 .IP \(bu 2.3
78 .\}
79 Implementing a shutdown/sleep inhibition logic for applications
80 .RE
81 .sp
82 .RS 4
83 .ie n \{\
84 \h'-04'\(bu\h'+03'\c
85 .\}
86 .el \{\
87 .sp -1
88 .IP \(bu 2.3
89 .\}
90 Handling of power/sleep hardware keys
91 .RE
92 .sp
93 .RS 4
94 .ie n \{\
95 \h'-04'\(bu\h'+03'\c
96 .\}
97 .el \{\
98 .sp -1
99 .IP \(bu 2.3
100 .\}
101 Multi\-seat management
102 .RE
103 .sp
104 .RS 4
105 .ie n \{\
106 \h'-04'\(bu\h'+03'\c
107 .\}
108 .el \{\
109 .sp -1
110 .IP \(bu 2.3
111 .\}
112 Session switch management
113 .RE
114 .sp
115 .RS 4
116 .ie n \{\
117 \h'-04'\(bu\h'+03'\c
118 .\}
119 .el \{\
120 .sp -1
121 .IP \(bu 2.3
122 .\}
123 Device access management for users
124 .RE
125 .sp
126 .RS 4
127 .ie n \{\
128 \h'-04'\(bu\h'+03'\c
129 .\}
130 .el \{\
131 .sp -1
132 .IP \(bu 2.3
133 .\}
134 Automatic spawning of text logins (gettys) on virtual console activation and user runtime directory management
135 .RE
136 .sp
137 .RS 4
138 .ie n \{\
139 \h'-04'\(bu\h'+03'\c
140 .\}
141 .el \{\
142 .sp -1
143 .IP \(bu 2.3
144 .\}
145 Scheduled shutdown
146 .RE
147 .sp
148 .RS 4
149 .ie n \{\
150 \h'-04'\(bu\h'+03'\c
151 .\}
152 .el \{\
153 .sp -1
154 .IP \(bu 2.3
155 .\}
156 Sending "wall" messages
157 .RE
158 .PP
159 User sessions are registered with logind via the
160 \fBpam_systemd\fR(8)
161 PAM module\&.
162 .PP
163 See
164 \fBlogind.conf\fR(5)
165 for information about the configuration of this service\&.
166 .PP
167 See
168 \fBsd-login\fR(3)
169 for information about the basic concepts of logind such as users, sessions and seats\&.
170 .PP
171 See
172 \fBorg.freedesktop.login1\fR(5)
173 and
174 \fBorg.freedesktop.LogControl1\fR(5)
175 for information about the D\-Bus APIs
176 systemd\-logind
177 provides\&.
178 .PP
179 In addition to the D\-Bus interface,
180 systemd\-logind
181 also provides a Varlink interface
182 \fBio\&.systemd\&.Shutdown\fR
183 for shutting down or rebooting the system\&. It supports
184 \fBPowerOff\fR,
185 \fBReboot\fR,
186 \fBHalt\fR,
187 \fBKExec\fR, and
188 \fBSoftReboot\fR
189 methods\&. Each method accepts an optional
190 \fIskipInhibitors\fR
191 boolean parameter to bypass active block inhibitors (matching the
192 \fBSD_LOGIND_SKIP_INHIBITORS\fR
193 flag of the D\-Bus interface)\&. The interface can be queried with
194 \fBvarlinkctl introspect /run/systemd/io\&.systemd\&.Login io\&.systemd\&.Shutdown\fR\&.
195 .PP
196 For more information see
197 \m[blue]\fBInhibitor Locks\fR\m[]\&\s-2\u[2]\d\s+2\&.
198 .PP
199 If you are interested in writing a display manager that makes use of logind, please have look at
200 \m[blue]\fBWriting Display Managers\fR\m[]\&\s-2\u[3]\d\s+2\&. If you are interested in writing a desktop environment that makes use of logind, please have look at
201 \m[blue]\fBWriting Desktop Environments\fR\m[]\&\s-2\u[4]\d\s+2\&.
202 .SH "SIGNAL"
203 .PP
204 \fBSIGHUP\fR
205 .RS 4
206 Reloads the service configuration file\&.
207 .RE
208 .SH "SEE ALSO"
209 .PP
210 \fBsystemd\fR(1), \fBsystemd-user-sessions.service\fR(8), \fBloginctl\fR(1), \fBlogind.conf\fR(5), \fBpam_systemd\fR(8), \fBsd-login\fR(3), \fBorg.freedesktop.login1\fR(5)
211 .SH "NOTES"
212 .IP " 1." 4
213 polkit
214 .RS 4
215 \%https://www.freedesktop.org/wiki/Software/polkit
216 .RE
217 .IP " 2." 4
218 Inhibitor Locks
219 .RS 4
220 \%https://systemd.io/INHIBITOR_LOCKS
221 .RE
222 .IP " 3." 4
223 Writing Display Managers
224 .RS 4
225 \%https://systemd.io/WRITING_DISPLAY_MANAGERS
226 .RE
227 .IP " 4." 4
228 Writing Desktop Environments
229 .RS 4
230 \%https://systemd.io/WRITING_DESKTOP_ENVIRONMENTS
231 .RE