[thirdparty/systemd.git] / man / systemd-logind.service.xml

<?xml version='1.0'?> <!--*-nxml-*-->
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
        "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">

<!--
  This file is part of systemd.

  Copyright 2010 Lennart Poettering

  systemd is free software; you can redistribute it and/or modify it
  under the terms of the GNU Lesser General Public License as published by
  the Free Software Foundation; either version 2.1 of the License, or
  (at your option) any later version.

  systemd is distributed in the hope that it will be useful, but
  WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  Lesser General Public License for more details.

  You should have received a copy of the GNU Lesser General Public License
  along with systemd; If not, see <http://www.gnu.org/licenses/>.
-->

<refentry id="systemd-logind.service">

        <refentryinfo>
                <title>systemd-logind</title>
                <productname>systemd</productname>

                <authorgroup>
                        <author>
                                <contrib>Developer</contrib>
                                <firstname>Lennart</firstname>
                                <surname>Poettering</surname>
                                <email>lennart@poettering.net</email>
                        </author>
                </authorgroup>
        </refentryinfo>

        <refmeta>
                <refentrytitle>systemd-logind</refentrytitle>
                <manvolnum>8</manvolnum>
        </refmeta>

        <refnamediv>
                <refname>systemd-logind.service</refname>
                <refname>systemd-logind</refname>
                <refpurpose>systemd Login Manager</refpurpose>
        </refnamediv>

        <refsynopsisdiv>
                <para><filename>sysytemd-logind.service</filename></para>
                <para><filename>/usr/lib/systemd/systemd-logind</filename></para>
        </refsynopsisdiv>

        <refsect1>
                <title>Description</title>

                <para><filename>systemd-logind</filename> is a system
                service that manages user logins. It is responsible
                for: keeping track of users and sessions, their
                processes and their idle state; creating control
                groups for user processes; provide PolicyKit-based
                access for users to operations such as system shutdown
                or sleep; implementing a shutdown/sleep inhibition
                logic for applications; handling of power/sleep
                hardware keys; multi-seat management; session switch
                management; device access management for users;
                automatic spawning of text logins (gettys) and user
                runtime directory management.
                </para>

                <para>User sessions are registered in logind via the
                <citerefentry><refentrytitle>pam_systemd</refentrytitle><manvolnum>8</manvolnum></citerefentry>
                PAM module.</para>

                <para>See
                <citerefentry><refentrytitle>logind.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>
                for information about the configuration of this
                service.</para>

                <para>See <ulink
                url="http://www.freedesktop.org/wiki/Software/systemd/multiseat">Multi-Seat
                on Linux</ulink> for an introduction into basic
                concepts of logind such as users, sessions and seats.</para>
        </refsect1>

        <refsect1>
                <title>See Also</title>
                <para>
                        <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
                        <citerefentry><refentrytitle>loginctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
                        <citerefentry><refentrytitle>logind.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
                        <citerefentry><refentrytitle>pam_systemd</refentrytitle><manvolnum>8</manvolnum></citerefentry>
                </para>
        </refsect1>

</refentry>
Commit	Line	Data
af3bccd6 LP	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>sysytemd-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: keeping track of users and sessions, their
	62	processes and their idle state; creating control
	63	groups for user processes; provide PolicyKit-based
	64	access for users to operations such as system shutdown
65	or sleep; implementing a shutdown/sleep inhibition
66	logic for applications; handling of power/sleep
67	hardware keys; multi-seat management; session switch
68	management; device access management for users;
69	automatic spawning of text logins (gettys) and user
70	runtime directory management.
71	</para>
72
73	<para>User sessions are registered in logind via the
74	<citerefentry><refentrytitle>pam_systemd</refentrytitle><manvolnum>8</manvolnum></citerefentry>
75	PAM module.</para>
76
77	<para>See
78	<citerefentry><refentrytitle>logind.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>
79	for information about the configuration of this
80	service.</para>
81
82	<para>See <ulink
83	url="http://www.freedesktop.org/wiki/Software/systemd/multiseat">Multi-Seat
84	on Linux</ulink> for an introduction into basic
85	concepts of logind such as users, sessions and seats.</para>
86	</refsect1>
87
88	<refsect1>
89	<title>See Also</title>
90	<para>
91	<citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
92	<citerefentry><refentrytitle>loginctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
93	<citerefentry><refentrytitle>logind.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
94	<citerefentry><refentrytitle>pam_systemd</refentrytitle><manvolnum>8</manvolnum></citerefentry>
95	</para>
96	</refsect1>
97
98	</refentry>