chiark / gitweb /
9cef4ad6c0957ba84df63ba6fc118f76394c3b0a
[elogind.git] / man / systemd-logind.service.xml
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">
4
5 <!--
6   This file is part of systemd.
7
8   Copyright 2010 Lennart Poettering
9
10   systemd is free software; you can redistribute it and/or modify it
11   under the terms of the GNU Lesser General Public License as published by
12   the Free Software Foundation; either version 2.1 of the License, or
13   (at your option) any later version.
14
15   systemd is distributed in the hope that it will be useful, but
16   WITHOUT ANY WARRANTY; without even the implied warranty of
17   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
18   Lesser General Public License for more details.
19
20   You should have received a copy of the GNU Lesser General Public License
21   along with systemd; If not, see <http://www.gnu.org/licenses/>.
22 -->
23
24 <refentry id="systemd-logind.service">
25
26         <refentryinfo>
27                 <title>systemd-logind</title>
28                 <productname>systemd</productname>
29
30                 <authorgroup>
31                         <author>
32                                 <contrib>Developer</contrib>
33                                 <firstname>Lennart</firstname>
34                                 <surname>Poettering</surname>
35                                 <email>lennart@poettering.net</email>
36                         </author>
37                 </authorgroup>
38         </refentryinfo>
39
40         <refmeta>
41                 <refentrytitle>systemd-logind</refentrytitle>
42                 <manvolnum>8</manvolnum>
43         </refmeta>
44
45         <refnamediv>
46                 <refname>systemd-logind.service</refname>
47                 <refname>systemd-logind</refname>
48                 <refpurpose>systemd Login Manager</refpurpose>
49         </refnamediv>
50
51         <refsynopsisdiv>
52                 <para><filename>systemd-logind.service</filename></para>
53                 <para><filename>/usr/lib/systemd/systemd-logind</filename></para>
54         </refsynopsisdiv>
55
56         <refsect1>
57                 <title>Description</title>
58
59                 <para><filename>systemd-logind</filename> is a system
60                 service that manages user logins. It is responsible
61                 for:</para>
62
63                 <itemizedlist>
64                         <listitem><para>Keeping track of users and sessions, their
65                         processes and their idle state</para></listitem>
66
67                         <listitem><para>Creating control groups for
68                         user processes</para></listitem>
69
70                         <listitem><para>Providing PolicyKit-based access
71                         for users to operations such as system
72                         shutdown or sleep</para></listitem>
73
74                         <listitem><para>Implementing a shutdown/sleep
75                         inhibition logic for
76                         applications</para></listitem>
77
78                         <listitem><para>Handling of power/sleep
79                         hardware keys</para></listitem>
80
81                         <listitem><para>Multi-seat
82                         management</para></listitem>
83
84                         <listitem><para>Session
85                         switch management</para></listitem>
86
87                         <listitem><para>Device access management for
88                         users</para></listitem>
89
90                         <listitem><para>Automatic spawning of text
91                         logins (gettys) on virtual console activation
92                         and user runtime directory
93                         management</para></listitem>
94                 </itemizedlist>
95
96                 <para>User sessions are registered in logind via the
97                 <citerefentry><refentrytitle>pam_systemd</refentrytitle><manvolnum>8</manvolnum></citerefentry>
98                 PAM module.</para>
99
100                 <para>See
101                 <citerefentry><refentrytitle>logind.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>
102                 for information about the configuration of this
103                 service.</para>
104
105                 <para>See <ulink
106                 url="http://www.freedesktop.org/wiki/Software/systemd/multiseat">Multi-Seat
107                 on Linux</ulink> for an introduction into basic
108                 concepts of logind such as users, sessions and seats.</para>
109         </refsect1>
110
111         <refsect1>
112                 <title>See Also</title>
113                 <para>
114                         <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
115                         <citerefentry><refentrytitle>systemd-user-sessions.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
116                         <citerefentry><refentrytitle>loginctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
117                         <citerefentry><refentrytitle>logind.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
118                         <citerefentry><refentrytitle>pam_systemd</refentrytitle><manvolnum>8</manvolnum></citerefentry>
119                 </para>
120         </refsect1>
121
122 </refentry>