f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen<?xml version='1.0'?> <!--*-nxml-*-->

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen<refentry id="loginctl">

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen <refentryinfo>

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen <title>loginctl</title>

1346b1f0388f4100bb3c2a2bb23bc881769c020cTom Gundersen <productname>systemd</productname>

f5be560181d092c5f52a2b819aedcd48220f36abTom Gundersen

dd43110f781a9245ec00531456fee68ed763a179Tom Gundersen <authorgroup>

5c1d3fc93d91384bbac29adf01074fa4375317eaUmut Tezduyar Lindskog <author>

4138fb2c7936758da709eaed3f6b4f3df1d04effPatrik Flykt <contrib>Developer</contrib>

4138fb2c7936758da709eaed3f6b4f3df1d04effPatrik Flykt <firstname>Lennart</firstname>

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen <surname>Poettering</surname>

ce43e484465050c619ea9a1991d49b3d6215028bSusant Sahani <email>lennart@poettering.net</email>

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen </author>

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen </authorgroup>

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen </refentryinfo>

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen

06f021a8048583d66202e3ac5cd0a12386d33ac2Tom Gundersen <refmeta>

134e56dcc53970a20a858283650bb92cd5da1d17Lennart Poettering <refentrytitle>loginctl</refentrytitle>

3b653205cf7bd3851befd0a9f6a3ded6e267c173Lennart Poettering <manvolnum>1</manvolnum>

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen </refmeta>

aba496a58acf9d9c61314de71353550e579f85eeUmut Tezduyar Lindskog

4faefc7ff884eae65a80e82313fd9f4bb859d6dbLennart Poettering <refnamediv>

4faefc7ff884eae65a80e82313fd9f4bb859d6dbLennart Poettering <refname>loginctl</refname>

aba496a58acf9d9c61314de71353550e579f85eeUmut Tezduyar Lindskog <refpurpose>Control the systemd login manager</refpurpose>

1a436809498faf6486815baa0338fb6b8e5def07Tom Gundersen </refnamediv>

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen <refsynopsisdiv>

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen <cmdsynopsis>

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen <command>loginctl <arg choice="opt" rep="repeat">OPTIONS</arg> <arg choice="req">COMMAND</arg> <arg choice="opt" rep="repeat">NAME</arg></command>

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen </cmdsynopsis>

11bf3cced13c885ca215c108cb0bdb7a148520d6Lennart Poettering </refsynopsisdiv>

b98b483bac585af754e8a22ea890db8486905d8aAlin Rauta

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen <refsect1>

cb9fc36a1211967e8c58b0502a26c42552ac8060Lennart Poettering <title>Description</title>

769d324c99aab129148bd25f5f663ef441287d86Lennart Poettering

769d324c99aab129148bd25f5f663ef441287d86Lennart Poettering <para><command>loginctl</command> may be used to

769d324c99aab129148bd25f5f663ef441287d86Lennart Poettering introspect and control the state of the

769d324c99aab129148bd25f5f663ef441287d86Lennart Poettering <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>

769d324c99aab129148bd25f5f663ef441287d86Lennart Poettering login manager.</para>

cb9fc36a1211967e8c58b0502a26c42552ac8060Lennart Poettering </refsect1>

cb9fc36a1211967e8c58b0502a26c42552ac8060Lennart Poettering

cb9fc36a1211967e8c58b0502a26c42552ac8060Lennart Poettering <refsect1>

ed942a9eb22d50f667909ad6184b45015d28d054Tom Gundersen <title>Options</title>

bd8f65387673e29f46136a4ed172097035002c23Tom Gundersen

bd8f65387673e29f46136a4ed172097035002c23Tom Gundersen <para>The following options are understood:</para>

bd8f65387673e29f46136a4ed172097035002c23Tom Gundersen

bd8f65387673e29f46136a4ed172097035002c23Tom Gundersen <variablelist>

bd8f65387673e29f46136a4ed172097035002c23Tom Gundersen <varlistentry>

bd8f65387673e29f46136a4ed172097035002c23Tom Gundersen <term><option>--help</option></term>

bd8f65387673e29f46136a4ed172097035002c23Tom Gundersen <term><option>-h</option></term>

bd8f65387673e29f46136a4ed172097035002c23Tom Gundersen

