SYSTEMD-TTY-ASK-PASSWORD-AGENT(1) systemd-tty-ask-password-agent SYSTEMD-TTY-ASK-PASSWORD-AGENT(1)

.SH "NAME" systemd-tty-ask-password-agent - List or process pending systemd password requests

.SH "SYNOPSIS"

.HP 744u

**systemd-tty-ask-password-agent**  
\[OPTIONS...]  
\[VARIABLE=VALUE...]

.SH "DESCRIPTION"

.PP **systemd-tty-ask-password-agent** is a password agent that handles password requests of the system, for example for hard disk encryption passwords or SSL certificate passwords that need to be queried at boot-time or during runtime.

.PP **systemd-tty-ask-password-agent** implements the **Password Agents Specification**\[1], and is one of many possible response agents which answer to queries formulated with [**systemd-ask-password**(1)](/man/os/systemd/systemd-ask-password.1).

.SH "OPTIONS"

.PP The following options are understood:

.PP **--list**

Lists all currently pending system password requests.

Added in version 186.

.RE

.PP **--query**

Process all currently pending system password requests by querying the user on the calling TTY.

Added in version 186.

.RE

.PP **--watch**

Continuously process password requests.

Added in version 186.

.RE

.PP **--wall**

Forward password requests to [**wall**(1)](/man/os/systemd/wall.1) instead of querying the user on the calling TTY.

Added in version 186.

.RE

.PP **--plymouth**

Ask question with [**plymouth**(8)](/man/os/systemd/plymouth.8) instead of querying the user on the calling TTY.

Added in version 186.

.RE

.PP **--console**\[=*DEVICE*]

Ask question on TTY *DEVICE* instead of querying the user on the calling TTY. If *DEVICE* is not specified, /dev/console will be used.

Added in version 186.

.RE

.PP **-h**, **--help**

Print a short help text and exit.

.RE  
.PP **--version**

Print a short version string and exit.

.RE

.SH "EXIT STATUS"

.PP On success, 0 is returned, a non-zero failure code otherwise.

.SH "SEE ALSO"

.PP [**systemd**(1)](/man/os/systemd/systemd.1), [**systemctl**(1)](/man/os/systemd/systemctl.1), [**systemd-ask-password-console.service**(8)](/man/os/systemd/systemd-ask-password-console.service.8), [**wall**(1)](/man/os/systemd/wall.1), [**plymouth**(8)](/man/os/systemd/plymouth.8)

# [NOTES](#NOTES)

1\.

Password Agents Specification

https://systemd.io/PASSWORD\_AGENTS/

systemd 262.2

---

Document: systemd-tty-ask-password-agent(1) from systemd 262.2-r1 (Chainguard OS)
Source: https://github.com/systemd/systemd