systemd-bless-boot.service(8) — Linux manual page



NAME         top

       systemd-bless-boot.service, systemd-bless-boot - Mark current boot
       process as successful

SYNOPSIS         top



DESCRIPTION         top

       systemd-bless-boot.service is a system service that marks the current
       boot process as successful. It's automatically pulled into the
       initial transaction when systemd-bless-boot-generator(8) detects that
       systemd-boot(7) style boot counting is used.

       Internally, the service operates based on the LoaderBootCountPath EFI
       variable (of the vendor UUID 4a67b082-0a4c-41cf-b6c7-440b29bb8c4),
       which is passed from the boot loader to the OS. It contains a file
       system path (relative to the EFI system partition) of the Boot Loader
       Specification[1] compliant boot loader entry file or unified kernel
       image file that was used to boot up the system.
       systemd-bless-boot.service removes the two 'tries done' and 'tries
       left' numeric boot counters from the filename, which indicates to
       future invocations of the boot loader that the entry has completed
       booting successfully at least once. (This service will hence rename
       the boot loader entry file or unified kernel image file on the first
       successful boot.)

OPTIONS         top

       The /usr/lib/systemd/system-bless-boot executable may also be invoked
       from the command line, taking one of the following command arguments:

           The current status of the boot loader entry file or unified
           kernel image file is shown. This outputs one of "good", "bad",
           "indeterminate", "clean", depending on the state and previous
           invocations of the command. The string "indeterminate" is shown
           initially after boot, before it has been marked as "good" or
           "bad". The string "good" is shown after the boot was marked as
           "good" with the good command below, and "bad" conversely after
           the bad command was invoked. The string "clean" is returned when
           boot counting is currently not in effect.

           This command is implied if no command argument is specified.

           When invoked, the current boot loader entry file or unified
           kernel image file will be marked as "good", executing the file
           rename operation described above. This command is intended to be
           invoked at the end of a successful boot. The
           systemd-bless-boot.service unit invokes this command.

           When called the 'tries left' counter in the boot loader entry
           file name or unified kernel image file name is set to zero,
           marking the boot loader entry or kernel image as "bad", so that
           the boot loader won't consider it anymore on future boots (at
           least as long as there are other entries available that are not
           marked "bad" yet). This command is normally not executed, but can
           be used to instantly put an end to the boot counting logic if a
           problem is detected and persistently mark the boot entry as bad.

           This command undoes any marking of the current boot loader entry
           file or unified kernel image file as good or bad. This is
           implemented by renaming the boot loader entry file or unified
           kernel image file back to the path encoded in the
           LoaderBootCountPath EFI variable.

       -h, --help
           Print a short help text and exit.

           Print a short version string and exit.

SEE ALSO         top

       systemd(1), systemd-boot(7), systemd.special(7)

NOTES         top

        1. Boot Loader Specification

COLOPHON         top

       This page is part of the systemd (systemd system and service manager)
       project.  Information about the project can be found at 
       ⟨⟩.  If you have a bug
       report for this manual page, see
       ⟨⟩.  This
       page was obtained from the project's upstream Git repository
       ⟨⟩ on 2020-08-13.  (At that
       time, the date of the most recent commit that was found in the repos‐
       itory was 2020-08-11.)  If you discover any rendering problems in
       this HTML version of the page, or you believe there is a better or
       more up-to-date source for the page, or you have corrections or
       improvements to the information in this COLOPHON (which is not part
       of the original manual page), send a mail to

systemd 246                                    SYSTEMD-BLESS-BOOT.SERVICE(8)

Pages that refer to this page: 30-systemd-environment-d-generator(7)sd-boot(7)systemd-boot(7)systemd.directives(7)systemd.index(7)systemd.special(7)systemd-bless-boot-generator(8)