b98b483bac585af754e8a22ea890db8486905d8aAlin Rauta <listitem><para>Prints a short help

b98b483bac585af754e8a22ea890db8486905d8aAlin Rauta text and exits.</para></listitem>

b98b483bac585af754e8a22ea890db8486905d8aAlin Rauta </varlistentry>

b98b483bac585af754e8a22ea890db8486905d8aAlin Rauta

b98b483bac585af754e8a22ea890db8486905d8aAlin Rauta <varlistentry>

b98b483bac585af754e8a22ea890db8486905d8aAlin Rauta <term><option>--version</option></term>

b98b483bac585af754e8a22ea890db8486905d8aAlin Rauta

b98b483bac585af754e8a22ea890db8486905d8aAlin Rauta <listitem><para>Prints a short version

b98b483bac585af754e8a22ea890db8486905d8aAlin Rauta string and exits.</para></listitem>

b98b483bac585af754e8a22ea890db8486905d8aAlin Rauta </varlistentry>

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen <varlistentry>

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen <term><option>--property=</option></term>

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen <term><option>-p</option></term>

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen <listitem><para>When showing

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen session/user/ properties, limit

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen display to certain properties as

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen specified as argument. If not

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen specified all set properties are

edb85f0d8d0a84f27308a3728f3fde3c52b9dce2Susant Sahani shown. The argument should be a

edb85f0d8d0a84f27308a3728f3fde3c52b9dce2Susant Sahani property name, such as

2cc412b59353576cece2d5b30c6a39c70552f0a0Tom Gundersen <literal>Sessions</literal>. If

2cc412b59353576cece2d5b30c6a39c70552f0a0Tom Gundersen specified more than once all

2cc412b59353576cece2d5b30c6a39c70552f0a0Tom Gundersen properties with the specified names

edbb03e95a3c31bf719d5c6c46eec14d0bcb9c8fTom Gundersen are shown.</para></listitem>

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen </varlistentry>

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen

1a436809498faf6486815baa0338fb6b8e5def07Tom Gundersen <varlistentry>

1a436809498faf6486815baa0338fb6b8e5def07Tom Gundersen <term><option>--all</option></term>

6a0a2f860f1ca4a10932da3b41dbc3c0139757ccTom Gundersen <term><option>-a</option></term>

cb9fc36a1211967e8c58b0502a26c42552ac8060Lennart Poettering

5be4d38e31281727b6f45ae869136bb01a1f7790Tom Gundersen <listitem><para>When showing

bcb7a07e0a785bda1eed658e984ff6b4a11cba9aTom Gundersen unit/job/manager properties, show all

4f882b2a5007e51032459e29d15a86df6b5ea9f4Tom Gundersen properties regardless whether they are

1346b1f0388f4100bb3c2a2bb23bc881769c020cTom Gundersen set or not.</para></listitem>

ad0734e890b25751ef8229e47210ff11ae8fa3f3Tom Gundersen </varlistentry>

4cc7a82c9490a3c5ae03b1d6d168ce40ba499e23Eugene Yakubovich

f5de5b00204f041aaec828d336c8afd9e860a5c3Tom Gundersen

eb27aeca247a4cf8816fffc4c0dbcab55ead3864Tom Gundersen <varlistentry>

e1ea665edac17d75fce01b72dadfa3211b60df2cEugene Yakubovich <term><option>--no-pager</option></term>

84b5b79a8f7b423c5b7cad4170eb68d57fe5e26cAngus Gibson

5c1d3fc93d91384bbac29adf01074fa4375317eaUmut Tezduyar Lindskog <listitem><para>Do not pipe output into a

bfa695b5cc37aeb78737c57c84e9e69ea08152c0Tom Gundersen pager.</para></listitem>

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen </varlistentry>

dd43110f781a9245ec00531456fee68ed763a179Tom Gundersen

dd43110f781a9245ec00531456fee68ed763a179Tom Gundersen <varlistentry>

e1853b00ef7cb56cafd908327dd44b3ab48b402cSusant Sahani <term><option>--no-ask-password</option></term>

e1853b00ef7cb56cafd908327dd44b3ab48b402cSusant Sahani

