]>
Commit | Line | Data |
---|---|---|
663996b3 MS |
1 | <?xml version='1.0'?> <!--*-nxml-*--> |
2 | <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" | |
e735f4d4 | 3 | "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"> |
663996b3 MS |
4 | |
5 | <!-- | |
52ad194e | 6 | SPDX-License-Identifier: LGPL-2.1+ |
663996b3 MS |
7 | --> |
8 | ||
9 | <refentry id="systemd-logind.service" conditional='ENABLE_LOGIND'> | |
10 | ||
e735f4d4 MP |
11 | <refentryinfo> |
12 | <title>systemd-logind.service</title> | |
13 | <productname>systemd</productname> | |
e735f4d4 MP |
14 | </refentryinfo> |
15 | ||
16 | <refmeta> | |
17 | <refentrytitle>systemd-logind.service</refentrytitle> | |
18 | <manvolnum>8</manvolnum> | |
19 | </refmeta> | |
20 | ||
21 | <refnamediv> | |
22 | <refname>systemd-logind.service</refname> | |
23 | <refname>systemd-logind</refname> | |
24 | <refpurpose>Login manager</refpurpose> | |
25 | </refnamediv> | |
26 | ||
27 | <refsynopsisdiv> | |
28 | <para><filename>systemd-logind.service</filename></para> | |
29 | <para><filename>/usr/lib/systemd/systemd-logind</filename></para> | |
30 | </refsynopsisdiv> | |
31 | ||
32 | <refsect1> | |
33 | <title>Description</title> | |
34 | ||
35 | <para><command>systemd-logind</command> is a system service that | |
36 | manages user logins. It is responsible for:</para> | |
37 | ||
38 | <itemizedlist> | |
2897b343 MP |
39 | <listitem><para>Keeping track of users and sessions, their processes and their idle state. This is implemented by |
40 | allocating a systemd slice unit for each user below <filename>user.slice</filename>, and a scope unit below it | |
41 | for each concurrent session of a user. Also, a per-user service manager is started as system service instance of | |
f5e65279 | 42 | <filename>user@.service</filename> for each logged in user.</para></listitem> |
2897b343 | 43 | |
f5e65279 MB |
44 | <listitem><para>Generating and managing session IDs. If auditing is available and an audit session ID is already set for |
45 | a session, then this ID is reused as the session ID. Otherwise, an independent session counter is | |
2897b343 | 46 | used.</para></listitem> |
e735f4d4 | 47 | |
6e866b33 MB |
48 | <listitem><para>Providing <ulink |
49 | url="http://www.freedesktop.org/wiki/Software/polkit">polkit</ulink>-based | |
50 | access for users for operations such as system shutdown or sleep</para> | |
51 | </listitem> | |
e735f4d4 MP |
52 | |
53 | <listitem><para>Implementing a shutdown/sleep inhibition logic | |
54 | for applications</para></listitem> | |
55 | ||
56 | <listitem><para>Handling of power/sleep hardware | |
57 | keys</para></listitem> | |
58 | ||
59 | <listitem><para>Multi-seat management</para></listitem> | |
60 | ||
61 | <listitem><para>Session switch management</para></listitem> | |
62 | ||
63 | <listitem><para>Device access management for | |
64 | users</para></listitem> | |
65 | ||
66 | <listitem><para>Automatic spawning of text logins (gettys) on | |
67 | virtual console activation and user runtime directory | |
68 | management</para></listitem> | |
69 | </itemizedlist> | |
70 | ||
8a584da2 | 71 | <para>User sessions are registered with logind via the |
e735f4d4 MP |
72 | <citerefentry><refentrytitle>pam_systemd</refentrytitle><manvolnum>8</manvolnum></citerefentry> |
73 | PAM module.</para> | |
74 | ||
75 | <para>See | |
76 | <citerefentry><refentrytitle>logind.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry> | |
77 | for information about the configuration of this service.</para> | |
78 | ||
1d42b86d MB |
79 | <para>See |
80 | <citerefentry><refentrytitle>sd-login</refentrytitle><manvolnum>3</manvolnum></citerefentry> | |
81 | for information about the basic concepts of logind | |
e735f4d4 MP |
82 | such as users, sessions and seats.</para> |
83 | ||
84 | <para>See the <ulink | |
2897b343 | 85 | url="https://www.freedesktop.org/wiki/Software/systemd/logind"> |
e735f4d4 MP |
86 | logind D-Bus API Documentation</ulink> for information about the |
87 | APIs <filename>systemd-logind</filename> provides.</para> | |
88 | ||
89 | <para>For more information on the inhibition logic see the <ulink | |
2897b343 | 90 | url="https://www.freedesktop.org/wiki/Software/systemd/inhibit">Inhibitor |
e735f4d4 MP |
91 | Lock Developer Documentation</ulink>.</para> |
92 | </refsect1> | |
93 | ||
94 | <refsect1> | |
95 | <title>See Also</title> | |
96 | <para> | |
97 | <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>, | |
98 | <citerefentry><refentrytitle>systemd-user-sessions.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>, | |
99 | <citerefentry><refentrytitle>loginctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>, | |
100 | <citerefentry><refentrytitle>logind.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>, | |
101 | <citerefentry><refentrytitle>pam_systemd</refentrytitle><manvolnum>8</manvolnum></citerefentry> | |
1d42b86d | 102 | <citerefentry><refentrytitle>sd-login</refentrytitle><manvolnum>3</manvolnum></citerefentry> |
e735f4d4 MP |
103 | </para> |
104 | </refsect1> | |
663996b3 MS |
105 | |
106 | </refentry> |