1 <?xml version='
1.0'
?> <!--*-nxml-*-->
2 <!DOCTYPE refentry PUBLIC
"-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4 <!-- SPDX-License-Identifier: LGPL-2.1-or-later -->
6 <refentry id=
"systemd-tty-ask-password-agent"
7 xmlns:
xi=
"http://www.w3.org/2001/XInclude">
10 <title>systemd-tty-ask-password-agent
</title>
11 <productname>systemd
</productname>
15 <refentrytitle>systemd-tty-ask-password-agent
</refentrytitle>
16 <manvolnum>1</manvolnum>
20 <refname>systemd-tty-ask-password-agent
</refname>
21 <refpurpose>List or process pending systemd password requests
</refpurpose>
26 <command>systemd-tty-ask-password-agent
</command>
27 <arg choice=
"opt" rep=
"repeat">OPTIONS
</arg>
28 <arg choice=
"opt" rep=
"repeat">VARIABLE=VALUE
</arg>
33 <title>Description
</title>
35 <para><command>systemd-tty-ask-password-agent
</command> is a
36 password agent that handles password requests of the system, for
37 example for hard disk encryption passwords or SSL certificate
38 passwords that need to be queried at boot-time or during
41 <para><command>systemd-tty-ask-password-agent
</command> implements
42 the
<ulink url=
"https://systemd.io/PASSWORD_AGENTS/">Password Agents
43 Specification
</ulink>, and is one of many possible response agents which
44 answer to queries formulated with
45 <citerefentry><refentrytitle>systemd-ask-password
</refentrytitle><manvolnum>1</manvolnum></citerefentry>.
50 <title>Options
</title>
52 <para>The following options are understood:
</para>
56 <term><option>--list
</option></term>
58 <listitem><para>Lists all currently pending system password requests.
</para>
60 <xi:include href=
"version-info.xml" xpointer=
"v186"/></listitem>
64 <term><option>--query
</option></term>
66 <listitem><para>Process all currently pending system password
67 requests by querying the user on the calling
70 <xi:include href=
"version-info.xml" xpointer=
"v186"/></listitem>
74 <term><option>--watch
</option></term>
76 <listitem><para>Continuously process password
79 <xi:include href=
"version-info.xml" xpointer=
"v186"/></listitem>
83 <term><option>--wall
</option></term>
85 <listitem><para>Forward password requests to
86 <citerefentry project='man-pages'
><refentrytitle>wall
</refentrytitle><manvolnum>1</manvolnum></citerefentry>
87 instead of querying the user on the calling
90 <xi:include href=
"version-info.xml" xpointer=
"v186"/></listitem>
94 <term><option>--plymouth
</option></term>
96 <listitem><para>Ask question with
97 <citerefentry project='die-net'
><refentrytitle>plymouth
</refentrytitle><manvolnum>8</manvolnum></citerefentry>
98 instead of querying the user on the calling
101 <xi:include href=
"version-info.xml" xpointer=
"v186"/></listitem>
105 <term><option>--console
</option><optional>=
<replaceable>DEVICE
</replaceable></optional></term>
107 <listitem><para>Ask question on TTY
<replaceable>DEVICE
</replaceable> instead of querying the user on
108 the calling TTY. If
<replaceable>DEVICE
</replaceable> is not specified,
109 <filename>/dev/console
</filename> will be used.
</para>
111 <xi:include href=
"version-info.xml" xpointer=
"v186"/></listitem>
114 <xi:include href=
"standard-options.xml" xpointer=
"help" />
115 <xi:include href=
"standard-options.xml" xpointer=
"version" />
121 <title>Exit status
</title>
123 <para>On success,
0 is returned, a non-zero failure
124 code otherwise.
</para>
128 <title>See Also
</title>
130 <citerefentry><refentrytitle>systemd
</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
131 <citerefentry><refentrytitle>systemctl
</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
132 <citerefentry><refentrytitle>systemd-ask-password-console.service
</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
133 <citerefentry project='man-pages'
><refentrytitle>wall
</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
134 <citerefentry project='die-net'
><refentrytitle>plymouth
</refentrytitle><manvolnum>8</manvolnum></citerefentry>