systemd/man/systemd-user-sessions.service.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-user-sessions.service" conditional='HAVE_PAM'>

  <refentryinfo>
    <title>systemd-user-sessions.service</title>
    <productname>systemd</productname>
  </refentryinfo>

  <refmeta>
    <refentrytitle>systemd-user-sessions.service</refentrytitle>
    <manvolnum>8</manvolnum>
  </refmeta>

  <refnamediv>
    <refname>systemd-user-sessions.service</refname>
    <refname>systemd-user-sessions</refname>
    <refpurpose>Permit user logins after boot, prohibit user logins at shutdown</refpurpose>
  </refnamediv>

  <refsynopsisdiv>
    <para><filename>systemd-user-sessions.service</filename></para>
    <para><filename>/usr/lib/systemd/systemd-user-sessions</filename></para>
  </refsynopsisdiv>

  <refsect1>
    <title>Description</title>

    <para><filename>systemd-user-sessions.service</filename> is a
    service that controls user logins through
    <citerefentry project='man-pages'><refentrytitle>pam_nologin</refentrytitle><manvolnum>8</manvolnum></citerefentry>.
    After basic system initialization is complete, it removes
    <filename>/run/nologin</filename>, thus permitting logins. Before
    system shutdown, it creates <filename>/run/nologin</filename>, thus
    prohibiting further logins.</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-logind.service</refentrytitle><manvolnum>8</manvolnum></citerefentry></member>
      <member><citerefentry project='man-pages'><refentrytitle>pam_nologin</refentrytitle><manvolnum>8</manvolnum></citerefentry></member>
    </simplelist></para>
  </refsect1>

</refentry>
man: document systemd-user-sessions.service 2012-06-25 23:34:50 +08:00			`<?xml version="1.0"?>`
			`<!---nxml--->`
man: use same header for all files The "include" files had type "book" for some raeason. I don't think this is meaningful. Let's just use the same everywhere. $ perl -i -0pe 's^..DOCTYPE (book\|refentry) PUBLIC "-//OASIS//DTD DocBook XML V4.[25]//EN"\s+"http^<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"\n "http^gms' man/*.xml 2019-03-14 21:40:58 +08:00			`<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"`
man: use same version in public and system ident. 2023-12-25 22:48:33 +08:00			`"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">`
license: LGPL-2.1+ -> LGPL-2.1-or-later 2020-11-09 12:23:58 +08:00			`<!-- SPDX-License-Identifier: LGPL-2.1-or-later -->`
build-sys: make systemd-user-sessions conditional on PAM again This undoes a part of previous commit: s-u-s is dependent on HAVE_PAM again, but not on HAVE_LOGIND. 2015-02-28 06:26:26 +08:00			`<refentry id="systemd-user-sessions.service" conditional='HAVE_PAM'>`
man: document systemd-user-sessions.service 2012-06-25 23:34:50 +08:00
Reindent man pages to 2ch 2015-02-04 10:14:13 +08:00			`<refentryinfo>`
			`<title>systemd-user-sessions.service</title>`
			`<productname>systemd</productname>`
			`</refentryinfo>`
man: document systemd-user-sessions.service 2012-06-25 23:34:50 +08:00
Reindent man pages to 2ch 2015-02-04 10:14:13 +08:00			`<refmeta>`
			`<refentrytitle>systemd-user-sessions.service</refentrytitle>`
			`<manvolnum>8</manvolnum>`
			`</refmeta>`
man: document systemd-user-sessions.service 2012-06-25 23:34:50 +08:00
Reindent man pages to 2ch 2015-02-04 10:14:13 +08:00			`<refnamediv>`
			`<refname>systemd-user-sessions.service</refname>`
			`<refname>systemd-user-sessions</refname>`
			`<refpurpose>Permit user logins after boot, prohibit user logins at shutdown</refpurpose>`
			`</refnamediv>`
man: document systemd-user-sessions.service 2012-06-25 23:34:50 +08:00
Reindent man pages to 2ch 2015-02-04 10:14:13 +08:00			`<refsynopsisdiv>`
			`<para><filename>systemd-user-sessions.service</filename></para>`
man: revert dynamic paths for split-usr setups This did not really work out as we had hoped. Trying to do this upstream introduced several problems that probably makes it better suited as a downstream patch after all. At any rate, it is not releaseable in the current state, so we at least need to revert this before the release. * by adjusting the path to binaries, but not do the same thing to the search path we end up with inconsistent man-pages. Adjusting the search path too would be quite messy, and it is not at all obvious that this is worth the effort, but at any rate it would have to be done before we could ship this. * this means that distributed man-pages does not make sense as they depend on config options, and for better or worse we are still distributing man pages, so that is something that definitely needs sorting out before we could ship with this patch. * we have long held that split-usr is only minimally supported in order to boot, and something we hope will eventually go away. So before we start adding even more magic/effort in order to make this work nicely, we should probably question if it makes sense at all. 2015-06-19 01:47:44 +08:00			`<para><filename>/usr/lib/systemd/systemd-user-sessions</filename></para>`
Reindent man pages to 2ch 2015-02-04 10:14:13 +08:00			`</refsynopsisdiv>`
man: document systemd-user-sessions.service 2012-06-25 23:34:50 +08:00
Reindent man pages to 2ch 2015-02-04 10:14:13 +08:00			`<refsect1>`
			`<title>Description</title>`
man: document systemd-user-sessions.service 2012-06-25 23:34:50 +08:00
Reindent man pages to 2ch 2015-02-04 10:14:13 +08:00			`<para><filename>systemd-user-sessions.service</filename> is a`
man: correct description of systemd-user-sessions That part of functionality was removed in 7fb3ee51c1b377. 2015-02-28 06:26:42 +08:00			`service that controls user logins through`
			`<citerefentry project='man-pages'><refentrytitle>pam_nologin</refentrytitle><manvolnum>8</manvolnum></citerefentry>.`
doc: correct punctuation and improve typography in documentation 2014-08-03 13:11:12 +08:00			`After basic system initialization is complete, it removes`
Reindent man pages to 2ch 2015-02-04 10:14:13 +08:00			`<filename>/run/nologin</filename>, thus permitting logins. Before`
doc: correct punctuation and improve typography in documentation 2014-08-03 13:11:12 +08:00			`system shutdown, it creates <filename>/run/nologin</filename>, thus`
man: correct description of systemd-user-sessions That part of functionality was removed in 7fb3ee51c1b377. 2015-02-28 06:26:42 +08:00			`prohibiting further logins.</para>`
Reindent man pages to 2ch 2015-02-04 10:14:13 +08:00			`</refsect1>`
man: document systemd-user-sessions.service 2012-06-25 23:34:50 +08:00
Reindent man pages to 2ch 2015-02-04 10:14:13 +08:00			`<refsect1>`
			`<title>See Also</title>`
man: use <simplelist> for 'See also' sections This is just a slight markup improvement; there should be no difference in rendering. 2023-12-23 02:09:32 +08:00			`<para><simplelist type="inline">`
			`<member><citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry></member>`
			`<member><citerefentry><refentrytitle>systemd-logind.service</refentrytitle><manvolnum>8</manvolnum></citerefentry></member>`
			`<member><citerefentry project='man-pages'><refentrytitle>pam_nologin</refentrytitle><manvolnum>8</manvolnum></citerefentry></member>`
			`</simplelist></para>`
Reindent man pages to 2ch 2015-02-04 10:14:13 +08:00			`</refsect1>`
man: document systemd-user-sessions.service 2012-06-25 23:34:50 +08:00
			`</refentry>`