{
    "mode": "info",
    "parameter": "SYSTEMD-BLESS-BOOT.SERVICE",
    "section": "",
    "url": "https://www.chedong.com/phpMan.php/info/SYSTEMD-BLESS-BOOT.SERVICE/json",
    "generated": "2026-07-05T13:20:52Z",
    "synopsis": "systemd-bless-boot.service\n/lib/systemd/system-bless-boot",
    "sections": {
        "NAME": {
            "content": "systemd-bless-boot.service, systemd-bless-boot - Mark current boot\nprocess 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\nboot process as successful. It's automatically pulled into the initial\ntransaction when systemd-bless-boot-generator(8) detects that systemd-\nboot(7) style boot counting is used.\n\nInternally, the service operates based on the LoaderBootCountPath EFI\nvariable (of the vendor UUID 4a67b082-0a4c-41cf-b6c7-440b29bb8c4),\nwhich is passed from the boot loader to the OS. It contains a file\nsystem path (relative to the EFI system partition) of the Boot Loader\nSpecification[1] compliant boot loader entry file or unified kernel\nimage file that was used to boot up the system.\nsystemd-bless-boot.service removes the two 'tries done' and 'tries\nleft' numeric boot counters from the filename, which indicates to\nfuture invocations of the boot loader that the entry has completed\nbooting successfully at least once. (This service will hence rename the\nboot 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\nthe command line, taking one of the following command arguments:\n\nstatus\nThe current status of the boot loader entry file or unified kernel\nimage file is shown. This outputs one of \"good\", \"bad\",\n\"indeterminate\", \"clean\", depending on the state and previous\ninvocations of the command. The string \"indeterminate\" is shown\ninitially after boot, before it has been marked as \"good\" or \"bad\".\nThe string \"good\" is shown after the boot was marked as \"good\" with\nthe good command below, and \"bad\" conversely after the bad command\nwas invoked. The string \"clean\" is returned when boot counting is\ncurrently not in effect.\n\nThis command is implied if no command argument is specified.\n\ngood\nWhen invoked, the current boot loader entry file or unified kernel\nimage file will be marked as \"good\", executing the file rename\noperation described above. This command is intended to be invoked\nat the end of a successful boot. The systemd-bless-boot.service\nunit invokes this command.\n\nbad\nWhen called the 'tries left' counter in the boot loader entry file\nname or unified kernel image file name is set to zero, marking the\nboot loader entry or kernel image as \"bad\", so that the boot loader\nwon't consider it anymore on future boots (at least as long as\nthere are other entries available that are not marked \"bad\" yet).\nThis command is normally not executed, but can be used to instantly\nput an end to the boot counting logic if a problem is detected and\npersistently mark the boot entry as bad.\n\nindeterminate\nThis command undoes any marking of the current boot loader entry\nfile or unified kernel image file as good or bad. This is\nimplemented by renaming the boot loader entry file or unified\nkernel image file back to the path encoded in the\nLoaderBootCountPath EFI variable.\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"
                }
            ]
        },
        "SEE ALSO": {
            "content": "systemd(1), systemd-boot(7), systemd.special(7)\n",
            "subsections": []
        },
        "NOTES": {
            "content": "1. Boot Loader Specification\nhttps://systemd.io/BOOTLOADERSPECIFICATION\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"
        }
    ]
}