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

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

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/

systemd 255                                  SYSTEMD-TTY-ASK-PASSWORD-AGENT(1)