769d324c99aab129148bd25f5f663ef441287d86Lennart Poettering <listitem><para>Don't query the user

5a8bcb674f71a20e95df55319b34c556638378ceLennart Poettering for authentication for privileged

5a8bcb674f71a20e95df55319b34c556638378ceLennart Poettering operations.</para></listitem>

c106cc36b9b8e8998eb95299b02f1db9c1209122Tom Gundersen </varlistentry>

c106cc36b9b8e8998eb95299b02f1db9c1209122Tom Gundersen

c106cc36b9b8e8998eb95299b02f1db9c1209122Tom Gundersen <varlistentry>

ce43e484465050c619ea9a1991d49b3d6215028bSusant Sahani <term><option>--kill-who=</option></term>

ce43e484465050c619ea9a1991d49b3d6215028bSusant Sahani

f048a16b464295a4e0a4f4c1210f06343ad31231Tom Gundersen <listitem><para>When used with

f048a16b464295a4e0a4f4c1210f06343ad31231Tom Gundersen <command>kill-session</command>,

b98b483bac585af754e8a22ea890db8486905d8aAlin Rauta choose which processes to kill. Must

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen be one of <option>leader</option>, or

6ae115c1fe95611b39d2f20cfcea3d385429f59eTom Gundersen <option>all</option> to select whether

6ae115c1fe95611b39d2f20cfcea3d385429f59eTom Gundersen to kill only the leader process of the

b98b483bac585af754e8a22ea890db8486905d8aAlin Rauta session or all processes of the

6ae115c1fe95611b39d2f20cfcea3d385429f59eTom Gundersen session. If omitted defaults to

67272d157a35e5cda4e5c904eafdcc23d20541d1Tom Gundersen <option>all</option>.</para></listitem>

6192b846ca0d15602e94ddb5da4420b7c60d64a5Tom Gundersen </varlistentry>

06f021a8048583d66202e3ac5cd0a12386d33ac2Tom Gundersen

bd8f65387673e29f46136a4ed172097035002c23Tom Gundersen <varlistentry>

bd8f65387673e29f46136a4ed172097035002c23Tom Gundersen <term><option>--signal=</option></term>

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen <term><option>-s</option></term>

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen <listitem><para>When used with

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen <command>kill-session</command> or

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen <command>kill-user</command>, choose

16aa63a00b5b1db23a9c0b8de350ebf482d90cd0Tom Gundersen which signal to send to selected

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen processes. Must be one of the well

0dd25fb9f005d8ab7ac4bc10a609d00569f8c56aLennart Poettering known signal specifiers such as

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen SIGTERM, SIGINT or SIGSTOP. If omitted

5c1d3fc93d91384bbac29adf01074fa4375317eaUmut Tezduyar Lindskog defaults to

81163121e649523b4071f67ddc03c2db649036c5Tom Gundersen <option>SIGTERM</option>.</para></listitem>

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen </varlistentry>

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen

eb0ea358b688a6f83ff305c6b825c61f12b6dcb8Tom Gundersen <varlistentry>

aba496a58acf9d9c61314de71353550e579f85eeUmut Tezduyar Lindskog <term><option>-H</option></term>

8cd11a0f0f4ca05199e1166f6a07472b296f7455Tom Gundersen <term><option>--host</option></term>

5d3de3fe9cc452f1bfe3c2dcafecbd7f904da4dcLennart Poettering

c081882f07617e56bcbce54105068137e4e0bb52Susant Sahani <listitem><para>Execute operation

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen remotely. Specify a hostname, or

fd6d906cf46ecef45ebbb5a361e1dc436f031d7aLennart Poettering username and hostname separated by @,

5a8bcb674f71a20e95df55319b34c556638378ceLennart Poettering to connect to. This will use SSH to

3d3d425547a3f38473fcf8737b85dfebb630479dTom Gundersen talk to the remote login manager

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen instance.</para></listitem>

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen </varlistentry>

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen <varlistentry>

16aa63a00b5b1db23a9c0b8de350ebf482d90cd0Tom Gundersen <term><option>-P</option></term>

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen <term><option>--privileged</option></term>

0dd25fb9f005d8ab7ac4bc10a609d00569f8c56aLennart Poettering

6ae115c1fe95611b39d2f20cfcea3d385429f59eTom Gundersen <listitem><para>Acquire privileges via

