loginctl.xml revision f366d58dc1fe51b300167446597750d29687c3c5
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
12b42c76672a66c2d4ea7212c14f8f1b5a62b78dTom Gundersen "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
b975b0d514321f169b3c4599a8ea92e13741b4e4Zbigniew Jędrzejewski-Szmek This file is part of systemd.
b975b0d514321f169b3c4599a8ea92e13741b4e4Zbigniew Jędrzejewski-Szmek Copyright 2010 Lennart Poettering
b975b0d514321f169b3c4599a8ea92e13741b4e4Zbigniew Jędrzejewski-Szmek systemd is free software; you can redistribute it and/or modify it
b975b0d514321f169b3c4599a8ea92e13741b4e4Zbigniew Jędrzejewski-Szmek under the terms of the GNU Lesser General Public License as published by
b975b0d514321f169b3c4599a8ea92e13741b4e4Zbigniew Jędrzejewski-Szmek the Free Software Foundation; either version 2.1 of the License, or
b975b0d514321f169b3c4599a8ea92e13741b4e4Zbigniew Jędrzejewski-Szmek (at your option) any later version.
b975b0d514321f169b3c4599a8ea92e13741b4e4Zbigniew Jędrzejewski-Szmek systemd is distributed in the hope that it will be useful, but
b975b0d514321f169b3c4599a8ea92e13741b4e4Zbigniew Jędrzejewski-Szmek WITHOUT ANY WARRANTY; without even the implied warranty of
b975b0d514321f169b3c4599a8ea92e13741b4e4Zbigniew Jędrzejewski-Szmek MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
b975b0d514321f169b3c4599a8ea92e13741b4e4Zbigniew Jędrzejewski-Szmek Lesser General Public License for more details.
b975b0d514321f169b3c4599a8ea92e13741b4e4Zbigniew Jędrzejewski-Szmek You should have received a copy of the GNU Lesser General Public License
b975b0d514321f169b3c4599a8ea92e13741b4e4Zbigniew Jędrzejewski-Szmek along with systemd; If not, see <http://www.gnu.org/licenses/>.
48f69d8fb4d0cf34d578352572c96d86e13caa79Lennart Poettering<refentry id="loginctl" conditional='ENABLE_LOGIND'>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <refentryinfo>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering </authorgroup>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering </refentryinfo>
dfb815c36df6e5f2089672b1d986d38b44c7ad17David Herrmann <refpurpose>Control the systemd login manager</refpurpose>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <refsynopsisdiv>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <arg choice="opt" rep="repeat">OPTIONS</arg>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <arg choice="opt" rep="repeat">NAME</arg>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering </cmdsynopsis>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering </refsynopsisdiv>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <para><command>loginctl</command> may be used to
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering introspect and control the state of the
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>
dfb815c36df6e5f2089672b1d986d38b44c7ad17David Herrmann login manager <citerefentry><refentrytitle>systemd-logind.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
dfb815c36df6e5f2089672b1d986d38b44c7ad17David Herrmann <para>The following options are understood:</para>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <variablelist>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <varlistentry>
dfb815c36df6e5f2089672b1d986d38b44c7ad17David Herrmann </varlistentry>
dfb815c36df6e5f2089672b1d986d38b44c7ad17David Herrmann <varlistentry>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering </varlistentry>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <varlistentry>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <listitem><para>Do not pipe output into a
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering </varlistentry>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <varlistentry>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <term><option>--no-legend</option></term>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <para>Do not print the legend,
b8bde11658366290521e3d03316378b482600323Jan Engelhardt i.e. the column headers and
b8bde11658366290521e3d03316378b482600323Jan Engelhardt the footer.</para>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering </varlistentry>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <varlistentry>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <term><option>--no-ask-password</option></term>
b8bde11658366290521e3d03316378b482600323Jan Engelhardt for authentication for privileged
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering </varlistentry>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <varlistentry>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering remotely. Specify a hostname, or
b8bde11658366290521e3d03316378b482600323Jan Engelhardt username and hostname separated by <literal>@</literal>,
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering to connect to. This will use SSH to
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering talk to the remote login manager
dca348bcbb462305864526c587495a14a76bfcdeJan Engelhardt </varlistentry>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <varlistentry>
b938cb902c3b5bca807a94b277672c64d6767886Jan Engelhardt local container. Specify a container
dfb815c36df6e5f2089672b1d986d38b44c7ad17David Herrmann </varlistentry>
dfb815c36df6e5f2089672b1d986d38b44c7ad17David Herrmann <varlistentry>
b938cb902c3b5bca807a94b277672c64d6767886Jan Engelhardt display to certain properties as
b938cb902c3b5bca807a94b277672c64d6767886Jan Engelhardt specified as argument. If not
dfb815c36df6e5f2089672b1d986d38b44c7ad17David Herrmann specified, all set properties are
b938cb902c3b5bca807a94b277672c64d6767886Jan Engelhardt shown. The argument should be a
dfb815c36df6e5f2089672b1d986d38b44c7ad17David Herrmann property name, such as
dfb815c36df6e5f2089672b1d986d38b44c7ad17David Herrmann specified more than once, all
dfb815c36df6e5f2089672b1d986d38b44c7ad17David Herrmann properties with the specified names
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering </varlistentry>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <varlistentry>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering properties regardless of whether they are
b8bde11658366290521e3d03316378b482600323Jan Engelhardt </varlistentry>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <varlistentry>
5aded369782f28255bc6b494ca905d7acaea7a56Zbigniew Jędrzejewski-Szmek <term><option>--full</option></term>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering process tree entries.</para>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering </varlistentry>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <varlistentry>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <term><option>--kill-who=</option></term>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering choose which processes to kill. Must
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering to kill only the leader process of the
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering session or all processes of the
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering session. If omitted, defaults to
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering </varlistentry>
a6278b88305b237b02eabff0d870b57fe851822dLennart Poettering <varlistentry>
<term><command>attach</command> <replaceable>NAME</replaceable> <replaceable>DEVICE</replaceable>...</term>
<citerefentry><refentrytitle>systemd-logind.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,