1 <?xml version='
1.0'
?> <!--*-nxml-*-->
2 <!DOCTYPE refentry PUBLIC
"-//OASIS//DTD DocBook XML V4.2//EN"
3 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
6 SPDX-License-Identifier: LGPL-2.1+
9 <refentry id=
"systemd-logind.service" conditional='ENABLE_LOGIND'
>
12 <title>systemd-logind.service
</title>
13 <productname>systemd
</productname>
17 <refentrytitle>systemd-logind.service
</refentrytitle>
18 <manvolnum>8</manvolnum>
22 <refname>systemd-logind.service
</refname>
23 <refname>systemd-logind
</refname>
24 <refpurpose>Login manager
</refpurpose>
28 <para><filename>systemd-logind.service
</filename></para>
29 <para><filename>/usr/lib/systemd/systemd-logind
</filename></para>
33 <title>Description
</title>
35 <para><command>systemd-logind
</command> is a system service that
36 manages user logins. It is responsible for:
</para>
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
42 <filename>user@.service
</filename> for each logged in user.
</para></listitem>
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
46 used.
</para></listitem>
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>
53 <listitem><para>Implementing a shutdown/sleep inhibition logic
54 for applications
</para></listitem>
56 <listitem><para>Handling of power/sleep hardware
57 keys
</para></listitem>
59 <listitem><para>Multi-seat management
</para></listitem>
61 <listitem><para>Session switch management
</para></listitem>
63 <listitem><para>Device access management for
64 users
</para></listitem>
66 <listitem><para>Automatic spawning of text logins (gettys) on
67 virtual console activation and user runtime directory
68 management
</para></listitem>
71 <para>User sessions are registered with logind via the
72 <citerefentry><refentrytitle>pam_systemd
</refentrytitle><manvolnum>8</manvolnum></citerefentry>
76 <citerefentry><refentrytitle>logind.conf
</refentrytitle><manvolnum>5</manvolnum></citerefentry>
77 for information about the configuration of this service.
</para>
80 <citerefentry><refentrytitle>sd-login
</refentrytitle><manvolnum>3</manvolnum></citerefentry>
81 for information about the basic concepts of logind
82 such as users, sessions and seats.
</para>
85 url=
"https://www.freedesktop.org/wiki/Software/systemd/logind">
86 logind D-Bus API Documentation
</ulink> for information about the
87 APIs
<filename>systemd-logind
</filename> provides.
</para>
89 <para>For more information on the inhibition logic see the
<ulink
90 url=
"https://www.freedesktop.org/wiki/Software/systemd/inhibit">Inhibitor
91 Lock Developer Documentation
</ulink>.
</para>
95 <title>See Also
</title>
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>
102 <citerefentry><refentrytitle>sd-login
</refentrytitle><manvolnum>3</manvolnum></citerefentry>