9e7e440835c43d81ffdbc299d2c07daaa641ed50Tom Gundersen PolicyKit before executing the

5c1d3fc93d91384bbac29adf01074fa4375317eaUmut Tezduyar Lindskog operation.</para></listitem>

5c1d3fc93d91384bbac29adf01074fa4375317eaUmut Tezduyar Lindskog </varlistentry>

28cc555d8504c9429776aedbbe1fee7101258578Dan Williams </variablelist>

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen

5d3de3fe9cc452f1bfe3c2dcafecbd7f904da4dcLennart Poettering <para>The following commands are understood:</para>

5d3de3fe9cc452f1bfe3c2dcafecbd7f904da4dcLennart Poettering

9e7e440835c43d81ffdbc299d2c07daaa641ed50Tom Gundersen <variablelist>

46b0c76e2c355c0d0cc4792abb98cde07b28bc53Emil Renner Berthing <varlistentry>

6ae115c1fe95611b39d2f20cfcea3d385429f59eTom Gundersen <term><command>list-sessions</command></term>

3d3d425547a3f38473fcf8737b85dfebb630479dTom Gundersen

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen <listitem><para>List current sessions.</para></listitem>

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen </varlistentry>

11bf3cced13c885ca215c108cb0bdb7a148520d6Lennart Poettering

11bf3cced13c885ca215c108cb0bdb7a148520d6Lennart Poettering <varlistentry>

11bf3cced13c885ca215c108cb0bdb7a148520d6Lennart Poettering <term><command>session-status [ID...]</command></term>

0dd25fb9f005d8ab7ac4bc10a609d00569f8c56aLennart Poettering

11bf3cced13c885ca215c108cb0bdb7a148520d6Lennart Poettering <listitem><para>Show terse runtime

11bf3cced13c885ca215c108cb0bdb7a148520d6Lennart Poettering status information about one or more

11bf3cced13c885ca215c108cb0bdb7a148520d6Lennart Poettering sessions. This function is intended to

11bf3cced13c885ca215c108cb0bdb7a148520d6Lennart Poettering generate human-readable output. If you

11bf3cced13c885ca215c108cb0bdb7a148520d6Lennart Poettering are looking for computer-parsable

11bf3cced13c885ca215c108cb0bdb7a148520d6Lennart Poettering output, use

11bf3cced13c885ca215c108cb0bdb7a148520d6Lennart Poettering <command>show-session</command>

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen instead.</para></listitem>

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen </varlistentry>

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen

9c0a72f961e00b0447767973e7117e131bea5b5dTom Gundersen <varlistentry>

1346b1f0388f4100bb3c2a2bb23bc881769c020cTom Gundersen <term><command>show-session [ID...]</command></term>

9c0a72f961e00b0447767973e7117e131bea5b5dTom Gundersen

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen <listitem><para>Show properties of one

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen or more sessions or the manager

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen itself. If no argument is specified

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen properties of the manager will be

6a24f1484fcc1f59f89617afbe4282667a358eabTom Gundersen shown. If a session ID is specified

6a24f1484fcc1f59f89617afbe4282667a358eabTom Gundersen properties of the session is shown. By

bbf7c04821a71fec67eaf0e7a34d17afc5913c13Tom Gundersen default, empty properties are

bbf7c04821a71fec67eaf0e7a34d17afc5913c13Tom Gundersen suppressed. Use <option>--all</option>

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen to show those too. To select specific

52433f6b65eccd1c54606dde999610640f3458acTom Gundersen properties to show use

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen <option>--property=</option>. This

11bf3cced13c885ca215c108cb0bdb7a148520d6Lennart Poettering command is intended to be used

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen whenever computer-parsable output is

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen required. Use

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen <command>session-status</command> if

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen you are looking for formatted

2ad8416dd057e7e3185169609ca3006e7649f576Zbigniew Jędrzejewski-Szmek human-readable

2ad8416dd057e7e3185169609ca3006e7649f576Zbigniew Jędrzejewski-Szmek output.</para></listitem>

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen </varlistentry>

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen <varlistentry>

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen <term><command>activate [ID...]</command></term>

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen

