OS Manuals

systemd-tty-ask-password-agent(1)

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).


.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) instead of querying the user on the calling TTY.


Added in version 186.


.RE


.PP --plymouth


Ask question with 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), systemctl(1), systemd-ask-password-console.service(8), wall(1), plymouth(8)

1.
Password Agents Specification
https://systemd.io/PASSWORD_AGENTS/
systemd 262.2

systemd 262.2-r1 · os · ingested 2026-11-06