{
    "mode": "man",
    "parameter": "systemd-battery-check",
    "section": "8",
    "url": "https://www.chedong.com/phpMan.php/man/systemd-battery-check/8/json",
    "generated": "2026-10-08T07:32:04Z",
    "synopsis": "systemd-battery-check.service\n/usr/lib/systemd/systemd-battery-check [OPTIONS...]",
    "sections": {
        "NAME": {
            "content": "systemd-battery-check.service, systemd-battery-check - Check battery level whether there's\nenough charge, and power off if not\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "systemd-battery-check.service\n\n/usr/lib/systemd/systemd-battery-check [OPTIONS...]\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "This service checks the presence of an external power supply and the battery level during the\nearly boot stage to determine whether there is sufficient power to carry on with the booting\nprocess.\n\nsystemd-battery-check returns success if the device is connected to an AC power source or if\nthe battery charge is greater than 5%. It returns failure otherwise.\n",
            "subsections": []
        },
        "OPTIONS": {
            "content": "The following options are understood by systemd-battery-check:\n",
            "subsections": [
                {
                    "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 (running on AC power or battery capacity greater than 5%), 0 is returned, a\nnon-zero failure code otherwise.\n",
            "subsections": []
        },
        "KERNEL COMMAND LINE": {
            "content": "The following variables are understood:\n\nsystemd.battery-check=BOOL\nTakes a boolean. If specified with false, systemd-battery-check command will return\nimmediately with exit status 0 without checking battery capacity and AC power existence,\nand the service systemd-battery-check.service will succeed. This may be useful when the\ncommand wrongly detects and reports battery capacity percentage or AC power existence, or\nwhen you want to boot the system forcibly.\n\nAdded in version 254.\n",
            "subsections": []
        },
        "SEE ALSO": {
            "content": "systemd(1)\n\nsystemd 255                                                         SYSTEMD-BATTERY-CHECK.SERVICE(8)",
            "subsections": []
        }
    },
    "summary": "systemd-battery-check.service, systemd-battery-check - Check battery level whether there's enough charge, and power off if not",
    "flags": [
        {
            "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": "SYSTEMD-BATTERY-CHECK.SERVICE",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/SYSTEMD-BATTERY-CHECK.SERVICE/8/json"
        }
    ]
}