02b59d57e0c08231645120077f651151f5bb2babTom Gundersen <listitem><para>Activate one or more

02b59d57e0c08231645120077f651151f5bb2babTom Gundersen sessions. This brings one or more

02b59d57e0c08231645120077f651151f5bb2babTom Gundersen sessions into the foreground, if

505f8da7325591defe5f751f328bd26915267602Tom Gundersen another session is currently in the

45af44d47da6933b260c734ad9ff721f63f80a4dTom Gundersen foreground on the respective

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen seat.</para></listitem>

bbf7c04821a71fec67eaf0e7a34d17afc5913c13Tom Gundersen </varlistentry>

3bef724f7e7f7eaca69881548b06e221b77d7031Tom Gundersen

0dd25fb9f005d8ab7ac4bc10a609d00569f8c56aLennart Poettering <varlistentry>

11bf3cced13c885ca215c108cb0bdb7a148520d6Lennart Poettering <term><command>lock-session [ID...]</command></term>

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen <term><command>unlock-session [ID...]</command></term>

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen <listitem><para>Activates/deactivates

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen the screen lock on one or more

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen sessions, if the session supports it.</para></listitem>

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen </varlistentry>

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen <varlistentry>

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen <term><command>terminate-session [ID...]</command></term>

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen <listitem><para>Terminates a

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen session. This kills all processes of

505f8da7325591defe5f751f328bd26915267602Tom Gundersen the session and deallocates all

505f8da7325591defe5f751f328bd26915267602Tom Gundersen resources attached to the

505f8da7325591defe5f751f328bd26915267602Tom Gundersen session.</para></listitem>

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen </varlistentry>

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen

69a93e7db47addc4495a6ec9dc0fc74092a6ebeeTom Gundersen <varlistentry>

02b59d57e0c08231645120077f651151f5bb2babTom Gundersen <term><command>kill-session [ID...]</command></term>

02b59d57e0c08231645120077f651151f5bb2babTom Gundersen

02b59d57e0c08231645120077f651151f5bb2babTom Gundersen <listitem><para>Send a signal to one

6192b846ca0d15602e94ddb5da4420b7c60d64a5Tom Gundersen or more processes of the session. Use

6192b846ca0d15602e94ddb5da4420b7c60d64a5Tom Gundersen <option>--kill-who=</option> to select

6192b846ca0d15602e94ddb5da4420b7c60d64a5Tom Gundersen which process to kill. Use

6192b846ca0d15602e94ddb5da4420b7c60d64a5Tom Gundersen <option>--signal=</option> to select

6192b846ca0d15602e94ddb5da4420b7c60d64a5Tom Gundersen the signal to send.</para></listitem>

6192b846ca0d15602e94ddb5da4420b7c60d64a5Tom Gundersen </varlistentry>

6192b846ca0d15602e94ddb5da4420b7c60d64a5Tom Gundersen

6192b846ca0d15602e94ddb5da4420b7c60d64a5Tom Gundersen <varlistentry>

6192b846ca0d15602e94ddb5da4420b7c60d64a5Tom Gundersen <term><command>list-users</command></term>

6192b846ca0d15602e94ddb5da4420b7c60d64a5Tom Gundersen

6192b846ca0d15602e94ddb5da4420b7c60d64a5Tom Gundersen <listitem><para>List currently logged

7951dea20911969287878e6897b3eca348721adeSusant Sahani in users.</para></listitem>

7951dea20911969287878e6897b3eca348721adeSusant Sahani </varlistentry>

7951dea20911969287878e6897b3eca348721adeSusant Sahani

7951dea20911969287878e6897b3eca348721adeSusant Sahani <varlistentry>

7951dea20911969287878e6897b3eca348721adeSusant Sahani <term><command>user-status [USER...]</command></term>

7951dea20911969287878e6897b3eca348721adeSusant Sahani

7951dea20911969287878e6897b3eca348721adeSusant Sahani <listitem><para>Show terse runtime

7951dea20911969287878e6897b3eca348721adeSusant Sahani status information about one or more

7951dea20911969287878e6897b3eca348721adeSusant Sahani logged in users. This function is

7951dea20911969287878e6897b3eca348721adeSusant Sahani intended to generate human-readable

7951dea20911969287878e6897b3eca348721adeSusant Sahani output. If you are looking for

