chiark / gitweb /
net-util: add support for Type=ethernet
[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" conditional='ENABLE_LOGIND'>
25
26         <refentryinfo>
27                 <title>systemd-logind.service</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.service</refentrytitle>
42                 <manvolnum>8</manvolnum>
43         </refmeta>
44
45         <refnamediv>
46                 <refname>systemd-logind.service</refname>
47                 <refname>systemd-logind</refname>
48                 <refpurpose>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><command>systemd-logind</command> 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
65                         sessions, their processes and their idle
66                         state</para></listitem>
67
68                         <listitem><para>Providing PolicyKit-based access
69                         for users to operations such as system
70                         shutdown or sleep</para></listitem>
71
72                         <listitem><para>Implementing a shutdown/sleep
73                         inhibition logic for
74                         applications</para></listitem>
75
76                         <listitem><para>Handling of power/sleep
77                         hardware keys</para></listitem>
78
79                         <listitem><para>Multi-seat
80                         management</para></listitem>
81
82                         <listitem><para>Session
83                         switch management</para></listitem>
84
85                         <listitem><para>Device access management for
86                         users</para></listitem>
87
88                         <listitem><para>Automatic spawning of text
89                         logins (gettys) on virtual console activation
90                         and user runtime directory
91                         management</para></listitem>
92                 </itemizedlist>
93
94                 <para>User sessions are registered in logind via the
95                 <citerefentry><refentrytitle>pam_systemd</refentrytitle><manvolnum>8</manvolnum></citerefentry>
96                 PAM module.</para>
97
98                 <para>See
99                 <citerefentry><refentrytitle>logind.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>
100                 for information about the configuration of this
101                 service.</para>
102
103                 <para>See <ulink
104                 url="http://www.freedesktop.org/wiki/Software/systemd/multiseat">Multi-Seat
105                 on Linux</ulink> for an introduction into basic
106                 concepts of logind such as users, sessions and seats.</para>
107
108                 <para>See the <ulink
109                 url="http://www.freedesktop.org/wiki/Software/systemd/logind">
110                 logind D-Bus API Documentation</ulink> for information about
111                 the APIs <filename>systemd-logind</filename>
112                 provides.</para>
113
114                 <para>For more information on the inhibition logic see
115                 the <ulink
116                 url="http://www.freedesktop.org/wiki/Software/systemd/inhibit">Inhibitor
117                 Lock Developer Documentation</ulink>.</para>
118         </refsect1>
119
120         <refsect1>
121                 <title>See Also</title>
122                 <para>
123                         <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
124                         <citerefentry><refentrytitle>systemd-user-sessions.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
125                         <citerefentry><refentrytitle>loginctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
126                         <citerefentry><refentrytitle>logind.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
127                         <citerefentry><refentrytitle>pam_systemd</refentrytitle><manvolnum>8</manvolnum></citerefentry>
128                 </para>
129         </refsect1>
130
131 </refentry>