{
    "mode": "man",
    "parameter": "systemd-tty-ask-password-agent",
    "section": "1",
    "url": "https://www.chedong.com/phpMan.php/man/systemd-tty-ask-password-agent/1/json",
    "generated": "2026-06-12T15:36:30Z",
    "synopsis": "systemd-tty-ask-password-agent [OPTIONS...] [VARIABLE=VALUE...]",
    "sections": {
        "NAME": {
            "content": "systemd-tty-ask-password-agent - List or process pending systemd password 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 password requests of the\nsystem, for example for hard disk encryption passwords or SSL certificate passwords that need\nto be queried at boot-time or during runtime.\n\nsystemd-tty-ask-password-agent implements the Password Agents Specification[1], and is one of\nmany possible response agents which answer to queries formulated with systemd-ask-\npassword(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 the user on the\ncalling 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 on the calling TTY.\n",
                    "long": "--wall"
                },
                {
                    "name": "--plymouth",
                    "content": "Ask question with plymouth(8) instead of querying the user on the calling TTY.\n\n--console[=DEVICE]\nAsk question on TTY DEVICE instead of querying the user on the calling TTY. If DEVICE is\nnot specified, /dev/console will be used.\n",
                    "long": "--plymouth"
                },
                {
                    "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), wall(1), plymouth(8)\n",
            "subsections": []
        },
        "NOTES": {
            "content": "1. Password Agents Specification\nhttps://systemd.io/PASSWORDAGENTS/\n\n\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. --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."
        },
        {
            "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"
        }
    ],
    "tldr": {
        "source": "official",
        "description": "List or process pending systemd password requests.",
        "examples": [
            {
                "description": "List all currently pending system password requests",
                "command": "systemd-tty-ask-password-agent --list"
            },
            {
                "description": "Continuously process password requests",
                "command": "systemd-tty-ask-password-agent --watch"
            },
            {
                "description": "Process all currently pending system password requests by querying the user on the calling TTY",
                "command": "systemd-tty-ask-password-agent --query"
            },
            {
                "description": "Forward password requests to wall instead of querying the user on the calling TTY",
                "command": "systemd-tty-ask-password-agent --wall"
            }
        ]
    }
}