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>