{
    "mode": "man",
    "parameter": "PLYMOUTH",
    "section": "1",
    "url": "https://www.chedong.com/phpMan.php/man/PLYMOUTH/1/json",
    "generated": "2026-06-15T14:38:22Z",
    "synopsis": "",
    "sections": {
        "NAME": {
            "content": "plymouth - Send commands to plymouthd\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "",
            "subsections": [
                {
                    "name": "plymouth [OPTION...]",
                    "content": ""
                },
                {
                    "name": "plymouth COMMAND [OPTION...]",
                    "content": ""
                }
            ]
        },
        "DESCRIPTION": {
            "content": "The plymouth sends commands to a running plymouthd. This is used during the boot process to\ncontrol the display of the graphical boot splash.\n",
            "subsections": []
        },
        "OPTIONS": {
            "content": "The following options are understood. These options are supported for compatibility with the\nold rhgb-client interface, and have been replaced by the commands that are described in the\nnext section.\n",
            "subsections": [
                {
                    "name": "--help",
                    "content": "Show summary of options.\n",
                    "long": "--help"
                },
                {
                    "name": "--debug",
                    "content": "Enable verbose debug logging.\n",
                    "long": "--debug"
                },
                {
                    "name": "--get-splash-plugin-path",
                    "content": "Get directory where splash plugins are installed.\n",
                    "long": "--get-splash-plugin-path"
                },
                {
                    "name": "--newroot=[STRING]",
                    "content": "Tell plymouthd that the new root filesystem is mounted.\n",
                    "long": "--newroot",
                    "arg": "[STRING]"
                },
                {
                    "name": "--quit",
                    "content": "Tell plymouthd to quit.\n",
                    "long": "--quit"
                },
                {
                    "name": "--ping",
                    "content": "Check if plymouthd is running.\n",
                    "long": "--ping"
                },
                {
                    "name": "--has-active-vt",
                    "content": "Check if plymouthd has an active vt.\n",
                    "long": "--has-active-vt"
                },
                {
                    "name": "--sysinit",
                    "content": "Tell plymouthd root filesystem is mounted read-write.\n",
                    "long": "--sysinit"
                },
                {
                    "name": "--show-splash",
                    "content": "Show the splash screen.\n",
                    "long": "--show-splash"
                },
                {
                    "name": "--hide-splash",
                    "content": "Hide the splash screen.\n",
                    "long": "--hide-splash"
                },
                {
                    "name": "--ask-for-password",
                    "content": "Ask the user for a password.\n",
                    "long": "--ask-for-password"
                },
                {
                    "name": "--ignore-keystroke=[STRING]",
                    "content": "Remove sensitivity to a keystroke.\n",
                    "long": "--ignore-keystroke",
                    "arg": "[STRING]"
                },
                {
                    "name": "--update=[STRING]",
                    "content": "Tell plymouthd an update about boot progress.\n",
                    "long": "--update",
                    "arg": "[STRING]"
                },
                {
                    "name": "--details",
                    "content": "Tell plymouthd there were errors during boot.\n",
                    "long": "--details"
                },
                {
                    "name": "--wait",
                    "content": "Wait for plymouthd to quit.\n",
                    "long": "--wait"
                }
            ]
        },
        "COMMANDS": {
            "content": "The following commands are understood:\n",
            "subsections": [
                {
                    "name": "change-mode OPTION",
                    "content": "Change the operation mode.\n\n--boot-up\nStart the system up\n\n--shutdown\nShutting the system up\n\n--updates\nApplying updates\n"
                },
                {
                    "name": "system-update OPTION",
                    "content": "Tell plymouthd about boot progress.\n\n--progress=INTEGER\nThe percentage progress of the updates\n"
                },
                {
                    "name": "update OPTION",
                    "content": "Tell plymouthd about boot status changes.\n\n--status=STRING\nTell plymouthd the current boot status\n"
                },
                {
                    "name": "update-root-fs OPTION",
                    "content": "Tell plymouthd about root filesystem changes.\n\n--new-root-dir=STRING\nRoot filesystem is about to change\n\n--read-write\nRoot filesystem is no longer read-only\n"
                },
                {
                    "name": "show-splash",
                    "content": "Tell plymouthd to show splash screen.\n"
                },
                {
                    "name": "hide-splash",
                    "content": "Tell plymouthd to hide splash screen.\n"
                },
                {
                    "name": "ask-for-password OPTION",
                    "content": "Ask the user for a password.\n\n--command=STRING\nCommand to send password to via standard input\n\n--prompt=STRING\nMessage to display when asking for password\n\n--number-of-tries=INTEGER\nNumber of times to ask before giving up (requires --command)\n\n--dont-pause-progress\nDon't pause boot progress bar while asking\n"
                },
                {
                    "name": "ask-question",
                    "content": "Ask the user a question.\n\n--command=STRING\nCommand to send the answer to via standard input\n\n--prompt=STRING\nMessage to display when asking the question\n\n--dont-pause-progress\nDon't pause boot progress bar while asking\n"
                },
                {
                    "name": "display-message OPTION",
                    "content": "Display a message.\n\n--text=STRING\nThe message text\n"
                },
                {
                    "name": "hide-message OPTION",
                    "content": "Hide a message.\n\n--text=STRING\nThe message text\n"
                },
                {
                    "name": "watch-keystroke OPTION",
                    "content": "Become sensitive to a keystroke.\n\n--command=STRING\nCommand to send keystroke to via standard input\n\n--keys=STRING\nKeys to become sensitive to\n"
                },
                {
                    "name": "ignore-keystroke OPTION",
                    "content": "Remove sensitivity to a keystroke.\n\n--keys=STRING\nKeys to remove sensitivity from\n"
                },
                {
                    "name": "pause-progress",
                    "content": "Pause boot progress bar.\n"
                },
                {
                    "name": "unpause-progress",
                    "content": "Unpause boot progress bar.\n"
                },
                {
                    "name": "report-error",
                    "content": "Tell plymouthd there were errors during boot.\n"
                },
                {
                    "name": "deactivate",
                    "content": "Tell plymouthd to deactivate.\n"
                },
                {
                    "name": "reactivate",
                    "content": "Tell plymouthd to reactivate.\n"
                },
                {
                    "name": "quit OPTION",
                    "content": "Tell plymouthd to quit.\n\n--retain-splash\nDon't explicitly hide boot splash on exit\n"
                }
            ]
        },
        "SEE ALSO": {
            "content": "grub(8), plymouth(8), plymouthd(8), http://www.freedesktop.org/wiki/Software/Plymouth\n\n\n\nplymouth                                                                                 PLYMOUTH(1)",
            "subsections": []
        }
    },
    "summary": "plymouth - Send commands to plymouthd",
    "flags": [
        {
            "flag": "",
            "long": "--help",
            "arg": null,
            "description": "Show summary of options."
        },
        {
            "flag": "",
            "long": "--debug",
            "arg": null,
            "description": "Enable verbose debug logging."
        },
        {
            "flag": "",
            "long": "--get-splash-plugin-path",
            "arg": null,
            "description": "Get directory where splash plugins are installed."
        },
        {
            "flag": "",
            "long": "--newroot",
            "arg": "[STRING",
            "description": "Tell plymouthd that the new root filesystem is mounted."
        },
        {
            "flag": "",
            "long": "--quit",
            "arg": null,
            "description": "Tell plymouthd to quit."
        },
        {
            "flag": "",
            "long": "--ping",
            "arg": null,
            "description": "Check if plymouthd is running."
        },
        {
            "flag": "",
            "long": "--has-active-vt",
            "arg": null,
            "description": "Check if plymouthd has an active vt."
        },
        {
            "flag": "",
            "long": "--sysinit",
            "arg": null,
            "description": "Tell plymouthd root filesystem is mounted read-write."
        },
        {
            "flag": "",
            "long": "--show-splash",
            "arg": null,
            "description": "Show the splash screen."
        },
        {
            "flag": "",
            "long": "--hide-splash",
            "arg": null,
            "description": "Hide the splash screen."
        },
        {
            "flag": "",
            "long": "--ask-for-password",
            "arg": null,
            "description": "Ask the user for a password."
        },
        {
            "flag": "",
            "long": "--ignore-keystroke",
            "arg": "[STRING",
            "description": "Remove sensitivity to a keystroke."
        },
        {
            "flag": "",
            "long": "--update",
            "arg": "[STRING",
            "description": "Tell plymouthd an update about boot progress."
        },
        {
            "flag": "",
            "long": "--details",
            "arg": null,
            "description": "Tell plymouthd there were errors during boot."
        },
        {
            "flag": "",
            "long": "--wait",
            "arg": null,
            "description": "Wait for plymouthd to quit."
        }
    ],
    "examples": [],
    "see_also": [
        {
            "name": "grub",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/grub/8/json"
        },
        {
            "name": "plymouth",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/plymouth/8/json"
        },
        {
            "name": "plymouthd",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/plymouthd/8/json"
        }
    ]
}