{
    "mode": "man",
    "parameter": "runit-shutdown",
    "section": "8",
    "url": "https://www.chedong.com/phpMan.php/man/runit-shutdown/8/json",
    "generated": "2026-06-14T00:16:59Z",
    "synopsis": "",
    "sections": {
        "NAME": {
            "content": "shutdown, reboot, poweroff - poweroff or reboot the system\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "",
            "subsections": [
                {
                    "name": "/sbin/shutdown [-r] [-f] [-F]",
                    "content": ""
                },
                {
                    "name": "/sbin/reboot [-w] [-f] [-n]",
                    "content": ""
                },
                {
                    "name": "/sbin/halt [-w] [-f] [-n]",
                    "content": ""
                },
                {
                    "name": "/sbin/poweroff [-w] [-f] [-n]",
                    "content": ""
                }
            ]
        },
        "DESCRIPTION": {
            "content": "Shutdown is a program to poweroff or reboot the system that maintains some compatibility with\noriginal SysV-init halt, poweroff, reboot and shutdown programs.  These programs are expected\nby some initscripts, graphical desktop environments and tools like acpi.\nWhen  called  as shutdown, halt or poweroff without options, runit(8) is told to shutdown the\nsystem and poweroff.\nWhen called as reboot runit(8) is told to reboot the system.\nWhen runit(8) is not the current init system this program sends data in the appropriate  for‐\nmat to perform the requested action to the initctl pipe, if it exists.\n",
            "subsections": []
        },
        "SHUTDOWN OPTIONS": {
            "content": "",
            "subsections": [
                {
                    "name": "-r",
                    "content": "",
                    "flag": "-r"
                },
                {
                    "name": "-f",
                    "content": "boot task can test for this file when the system comes up again  and  decide  to  skip\nfsck.  The program or the scripts that perform the boot task also need to take care of\nthe removal of the flag file.\n\n",
                    "flag": "-f"
                },
                {
                    "name": "-F",
                    "content": "boot task can test for this file when the system comes up again and decide to run fsck\nwith a 'force' flag.  The program or the scripts that perform the boot task also  need\nto take care of the removal of the flag file.\n\n",
                    "flag": "-F"
                }
            ]
        },
        "HALT OPTIONS": {
            "content": "",
            "subsections": [
                {
                    "name": "-f",
                    "content": "the init system.  This will likely result in an unclean shutdown and  can  cause  data\nloss  or corruption.  When runit is init, this option is a No-Op and all other options\nare ignored. See #899246\n\n",
                    "flag": "-f"
                },
                {
                    "name": "--force",
                    "content": "Invoke sync(), then force an unsafe reboot or poweroff immediately  without  signaling\nthe  init  system.   This will likely result in an unclean shutdown and can cause data\nloss or corruption.  This option works regardless of the running init system.\n\n",
                    "long": "--force"
                },
                {
                    "name": "-w, --wtmp-only",
                    "content": "No-Op, maintained for compatibility with initscripts. See #919699\n\n",
                    "flag": "-w",
                    "long": "--wtmp-only"
                },
                {
                    "name": "-n",
                    "content": "before  reboot or poweroff.  The /etc/runit/nosync flag file is also checked when this\nprogram is called with -f or --force\n\n",
                    "flag": "-n"
                }
            ]
        },
        "SWITCHING FORM OTHER INIT SYSTEMS": {
            "content": "This program maintains a compatibility layer with SysV-init's initctl pipe according  to  the\nspec  described in SysV-init's initctl(5). This allow one to reboot the system when switching\nfrom another init to runit-init.\nCurrently only switching from systemd and SysV-init is tested but any other init system  that\nmaintains an initctl pipe compatible with SysV's one should work.\n\n",
            "subsections": []
        },
        "BUGS": {
            "content": "Combining flags, like halt -wf is not supported, all merged short options will be ignored.\nNon existent or unsupported options are silently ignored.\n\n",
            "subsections": []
        },
        "SEE ALSO": {
            "content": "init(8)\n\n\n\nAugust 29, 2021                               SHUTDOWN(8)",
            "subsections": []
        }
    },
    "summary": "shutdown, reboot, poweroff - poweroff or reboot the system",
    "flags": [],
    "examples": [],
    "see_also": [
        {
            "name": "init",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/init/8/json"
        }
    ]
}