1SYSTEMD-BLESS-BOOT.SERVICE(s8y)stemd-bless-boot.serviScYeSTEMD-BLESS-BOOT.SERVICE(8)
2
3
4

NAME

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

SYNOPSIS

10       systemd-bless-boot.service
11
12       /usr/lib/systemd/system-bless-boot
13

DESCRIPTION

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
20       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

OPTIONS

34       The /usr/lib/systemd/system-bless-boot executable may also be invoked
35       from the command line, taking one of the following command arguments:
36
37       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
48           This command is implied if no command argument is specified.
49
50       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
57       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
67       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
74       -h, --help
75           Print a short help text and exit.
76
77       --version
78           Print a short version string and exit.
79

SEE ALSO

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

NOTES

84        1. Boot Loader Specification
85           https://systemd.io/BOOT_LOADER_SPECIFICATION
86
87
88
89systemd 248                                      SYSTEMD-BLESS-BOOT.SERVICE(8)
Impressum