7951dea20911969287878e6897b3eca348721adeSusant Sahani computer-parsable output, use

7951dea20911969287878e6897b3eca348721adeSusant Sahani <command>show-user</command>

7951dea20911969287878e6897b3eca348721adeSusant Sahani instead. Users may be specified by

7951dea20911969287878e6897b3eca348721adeSusant Sahani their usernames or numeric user

7951dea20911969287878e6897b3eca348721adeSusant Sahani IDs.</para></listitem>

7951dea20911969287878e6897b3eca348721adeSusant Sahani </varlistentry>

7951dea20911969287878e6897b3eca348721adeSusant Sahani

7951dea20911969287878e6897b3eca348721adeSusant Sahani <varlistentry>

7951dea20911969287878e6897b3eca348721adeSusant Sahani <term><command>show-user [USER...]</command></term>

7951dea20911969287878e6897b3eca348721adeSusant Sahani

7951dea20911969287878e6897b3eca348721adeSusant Sahani <listitem><para>Show properties of one

85a8eeee36b57c1ab382b0225fa9a87525bbeee9Susant Sahani or more users or the manager

85a8eeee36b57c1ab382b0225fa9a87525bbeee9Susant Sahani itself. If no argument is specified

85a8eeee36b57c1ab382b0225fa9a87525bbeee9Susant Sahani properties of the manager will be

85a8eeee36b57c1ab382b0225fa9a87525bbeee9Susant Sahani shown. If a user is specified

85a8eeee36b57c1ab382b0225fa9a87525bbeee9Susant Sahani properties of the user is shown. By

85a8eeee36b57c1ab382b0225fa9a87525bbeee9Susant Sahani default, empty properties are

85a8eeee36b57c1ab382b0225fa9a87525bbeee9Susant Sahani suppressed. Use <option>--all</option>

85a8eeee36b57c1ab382b0225fa9a87525bbeee9Susant Sahani to show those too. To select specific

85a8eeee36b57c1ab382b0225fa9a87525bbeee9Susant Sahani properties to show use

85a8eeee36b57c1ab382b0225fa9a87525bbeee9Susant Sahani <option>--property=</option>. This

85a8eeee36b57c1ab382b0225fa9a87525bbeee9Susant Sahani command is intended to be used

02b59d57e0c08231645120077f651151f5bb2babTom Gundersen whenever computer-parsable output is

c0dda18697e0994272c0c9616d36f6777b60e2c7Tom Gundersen required. Use

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen <command>user-status</command> if

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen you are looking for formatted

f048a16b464295a4e0a4f4c1210f06343ad31231Tom Gundersen human-readable

28cc555d8504c9429776aedbbe1fee7101258578Dan Williams output.</para></listitem>

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen </varlistentry>

f882c247ad59776c3a7753bb963c1f8e2386cb79Tom Gundersen

5c1d3fc93d91384bbac29adf01074fa4375317eaUmut Tezduyar Lindskog <varlistentry>

5c1d3fc93d91384bbac29adf01074fa4375317eaUmut Tezduyar Lindskog <term><command>enable-linger [USER...]</command></term>

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen <term><command>disable-linger [USER...]</command></term>

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen <listitem><para>Enable/disable user

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen lingering for one or more users. If

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen enabled for a specific user a user

71a6151083d842b2f5bf04e50239f0bf85d34d2eTom Gundersen manager is spawned for him/her at

71a6151083d842b2f5bf04e50239f0bf85d34d2eTom Gundersen boot, and kept around after

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen logouts. This allows users who aren't

6ae115c1fe95611b39d2f20cfcea3d385429f59eTom Gundersen logged in to run long-running

6ae115c1fe95611b39d2f20cfcea3d385429f59eTom Gundersen services.</para></listitem>

6ae115c1fe95611b39d2f20cfcea3d385429f59eTom Gundersen </varlistentry>

6ae115c1fe95611b39d2f20cfcea3d385429f59eTom Gundersen

5d8e593dce074bff966fc0a46579c61b4f3bc33aSusant Sahani <varlistentry>

5d8e593dce074bff966fc0a46579c61b4f3bc33aSusant Sahani <term><command>terminate-user [USER...]</command></term>

