man/systemd-ask-password-console.service.xml

   1 <?xml version="1.0"?>
   2 <!--*-nxml-*-->
   3 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   4   "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
   5 <!-- SPDX-License-Identifier: LGPL-2.1+ -->
   6 <refentry id="systemd-ask-password-console.service">
   7
   8   <refentryinfo>
   9     <title>systemd-ask-password-console.service</title>
  10     <productname>systemd</productname>
  11   </refentryinfo>
  12
  13   <refmeta>
  14     <refentrytitle>systemd-ask-password-console.service</refentrytitle>
  15     <manvolnum>8</manvolnum>
  16   </refmeta>
  17
  18   <refnamediv>
  19     <refname>systemd-ask-password-console.service</refname>
  20     <refname>systemd-ask-password-console.path</refname>
  21     <refname>systemd-ask-password-wall.service</refname>
  22     <refname>systemd-ask-password-wall.path</refname>
  23     <refpurpose>Query the user for system passwords on the
  24     console and via wall</refpurpose>
  25   </refnamediv>
  26
  27   <refsynopsisdiv>
  28     <para><filename>systemd-ask-password-console.service</filename></para>
  29     <para><filename>systemd-ask-password-console.path</filename></para>
  30     <para><filename>systemd-ask-password-wall.service</filename></para>
  31     <para><filename>systemd-ask-password-wall.path</filename></para>
  32   </refsynopsisdiv>
  33
  34   <refsect1>
  35     <title>Description</title>
  36
  37     <para><filename>systemd-ask-password-console.service</filename> is
  38     a system service that queries the user for system passwords (such
  39     as hard disk encryption keys and SSL certificate passphrases) on
  40     the console. It is intended to be used during boot to ensure
  41     proper handling of passwords necessary for boot.
  42     <filename>systemd-ask-password-wall.service</filename> is a system
  43     service that informs all logged in users for system passwords via
  44     <citerefentry project='man-pages'><refentrytitle>wall</refentrytitle><manvolnum>1</manvolnum></citerefentry>.
  45     It is intended to be used after boot to ensure that users are
  46     properly notified.</para>
  47
  48     <para>See the <ulink url="https://systemd.io/PASSWORD_AGENTS/">developer
  49     documentation</ulink> for more information about the system password logic.
  50     </para>
  51
  52     <para>Note that these services invoke
  53     <citerefentry><refentrytitle>systemd-tty-ask-password-agent</refentrytitle><manvolnum>1</manvolnum></citerefentry>
  54     with either the <command>--watch --console</command> or
  55     <command>--watch --wall</command> command line parameters.</para>
  56   </refsect1>
  57
  58   <refsect1>
  59     <title>See Also</title>
  60     <para>
  61       <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
  62       <citerefentry><refentrytitle>systemd-tty-ask-password-agent</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
  63       <citerefentry project='man-pages'><refentrytitle>wall</refentrytitle><manvolnum>1</manvolnum></citerefentry>
  64     </para>
  65   </refsect1>
  66
  67 </refentry>