d35f51ea84
Back in 2012 the project was renamed, see the release notes for v 0.105 [https://cgit.freedesktop.org/polkit/tree/NEWS#n754]. Let's update our documentation and comments to do the same. Referring to PolicyKit is confusing to users because at the time the polkit api changed too, and we support the new version. I updated NEWS too, since all the references to PolicyKit there were added after the rename. "PolicyKit" is unchanged in various URLs and method call names.
107 lines
4.2 KiB
XML
107 lines
4.2 KiB
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">
|
|
|
|
<!--
|
|
SPDX-License-Identifier: LGPL-2.1+
|
|
-->
|
|
|
|
<refentry id="systemd-logind.service" conditional='ENABLE_LOGIND'>
|
|
|
|
<refentryinfo>
|
|
<title>systemd-logind.service</title>
|
|
<productname>systemd</productname>
|
|
</refentryinfo>
|
|
|
|
<refmeta>
|
|
<refentrytitle>systemd-logind.service</refentrytitle>
|
|
<manvolnum>8</manvolnum>
|
|
</refmeta>
|
|
|
|
<refnamediv>
|
|
<refname>systemd-logind.service</refname>
|
|
<refname>systemd-logind</refname>
|
|
<refpurpose>Login manager</refpurpose>
|
|
</refnamediv>
|
|
|
|
<refsynopsisdiv>
|
|
<para><filename>systemd-logind.service</filename></para>
|
|
<para><filename>/usr/lib/systemd/systemd-logind</filename></para>
|
|
</refsynopsisdiv>
|
|
|
|
<refsect1>
|
|
<title>Description</title>
|
|
|
|
<para><command>systemd-logind</command> is a system service that
|
|
manages user logins. It is responsible for:</para>
|
|
|
|
<itemizedlist>
|
|
<listitem><para>Keeping track of users and sessions, their processes and their idle state. This is implemented by
|
|
allocating a systemd slice unit for each user below <filename>user.slice</filename>, and a scope unit below it
|
|
for each concurrent session of a user. Also, a per-user service manager is started as system service instance of
|
|
<filename>user@.service</filename> for each logged in user.</para></listitem>
|
|
|
|
<listitem><para>Generating and managing session IDs. If auditing is available and an audit session ID is already set for
|
|
a session, then this ID is reused as the session ID. Otherwise, an independent session counter is
|
|
used.</para></listitem>
|
|
|
|
<listitem><para>Providing <ulink
|
|
url="http://www.freedesktop.org/wiki/Software/polkit">polkit</ulink>-based
|
|
access for users for operations such as system shutdown or sleep</para>
|
|
</listitem>
|
|
|
|
<listitem><para>Implementing a shutdown/sleep inhibition logic
|
|
for applications</para></listitem>
|
|
|
|
<listitem><para>Handling of power/sleep hardware
|
|
keys</para></listitem>
|
|
|
|
<listitem><para>Multi-seat management</para></listitem>
|
|
|
|
<listitem><para>Session switch management</para></listitem>
|
|
|
|
<listitem><para>Device access management for
|
|
users</para></listitem>
|
|
|
|
<listitem><para>Automatic spawning of text logins (gettys) on
|
|
virtual console activation and user runtime directory
|
|
management</para></listitem>
|
|
</itemizedlist>
|
|
|
|
<para>User sessions are registered with 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
|
|
<citerefentry><refentrytitle>sd-login</refentrytitle><manvolnum>3</manvolnum></citerefentry>
|
|
for information about the basic concepts of logind
|
|
such as users, sessions and seats.</para>
|
|
|
|
<para>See the <ulink
|
|
url="https://www.freedesktop.org/wiki/Software/systemd/logind">
|
|
logind D-Bus API Documentation</ulink> for information about the
|
|
APIs <filename>systemd-logind</filename> provides.</para>
|
|
|
|
<para>For more information on the inhibition logic see the <ulink
|
|
url="https://www.freedesktop.org/wiki/Software/systemd/inhibit">Inhibitor
|
|
Lock Developer Documentation</ulink>.</para>
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>See Also</title>
|
|
<para>
|
|
<citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
|
|
<citerefentry><refentrytitle>systemd-user-sessions.service</refentrytitle><manvolnum>8</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>
|
|
<citerefentry><refentrytitle>sd-login</refentrytitle><manvolnum>3</manvolnum></citerefentry>
|
|
</para>
|
|
</refsect1>
|
|
|
|
</refentry>
|