{
    "mode": "man",
    "parameter": "systemd-bless-boot.service",
    "section": "8",
    "url": "https://www.chedong.com/phpMan.php/man/systemd-bless-boot.service/8/json",
    "generated": "2026-05-30T06:07:25Z",
    "synopsis": "systemd-bless-boot.service\n/lib/systemd/system-bless-boot",
    "sections": {
        "NAME": {
            "content": "systemd-bless-boot.service, systemd-bless-boot - Mark current boot process as successful\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "systemd-bless-boot.service\n\n/lib/systemd/system-bless-boot\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "systemd-bless-boot.service is a system service that marks the current boot process as\nsuccessful. It's automatically pulled into the initial transaction when systemd-bless-boot-\ngenerator(8) detects that systemd-boot(7) style boot counting is used.\n\nInternally, the service operates based on the LoaderBootCountPath EFI variable (of the vendor\nUUID 4a67b082-0a4c-41cf-b6c7-440b29bb8c4), which is passed from the boot loader to the OS. It\ncontains a file system path (relative to the EFI system partition) of the Boot Loader\nSpecification[1] compliant boot loader entry file or unified kernel image file that was used\nto boot up the system.  systemd-bless-boot.service removes the two 'tries done' and 'tries\nleft' numeric boot counters from the filename, which indicates to future invocations of the\nboot loader that the entry has completed booting successfully at least once. (This service\nwill hence rename the boot loader entry file or unified kernel image file on the first\nsuccessful boot.)\n",
            "subsections": []
        },
        "OPTIONS": {
            "content": "The /lib/systemd/system-bless-boot executable may also be invoked from the command line,\ntaking one of the following command arguments:\n",
            "subsections": [
                {
                    "name": "status",
                    "content": "The current status of the boot loader entry file or unified kernel image file is shown.\nThis outputs one of \"good\", \"bad\", \"indeterminate\", \"clean\", depending on the state and\nprevious invocations of the command. The string \"indeterminate\" is shown initially after\nboot, before it has been marked as \"good\" or \"bad\". The string \"good\" is shown after the\nboot was marked as \"good\" with the good command below, and \"bad\" conversely after the bad\ncommand was invoked. The string \"clean\" is returned when boot counting is currently not\nin effect.\n\nThis command is implied if no command argument is specified.\n"
                },
                {
                    "name": "good",
                    "content": "When invoked, the current boot loader entry file or unified kernel image file will be\nmarked as \"good\", executing the file rename operation described above. This command is\nintended to be invoked at the end of a successful boot. The systemd-bless-boot.service\nunit invokes this command.\n"
                },
                {
                    "name": "bad",
                    "content": "When called the 'tries left' counter in the boot loader entry file name or unified kernel\nimage file name is set to zero, marking the boot loader entry or kernel image as \"bad\",\nso that the boot loader won't consider it anymore on future boots (at least as long as\nthere are other entries available that are not marked \"bad\" yet). This command is\nnormally not executed, but can be used to instantly put an end to the boot counting logic\nif a problem is detected and persistently mark the boot entry as bad.\n"
                },
                {
                    "name": "indeterminate",
                    "content": "This command undoes any marking of the current boot loader entry file or unified kernel\nimage file as good or bad. This is implemented by renaming the boot loader entry file or\nunified kernel image file back to the path encoded in the LoaderBootCountPath EFI\nvariable.\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"
                }
            ]
        },
        "SEE ALSO": {
            "content": "systemd(1), systemd-boot(7), systemd.special(7)\n",
            "subsections": []
        },
        "NOTES": {
            "content": "1. Boot Loader Specification\nhttps://systemd.io/BOOTLOADERSPECIFICATION\n\n\n\nsystemd 249                                                            SYSTEMD-BLESS-BOOT.SERVICE(8)",
            "subsections": []
        }
    },
    "summary": "systemd-bless-boot.service, systemd-bless-boot - Mark current boot process as successful",
    "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-boot",
            "section": "7",
            "url": "https://www.chedong.com/phpMan.php/man/systemd-boot/7/json"
        },
        {
            "name": "systemd.special",
            "section": "7",
            "url": "https://www.chedong.com/phpMan.php/man/systemd.special/7/json"
        }
    ]
}