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.5/docbookx.dtd">
   5 <!-- SPDX-License-Identifier: LGPL-2.1-or-later -->
   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><simplelist>
  29       <member><filename>systemd-ask-password-console.service</filename></member>
  30       <member><filename>systemd-ask-password-console.path</filename></member>
  31       <member><filename>systemd-ask-password-wall.service</filename></member>
  32       <member><filename>systemd-ask-password-wall.path</filename></member>
  33     </simplelist></para>
  34   </refsynopsisdiv>
  35
  36   <refsect1>
  37     <title>Description</title>
  38
  39     <para><filename>systemd-ask-password-console.service</filename> is
  40     a system service that queries the user for system passwords (such
  41     as hard disk encryption keys and SSL certificate passphrases) on
  42     the console. It is intended to be used during boot to ensure
  43     proper handling of passwords necessary for boot.
  44     <filename>systemd-ask-password-wall.service</filename> is a system
  45     service that informs all logged in users for system passwords via
  46     <citerefentry project='man-pages'><refentrytitle>wall</refentrytitle><manvolnum>1</manvolnum></citerefentry>.
  47     It is intended to be used after boot to ensure that users are
  48     properly notified.</para>
  49
  50     <para>See the <ulink url="https://systemd.io/PASSWORD_AGENTS/">developer
  51     documentation</ulink> for more information about the system password logic.
  52     </para>
  53
  54     <para>Note that these services invoke
  55     <citerefentry><refentrytitle>systemd-tty-ask-password-agent</refentrytitle><manvolnum>1</manvolnum></citerefentry>
  56     with either the <command>--watch --console</command> or
  57     <command>--watch --wall</command> command line parameters.</para>
  58   </refsect1>
  59
  60   <refsect1>
  61     <title>See Also</title>
  62     <para><simplelist type="inline">
  63       <member><citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry></member>
  64       <member><citerefentry><refentrytitle>systemd-tty-ask-password-agent</refentrytitle><manvolnum>1</manvolnum></citerefentry></member>
  65       <member><citerefentry project='man-pages'><refentrytitle>wall</refentrytitle><manvolnum>1</manvolnum></citerefentry></member>
  66     </simplelist></para>
  67   </refsect1>
  68
  69 </refentry>