5d8e593dce074bff966fc0a46579c61b4f3bc33aSusant Sahani

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen <listitem><para>Terminates all

f048a16b464295a4e0a4f4c1210f06343ad31231Tom Gundersen sessions of a user. This kills all

f048a16b464295a4e0a4f4c1210f06343ad31231Tom Gundersen processes of all sessions of the user

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen and deallocates all runtime resources

f882c247ad59776c3a7753bb963c1f8e2386cb79Tom Gundersen attached to the

aba496a58acf9d9c61314de71353550e579f85eeUmut Tezduyar Lindskog user.</para></listitem>

407fe036a24834203aca6c1eec7d74d9ad3e9ee0Tom Gundersen </varlistentry>

5a8bcb674f71a20e95df55319b34c556638378ceLennart Poettering

5a8bcb674f71a20e95df55319b34c556638378ceLennart Poettering <varlistentry>

9505d3c6deda0452c22ab2ed47bca74b98d87a17Tom Gundersen <term><command>kill-user [USER...]</command></term>

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen <listitem><para>Send a signal to all

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen processes of a user. Use

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen <option>--signal=</option> to select

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen the signal to send.</para></listitem>

71a6151083d842b2f5bf04e50239f0bf85d34d2eTom Gundersen </varlistentry>

71a6151083d842b2f5bf04e50239f0bf85d34d2eTom Gundersen

f579559b3a14c1f1ef96c372e7626c4733e6ef7dTom Gundersen <varlistentry>

eb0ea358b688a6f83ff305c6b825c61f12b6dcb8Tom Gundersen <term><command>list-seats</command></term>

eb0ea358b688a6f83ff305c6b825c61f12b6dcb8Tom Gundersen

eb0ea358b688a6f83ff305c6b825c61f12b6dcb8Tom Gundersen <listitem><para>List currently

eb0ea358b688a6f83ff305c6b825c61f12b6dcb8Tom Gundersen available seats on the local

6ae115c1fe95611b39d2f20cfcea3d385429f59eTom Gundersen system.</para></listitem>

6ae115c1fe95611b39d2f20cfcea3d385429f59eTom Gundersen </varlistentry>

6ae115c1fe95611b39d2f20cfcea3d385429f59eTom Gundersen

6ae115c1fe95611b39d2f20cfcea3d385429f59eTom Gundersen <varlistentry>

b98b483bac585af754e8a22ea890db8486905d8aAlin Rauta <term><command>seat-status [NAME...]</command></term>

b98b483bac585af754e8a22ea890db8486905d8aAlin Rauta

b98b483bac585af754e8a22ea890db8486905d8aAlin Rauta <listitem><para>Show terse runtime

b98b483bac585af754e8a22ea890db8486905d8aAlin Rauta status information about one or more

b98b483bac585af754e8a22ea890db8486905d8aAlin Rauta seats. This function is

b98b483bac585af754e8a22ea890db8486905d8aAlin Rauta intended to generate human-readable

b98b483bac585af754e8a22ea890db8486905d8aAlin Rauta output. If you are looking for

b98b483bac585af754e8a22ea890db8486905d8aAlin Rauta computer-parsable output, use

b98b483bac585af754e8a22ea890db8486905d8aAlin Rauta <command>show-seat</command>

b98b483bac585af754e8a22ea890db8486905d8aAlin Rauta instead.</para></listitem>

b98b483bac585af754e8a22ea890db8486905d8aAlin Rauta </varlistentry>

b98b483bac585af754e8a22ea890db8486905d8aAlin Rauta

b98b483bac585af754e8a22ea890db8486905d8aAlin Rauta <varlistentry>

b98b483bac585af754e8a22ea890db8486905d8aAlin Rauta <term><command>show-seat [NAME...]</command></term>

b98b483bac585af754e8a22ea890db8486905d8aAlin Rauta

b98b483bac585af754e8a22ea890db8486905d8aAlin Rauta <listitem><para>Show properties of one

ed942a9eb22d50f667909ad6184b45015d28d054Tom Gundersen or more seats or the manager

ed942a9eb22d50f667909ad6184b45015d28d054Tom Gundersen itself. If no argument is specified

ed942a9eb22d50f667909ad6184b45015d28d054Tom Gundersen properties of the manager will be

