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

  .SH "NAME" systemd-tty-ask-password-agent - List or process pending systemd password requests
  .SH "SYNOPSIS"
    .HP u
      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.
          .RE
          .PP --query

                Process all currently pending system password requests by querying the user on the calling TTY.
              .RE
              .PP --watch

                    Continuously process password requests.
                  .RE
                  .PP --wall

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

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

                                Ask question on /dev/console instead of querying the user on the calling TTY.
                              .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)

NOTES

1.  Password Agents Specification
    https://www.freedesktop.org/wiki/Software/systemd/PasswordAgents