On Apache
Under GNU General Public License
2024-12-12 19:54 @3.15.140.0 CrawledBy Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)
SYSTEMD-BLESS-BOOT.SERVICE(8) systemd-bless-boot.service SYSTEMD-BLESS-BOOT.SERVICE(8)
NAME
systemd-bless-boot.service, systemd-bless-boot - Mark current boot process as successful
SYNOPSIS
systemd-bless-boot.service
/lib/systemd/system-bless-boot
DESCRIPTION
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
The /lib/systemd/system-bless-boot executable may also be invoked from the command line,
taking one of the following command arguments:
status
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.
good
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.
bad
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.
indeterminate
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.
--version
Print a short version string and exit.
SEE ALSO
systemd(1), systemd-boot(7), systemd.special(7)
NOTES
1. Boot Loader Specification
https://systemd.io/BOOT_LOADER_SPECIFICATION
systemd 249 SYSTEMD-BLESS-BOOT.SERVICE(8)
Generated by $Id: phpMan.php,v 4.55 2007/09/05 04:42:51 chedong Exp $ Author: Che Dong
On Apache
Under GNU General Public License
2024-12-12 19:54 @3.15.140.0 CrawledBy Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)