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-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><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>
68