1SYSTEMD-BLESS-BOOT.SERVICE(s8y)stemd-bless-boot.serviScYeSTEMD-BLESS-BOOT.SERVICE(8)
2
6 systemd-bless-boot.service, systemd-bless-boot - Mark current boot
7 process as successful
8
10 systemd-bless-boot.service
11 /usr/lib/systemd/systemd-bless-boot
13
15 systemd-bless-boot.service is a system service that marks the current
16 boot process as successful. It's automatically pulled into the initial
17 transaction when systemd-bless-boot-generator(8) detects that systemd-
18 boot(7) style boot counting is used.
19 Internally, the service operates based on the LoaderBootCountPath EFI
21 variable (of the vendor UUID 4a67b082-0a4c-41cf-b6c7-440b29bb8c4),
22 which is passed from the boot loader to the OS. It contains a file
23 system path (relative to the EFI system partition) of the Boot Loader
24 Specification[1] compliant boot loader entry file or unified kernel
25 image file that was used to boot up the system.
26 systemd-bless-boot.service removes the two 'tries done' and 'tries
27 left' numeric boot counters from the filename, which indicates to
28 future invocations of the boot loader that the entry has completed
29 booting successfully at least once. (This service will hence rename the
30 boot loader entry file or unified kernel image file on the first
31 successful boot.)
32
34 The /usr/lib/systemd/systemd-bless-boot executable may also be invoked
35 from the command line, taking one of the following command arguments:
36 status
38 The current status of the boot loader entry file or unified kernel
39 image file is shown. This outputs one of "good", "bad",
40 "indeterminate", "clean", depending on the state and previous
41 invocations of the command. The string "indeterminate" is shown
42 initially after boot, before it has been marked as "good" or "bad".
43 The string "good" is shown after the boot was marked as "good" with
44 the good command below, and "bad" conversely after the bad command
45 was invoked. The string "clean" is returned when boot counting is
46 currently not in effect.
47 This command is implied if no command argument is specified.
49 good
51 When invoked, the current boot loader entry file or unified kernel
52 image file will be marked as "good", executing the file rename
53 operation described above. This command is intended to be invoked
54 at the end of a successful boot. The systemd-bless-boot.service
55 unit invokes this command.
56 bad
58 When called the 'tries left' counter in the boot loader entry file
59 name or unified kernel image file name is set to zero, marking the
60 boot loader entry or kernel image as "bad", so that the boot loader
61 won't consider it anymore on future boots (at least as long as
62 there are other entries available that are not marked "bad" yet).
63 This command is normally not executed, but can be used to instantly
64 put an end to the boot counting logic if a problem is detected and
65 persistently mark the boot entry as bad.
66 indeterminate
68 This command undoes any marking of the current boot loader entry
69 file or unified kernel image file as good or bad. This is
70 implemented by renaming the boot loader entry file or unified
71 kernel image file back to the path encoded in the
72 LoaderBootCountPath EFI variable.
73 -h, --help
75 Print a short help text and exit.
76 --version
78 Print a short version string and exit.
79
81 systemd(1), systemd-boot(7), systemd.special(7)
82
84 1. Boot Loader Specification
85 https://uapi-group.org/specifications/specs/boot_loader_specification
86systemd 253 SYSTEMD-BLESS-BOOT.SERVICE(8)