Lennart Poettering
607d297487
Let's systematically make sure that we link up the D-Bus interfaces from
the daemon man pages once in prose and once in short form at the bottom
("See Also"), for all daemons.
Also, add reverse links at the bottom of the D-Bus API docs.
Fixes: #34996
112 lines
5.0 KiB
XML
112 lines
5.0 KiB
XML
<?xml version='1.0'?> <!--*-nxml-*-->
|
|
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
|
|
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
|
|
<!-- SPDX-License-Identifier: LGPL-2.1-or-later -->
|
|
|
|
<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="https://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>
|
|
|
|
<listitem><para>Scheduled shutdown</para></listitem>
|
|
|
|
<listitem><para>Sending "wall" messages</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
|
|
<citerefentry><refentrytitle>org.freedesktop.login1</refentrytitle><manvolnum>5</manvolnum></citerefentry>
|
|
and
|
|
<citerefentry><refentrytitle>org.freedesktop.LogControl1</refentrytitle><manvolnum>5</manvolnum></citerefentry>
|
|
for information about the D-Bus APIs <filename>systemd-logind</filename> provides.</para>
|
|
|
|
<para>For more information see
|
|
<ulink url="https://systemd.io/INHIBITOR_LOCKS">Inhibitor Locks</ulink>.</para>
|
|
|
|
<para>If you are interested in writing a display manager that makes use of logind, please have look at
|
|
<ulink url="https://systemd.io/WRITING_DISPLAY_MANAGERS">Writing Display
|
|
Managers</ulink>.
|
|
If you are interested in writing a desktop environment that makes use of logind, please have look at
|
|
<ulink url="https://systemd.io/WRITING_DESKTOP_ENVIRONMENTS">Writing
|
|
Desktop Environments</ulink>.</para>
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>See Also</title>
|
|
<para><simplelist type="inline">
|
|
<member><citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry></member>
|
|
<member><citerefentry><refentrytitle>systemd-user-sessions.service</refentrytitle><manvolnum>8</manvolnum></citerefentry></member>
|
|
<member><citerefentry><refentrytitle>loginctl</refentrytitle><manvolnum>1</manvolnum></citerefentry></member>
|
|
<member><citerefentry><refentrytitle>logind.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry></member>
|
|
<member><citerefentry><refentrytitle>pam_systemd</refentrytitle><manvolnum>8</manvolnum></citerefentry></member>
|
|
<member><citerefentry><refentrytitle>sd-login</refentrytitle><manvolnum>3</manvolnum></citerefentry></member>
|
|
<member><citerefentry><refentrytitle>org.freedesktop.login1</refentrytitle><manvolnum>5</manvolnum></citerefentry></member>
|
|
</simplelist></para>
|
|
</refsect1>
|
|
|
|
</refentry>
|