systemd-tty-ask-password-agent - Man Page

List or process pending systemd password requests

Examples (TL;DR)

tldr.sh

Synopsis

systemd-tty-ask-password-agent [Options...] [VARIABLE=VALUE...]

Description

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.

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

Options

The following options are understood:

--list

Lists all currently pending system password requests.

Added in version 186.

--query

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

Added in version 186.

--watch

Continuously process password requests.

Added in version 186.

--wall

Forward password requests to wall(1) instead of querying the user on the calling TTY.

Added in version 186.

--plymouth

Ask question with plymouth(8) instead of querying the user on the calling TTY.

Added in version 186.

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

-h,  --help

Print a short help text and exit.

--version

Print a short version string and exit.

Exit Status

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

See Also

systemd(1), systemctl(1), systemd-ask-password-console.service(8), wall(1), plymouth(8)

Notes

1.

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

Referenced By

systemd-ask-password(1), systemd-ask-password-console.service(8), systemd.directives(7), systemd.index(7).

systemd 256.7