{
    "mode": "info",
    "parameter": "systemd-tty-ask-password-agent",
    "section": "",
    "url": "https://www.chedong.com/phpMan.php/info/systemd-tty-ask-password-agent/json",
    "generated": "2026-07-05T13:22:14Z",
    "synopsis": "systemd-tty-ask-password-agent [OPTIONS...] [VARIABLE=VALUE...]",
    "sections": {
        "NAME": {
            "content": "systemd-tty-ask-password-agent - List or process pending systemd\npassword requests\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "systemd-tty-ask-password-agent [OPTIONS...] [VARIABLE=VALUE...]\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "systemd-tty-ask-password-agent is a password agent that handles\npassword requests of the system, for example for hard disk encryption\npasswords or SSL certificate passwords that need to be queried at\nboot-time or during runtime.\n\nsystemd-tty-ask-password-agent implements the Password Agents\nSpecification[1], and is one of many possible response agents which\nanswer to queries formulated with systemd-ask-password(1).\n",
            "subsections": []
        },
        "OPTIONS": {
            "content": "The following options are understood:\n",
            "subsections": [
                {
                    "name": "--list",
                    "content": "Lists all currently pending system password requests.\n",
                    "long": "--list"
                },
                {
                    "name": "--query",
                    "content": "Process all currently pending system password requests by querying\nthe user on the calling TTY.\n",
                    "long": "--query"
                },
                {
                    "name": "--watch",
                    "content": "Continuously process password requests.\n",
                    "long": "--watch"
                },
                {
                    "name": "--wall",
                    "content": "Forward password requests to wall(1) instead of querying the user\non the calling TTY.\n",
                    "long": "--wall"
                },
                {
                    "name": "--plymouth",
                    "content": "Ask question with plymouth(8) instead of querying the user on the\ncalling TTY.\n",
                    "long": "--plymouth"
                },
                {
                    "name": "--console[=DEVICE]",
                    "content": "Ask question on TTY DEVICE instead of querying the user on the\ncalling TTY. If DEVICE is not specified, /dev/console will be used.\n"
                },
                {
                    "name": "-h, --help",
                    "content": "Print a short help text and exit.\n",
                    "flag": "-h",
                    "long": "--help"
                },
                {
                    "name": "--version",
                    "content": "Print a short version string and exit.\n",
                    "long": "--version"
                }
            ]
        },
        "EXIT STATUS": {
            "content": "On success, 0 is returned, a non-zero failure code otherwise.\n",
            "subsections": []
        },
        "SEE ALSO": {
            "content": "systemd(1), systemctl(1), systemd-ask-password-console.service(8),\nwall(1), plymouth(8)\n",
            "subsections": []
        },
        "NOTES": {
            "content": "1. Password Agents Specification\nhttps://systemd.io/PASSWORDAGENTS/\n\nsystemd 249                                  SYSTEMD-TTY-ASK-PASSWORD-AGENT(1)",
            "subsections": []
        }
    },
    "summary": "systemd-tty-ask-password-agent - List or process pending systemd password requests",
    "flags": [
        {
            "flag": "",
            "long": "--list",
            "arg": null,
            "description": "Lists all currently pending system password requests."
        },
        {
            "flag": "",
            "long": "--query",
            "arg": null,
            "description": "Process all currently pending system password requests by querying the user on the calling TTY."
        },
        {
            "flag": "",
            "long": "--watch",
            "arg": null,
            "description": "Continuously process password requests."
        },
        {
            "flag": "",
            "long": "--wall",
            "arg": null,
            "description": "Forward password requests to wall(1) instead of querying the user on the calling TTY."
        },
        {
            "flag": "",
            "long": "--plymouth",
            "arg": null,
            "description": "Ask question with plymouth(8) instead of querying the user on the calling TTY."
        },
        {
            "flag": "",
            "long": null,
            "arg": null,
            "description": "Ask question on TTY DEVICE instead of querying the user on the calling TTY. If DEVICE is not specified, /dev/console will be used."
        },
        {
            "flag": "-h",
            "long": "--help",
            "arg": null,
            "description": "Print a short help text and exit."
        },
        {
            "flag": "",
            "long": "--version",
            "arg": null,
            "description": "Print a short version string and exit."
        }
    ],
    "examples": [],
    "see_also": [
        {
            "name": "systemd",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/systemd/1/json"
        },
        {
            "name": "systemctl",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/systemctl/1/json"
        },
        {
            "name": "systemd-ask-password-console.service",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/systemd-ask-password-console.service/8/json"
        },
        {
            "name": "wall",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/wall/1/json"
        },
        {
            "name": "plymouth",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/plymouth/8/json"
        }
    ]
}