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><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
 110                 <para>See the <ulink
 111                 url="http://www.freedesktop.org/wiki/Software/systemd/logind">
 112                 logind D-Bus API Documentation</ulink> for information about
 113                 the APIs <filename>systemd-logind</filename>
 114                 provides.</para>
 115
 116                 <para>For more information on the inhibition logic see
 117                 the <ulink
 118                 url="http://www.freedesktop.org/wiki/Software/systemd/inhibit">Inhibitor
 119                 Lock Developer Documentation</ulink>.</para>
 120         </refsect1>
 121
 122         <refsect1>
 123                 <title>See Also</title>
 124                 <para>
 125                         <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
 126                         <citerefentry><refentrytitle>systemd-user-sessions.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
 127                         <citerefentry><refentrytitle>loginctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
 128                         <citerefentry><refentrytitle>logind.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
 129                         <citerefentry><refentrytitle>pam_systemd</refentrytitle><manvolnum>8</manvolnum></citerefentry>
 130                 </para>
 131         </refsect1>
 132
 133 </refentry>