ed942a9eb22d50f667909ad6184b45015d28d054Tom Gundersen shown. If a seat is specified

ed942a9eb22d50f667909ad6184b45015d28d054Tom Gundersen properties of the seat are shown. By

ed942a9eb22d50f667909ad6184b45015d28d054Tom Gundersen default, empty properties are

bd8f65387673e29f46136a4ed172097035002c23Tom Gundersen suppressed. Use <option>--all</option>

bd8f65387673e29f46136a4ed172097035002c23Tom Gundersen to show those too. To select specific

bd8f65387673e29f46136a4ed172097035002c23Tom Gundersen properties to show use

bd8f65387673e29f46136a4ed172097035002c23Tom Gundersen <option>--property=</option>. This

bd8f65387673e29f46136a4ed172097035002c23Tom Gundersen command is intended to be used

bd8f65387673e29f46136a4ed172097035002c23Tom Gundersen whenever computer-parsable output is

bd8f65387673e29f46136a4ed172097035002c23Tom Gundersen required. Use

bd8f65387673e29f46136a4ed172097035002c23Tom Gundersen <command>seat-status</command> if you

bd8f65387673e29f46136a4ed172097035002c23Tom Gundersen are looking for formatted

11bf3cced13c885ca215c108cb0bdb7a148520d6Lennart Poettering human-readable

11bf3cced13c885ca215c108cb0bdb7a148520d6Lennart Poettering output.</para></listitem>

0dd25fb9f005d8ab7ac4bc10a609d00569f8c56aLennart Poettering </varlistentry>

0dd25fb9f005d8ab7ac4bc10a609d00569f8c56aLennart Poettering

11bf3cced13c885ca215c108cb0bdb7a148520d6Lennart Poettering <varlistentry>

11bf3cced13c885ca215c108cb0bdb7a148520d6Lennart Poettering <term><command>attach [NAME] [DEVICE...]</command></term>

11bf3cced13c885ca215c108cb0bdb7a148520d6Lennart Poettering

cb9fc36a1211967e8c58b0502a26c42552ac8060Lennart Poettering <listitem><para>Attach one or more

cb9fc36a1211967e8c58b0502a26c42552ac8060Lennart Poettering devices to a seat. The devices should

cb9fc36a1211967e8c58b0502a26c42552ac8060Lennart Poettering be specified via device paths in the

769d324c99aab129148bd25f5f663ef441287d86Lennart Poettering <filename>/sys</filename> file

769d324c99aab129148bd25f5f663ef441287d86Lennart Poettering system. To create a new seat attach at

least one graphics card to a

previously unused seat names. seat

names may consist only of a-z, A-Z,

0-9, "-" and "_" and must be prefixed

with "seat". To drop assignment of a

device to a specific seat just

reassign it to a different seat, or

use

<command>flush-devices</command>.</para></listitem>

</varlistentry>

<varlistentry>

<term><command>flush-devices</command></term>

<listitem><para>Removes all device

assignments previously created with

<command>attach</command>. After this

call only automatically generated

seats will remain and all seat

hardware is assigned to

them.</para></listitem>

</varlistentry>

<varlistentry>

<term><command>terminate-seat [NAME...]</command></term>

<listitem><para>Terminates all

sessions on a seat. This kills all

processes of all sessions on a seat and

deallocates all runtime resources

attached to them.</para></listitem>

</varlistentry>

</variablelist>

</refsect1>

<refsect1>

<title>Exit status</title>

<para>On success 0 is returned, a non-zero failure

code otherwise.</para>

</refsect1>

<refsect1>

<title>Environment</title>

<variablelist>

<varlistentry>

<term><varname>$SYSTEMD_PAGER</varname></term>

<listitem><para>Pager to use when

<option>--no-pager</option> is not given;

overrides <varname>$PAGER</varname>. Setting

this to an empty string or the value

<literal>cat</literal> is equivalent to passing

<option>--no-pager</option>.</para></listitem>

</varlistentry>

</variablelist>

</refsect1>

<refsect1>

<title>See Also</title>

<para>

<citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,

<citerefentry><refentrytitle>systemctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>,

<citerefentry><refentrytitle>logind.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>

</para>

</refsect1>

</refentry>