1 /* SPDX-License-Identifier: LGPL-2.1+ */
10 #include <linux/magic.h>
17 #include <sys/statfs.h>
22 #include "alloc-util.h"
23 #include "blkid-util.h"
26 #include "dirent-util.h"
33 #include "locale-util.h"
34 #include "main-func.h"
36 #include "parse-util.h"
37 #include "pretty-print.h"
38 #include "random-util.h"
40 #include "stat-util.h"
41 #include "stdio-util.h"
42 #include "string-util.h"
44 #include "terminal-util.h"
45 #include "tmpfile-util.h"
46 #include "umask-util.h"
52 static char *arg_esp_path
= NULL
;
53 static char *arg_xbootldr_path
= NULL
;
54 static bool arg_print_esp_path
= false;
55 static bool arg_print_dollar_boot_path
= false;
56 static bool arg_touch_variables
= true;
57 static PagerFlags arg_pager_flags
= 0;
59 STATIC_DESTRUCTOR_REGISTER(arg_esp_path
, freep
);
60 STATIC_DESTRUCTOR_REGISTER(arg_xbootldr_path
, freep
);
62 static const char *arg_dollar_boot_path(void) {
63 /* $BOOT shall be the XBOOTLDR partition if it exists, and otherwise the ESP */
64 return arg_xbootldr_path
?: arg_esp_path
;
67 static int acquire_esp(
68 bool unprivileged_mode
,
72 sd_id128_t
*ret_uuid
) {
77 /* Find the ESP, and log about errors. Note that find_esp_and_warn() will log in all error cases on
78 * its own, except for ENOKEY (which is good, we want to show our own message in that case,
79 * suggesting use of --esp-path=) and EACCESS (only when we request unprivileged mode; in this case
80 * we simply eat up the error here, so that --list and --status work too, without noise about
83 r
= find_esp_and_warn(arg_esp_path
, unprivileged_mode
, &np
, ret_part
, ret_pstart
, ret_psize
, ret_uuid
);
85 return log_error_errno(r
,
86 "Couldn't find EFI system partition. It is recommended to mount it to /boot or /efi.\n"
87 "Alternatively, use --esp-path= to specify path to mount point.");
91 free_and_replace(arg_esp_path
, np
);
92 log_debug("Using EFI System Partition at %s.", arg_esp_path
);
97 static int acquire_xbootldr(bool unprivileged_mode
, sd_id128_t
*ret_uuid
) {
101 r
= find_xbootldr_and_warn(arg_xbootldr_path
, unprivileged_mode
, &np
, ret_uuid
);
103 log_debug_errno(r
, "Didn't find an XBOOTLDR partition, using the ESP as $BOOT.");
105 *ret_uuid
= SD_ID128_NULL
;
106 arg_xbootldr_path
= mfree(arg_xbootldr_path
);
112 free_and_replace(arg_xbootldr_path
, np
);
113 log_debug("Using XBOOTLDR partition at %s as $BOOT.", arg_xbootldr_path
);
118 /* search for "#### LoaderInfo: systemd-boot 218 ####" string inside the binary */
119 static int get_file_version(int fd
, char **v
) {
129 if (fstat(fd
, &st
) < 0)
130 return log_error_errno(errno
, "Failed to stat EFI binary: %m");
132 r
= stat_verify_regular(&st
);
134 return log_error_errno(r
, "EFI binary is not a regular file: %m");
136 if (st
.st_size
< 27) {
141 buf
= mmap(NULL
, st
.st_size
, PROT_READ
, MAP_PRIVATE
, fd
, 0);
142 if (buf
== MAP_FAILED
)
143 return log_error_errno(errno
, "Failed to memory map EFI binary: %m");
145 s
= memmem(buf
, st
.st_size
- 8, "#### LoaderInfo: ", 17);
150 e
= memmem(s
, st
.st_size
- (s
- buf
), " ####", 5);
151 if (!e
|| e
- s
< 3) {
152 r
= log_error_errno(SYNTHETIC_ERRNO(EINVAL
), "Malformed version string.");
156 x
= strndup(s
, e
- s
);
164 (void) munmap(buf
, st
.st_size
);
169 static int enumerate_binaries(const char *esp_path
, const char *path
, const char *prefix
) {
170 _cleanup_closedir_
DIR *d
= NULL
;
178 p
= prefix_roota(esp_path
, path
);
184 return log_error_errno(errno
, "Failed to read \"%s\": %m", p
);
187 FOREACH_DIRENT(de
, d
, break) {
188 _cleanup_free_
char *v
= NULL
;
189 _cleanup_close_
int fd
= -1;
191 if (!endswith_no_case(de
->d_name
, ".efi"))
194 if (prefix
&& !startswith_no_case(de
->d_name
, prefix
))
197 fd
= openat(dirfd(d
), de
->d_name
, O_RDONLY
|O_CLOEXEC
);
199 return log_error_errno(errno
, "Failed to open \"%s/%s\" for reading: %m", p
, de
->d_name
);
201 r
= get_file_version(fd
, &v
);
205 printf(" File: %s/%s/%s (%s%s%s)\n", special_glyph(SPECIAL_GLYPH_TREE_RIGHT
), path
, de
->d_name
, ansi_highlight(), v
, ansi_normal());
207 printf(" File: %s/%s/%s\n", special_glyph(SPECIAL_GLYPH_TREE_RIGHT
), path
, de
->d_name
);
215 static int status_binaries(const char *esp_path
, sd_id128_t partition
) {
218 printf("Available Boot Loaders on ESP:\n");
221 printf(" ESP: Cannot find or access mount point of ESP.\n\n");
225 printf(" ESP: %s", esp_path
);
226 if (!sd_id128_is_null(partition
))
227 printf(" (/dev/disk/by-partuuid/" SD_ID128_UUID_FORMAT_STR
")", SD_ID128_FORMAT_VAL(partition
));
230 r
= enumerate_binaries(esp_path
, "EFI/systemd", NULL
);
234 log_info("systemd-boot not installed in ESP.");
236 r
= enumerate_binaries(esp_path
, "EFI/BOOT", "boot");
240 log_info("No default/fallback boot loader installed in ESP.");
249 static int print_efi_option(uint16_t id
, bool in_order
) {
250 _cleanup_free_
char *title
= NULL
;
251 _cleanup_free_
char *path
= NULL
;
252 sd_id128_t partition
;
256 r
= efi_get_boot_option(id
, &title
, &partition
, &path
, &active
);
260 /* print only configured entries with partition information */
261 if (!path
|| sd_id128_is_null(partition
))
264 efi_tilt_backslashes(path
);
266 printf(" Title: %s%s%s\n", ansi_highlight(), strna(title
), ansi_normal());
267 printf(" ID: 0x%04X\n", id
);
268 printf(" Status: %sactive%s\n", active
? "" : "in", in_order
? ", boot-order" : "");
269 printf(" Partition: /dev/disk/by-partuuid/" SD_ID128_UUID_FORMAT_STR
"\n",
270 SD_ID128_FORMAT_VAL(partition
));
271 printf(" File: %s%s\n", special_glyph(SPECIAL_GLYPH_TREE_RIGHT
), path
);
277 static int status_variables(void) {
278 _cleanup_free_
uint16_t *options
= NULL
, *order
= NULL
;
279 int n_options
, n_order
, i
;
281 n_options
= efi_get_boot_options(&options
);
282 if (n_options
== -ENOENT
)
283 return log_error_errno(n_options
,
284 "Failed to access EFI variables, efivarfs"
285 " needs to be available at /sys/firmware/efi/efivars/.");
287 return log_error_errno(n_options
, "Failed to read EFI boot entries: %m");
289 n_order
= efi_get_boot_order(&order
);
290 if (n_order
== -ENOENT
)
292 else if (n_order
< 0)
293 return log_error_errno(n_order
, "Failed to read EFI boot order: %m");
295 /* print entries in BootOrder first */
296 printf("Boot Loaders Listed in EFI Variables:\n");
297 for (i
= 0; i
< n_order
; i
++)
298 print_efi_option(order
[i
], true);
300 /* print remaining entries */
301 for (i
= 0; i
< n_options
; i
++) {
304 for (j
= 0; j
< n_order
; j
++)
305 if (options
[i
] == order
[j
])
308 print_efi_option(options
[i
], false);
317 static int boot_entry_file_check(const char *root
, const char *p
) {
318 _cleanup_free_
char *path
;
320 path
= path_join(root
, p
);
324 if (access(path
, F_OK
) < 0)
330 static void boot_entry_file_list(const char *field
, const char *root
, const char *p
, int *ret_status
) {
331 int status
= boot_entry_file_check(root
, p
);
333 printf("%13s%s ", strempty(field
), field
? ":" : " ");
336 printf("%s%s%s (%m)\n", ansi_highlight_red(), p
, ansi_normal());
340 if (*ret_status
== 0 && status
< 0)
341 *ret_status
= status
;
344 static int boot_entry_show(const BootEntry
*e
, bool show_as_default
) {
347 /* Returns 0 on success, negative on processing error, and positive if something is wrong with the
348 boot entry itself. */
352 printf(" title: %s%s%s" "%s%s%s\n",
353 ansi_highlight(), boot_entry_title(e
), ansi_normal(),
354 ansi_highlight_green(), show_as_default
? " (default)" : "", ansi_normal());
357 printf(" id: %s\n", e
->id
);
359 _cleanup_free_
char *link
= NULL
;
361 /* Let's urlify the link to make it easy to view in an editor, but only if it is a text
362 * file. Unified images are binary ELFs, and EFI variables are not pure text either. */
363 if (e
->type
== BOOT_ENTRY_CONF
)
364 (void) terminal_urlify_path(e
->path
, NULL
, &link
);
366 printf(" source: %s\n", link
?: e
->path
);
369 printf(" version: %s\n", e
->version
);
371 printf(" machine-id: %s\n", e
->machine_id
);
373 printf(" architecture: %s\n", e
->architecture
);
375 boot_entry_file_list("linux", e
->root
, e
->kernel
, &status
);
378 STRV_FOREACH(s
, e
->initrd
)
379 boot_entry_file_list(s
== e
->initrd
? "initrd" : NULL
,
383 if (!strv_isempty(e
->options
)) {
384 _cleanup_free_
char *t
= NULL
, *t2
= NULL
;
385 _cleanup_strv_free_
char **ts
= NULL
;
387 t
= strv_join(e
->options
, " ");
391 ts
= strv_split_newlines(t
);
395 t2
= strv_join(ts
, "\n ");
399 printf(" options: %s\n", t2
);
402 boot_entry_file_list("devicetree", e
->root
, e
->device_tree
, &status
);
407 static int status_entries(
408 const char *esp_path
,
409 sd_id128_t esp_partition_uuid
,
410 const char *xbootldr_path
,
411 sd_id128_t xbootldr_partition_uuid
) {
413 _cleanup_(boot_config_free
) BootConfig config
= {};
414 sd_id128_t dollar_boot_partition_uuid
;
415 const char *dollar_boot_path
;
418 assert(esp_path
|| xbootldr_path
);
421 dollar_boot_path
= xbootldr_path
;
422 dollar_boot_partition_uuid
= xbootldr_partition_uuid
;
424 dollar_boot_path
= esp_path
;
425 dollar_boot_partition_uuid
= esp_partition_uuid
;
428 printf("Boot Loader Entries:\n"
429 " $BOOT: %s", dollar_boot_path
);
430 if (!sd_id128_is_null(dollar_boot_partition_uuid
))
431 printf(" (/dev/disk/by-partuuid/" SD_ID128_UUID_FORMAT_STR
")",
432 SD_ID128_FORMAT_VAL(dollar_boot_partition_uuid
));
435 r
= boot_entries_load_config(esp_path
, xbootldr_path
, &config
);
439 if (config
.default_entry
< 0)
440 printf("%zu entries, no entry could be determined as default.\n", config
.n_entries
);
442 printf("Default Boot Loader Entry:\n");
444 r
= boot_entry_show(config
.entries
+ config
.default_entry
, false);
446 /* < 0 is already logged by the function itself, let's just emit an extra warning if
447 the default entry is broken */
448 printf("\nWARNING: default boot entry is broken\n");
454 static int compare_product(const char *a
, const char *b
) {
463 return x
< y
? -1 : x
> y
? 1 : 0;
465 return strncmp(a
, b
, x
);
468 static int compare_version(const char *a
, const char *b
) {
472 a
+= strcspn(a
, " ");
474 b
+= strcspn(b
, " ");
477 return strverscmp(a
, b
);
480 static int version_check(int fd_from
, const char *from
, int fd_to
, const char *to
) {
481 _cleanup_free_
char *a
= NULL
, *b
= NULL
;
484 assert(fd_from
>= 0);
489 r
= get_file_version(fd_from
, &a
);
493 return log_error_errno(SYNTHETIC_ERRNO(EINVAL
),
494 "Source file \"%s\" does not carry version information!",
497 r
= get_file_version(fd_to
, &b
);
500 if (r
== 0 || compare_product(a
, b
) != 0)
501 return log_notice_errno(SYNTHETIC_ERRNO(EEXIST
),
502 "Skipping \"%s\", since it's owned by another boot loader.",
505 if (compare_version(a
, b
) < 0)
506 return log_warning_errno(SYNTHETIC_ERRNO(ESTALE
), "Skipping \"%s\", since a newer boot loader version exists already.", to
);
511 static int copy_file_with_version_check(const char *from
, const char *to
, bool force
) {
512 _cleanup_close_
int fd_from
= -1, fd_to
= -1;
513 _cleanup_free_
char *t
= NULL
;
516 fd_from
= open(from
, O_RDONLY
|O_CLOEXEC
|O_NOCTTY
);
518 return log_error_errno(errno
, "Failed to open \"%s\" for reading: %m", from
);
521 fd_to
= open(to
, O_RDONLY
|O_CLOEXEC
|O_NOCTTY
);
523 if (errno
!= -ENOENT
)
524 return log_error_errno(errno
, "Failed to open \"%s\" for reading: %m", to
);
526 r
= version_check(fd_from
, from
, fd_to
, to
);
530 if (lseek(fd_from
, 0, SEEK_SET
) == (off_t
) -1)
531 return log_error_errno(errno
, "Failed to seek in \"%s\": %m", from
);
533 fd_to
= safe_close(fd_to
);
537 r
= tempfn_random(to
, NULL
, &t
);
541 RUN_WITH_UMASK(0000) {
542 fd_to
= open(t
, O_WRONLY
|O_CREAT
|O_CLOEXEC
|O_EXCL
|O_NOFOLLOW
, 0644);
544 return log_error_errno(errno
, "Failed to open \"%s\" for writing: %m", t
);
547 r
= copy_bytes(fd_from
, fd_to
, (uint64_t) -1, COPY_REFLINK
);
550 return log_error_errno(r
, "Failed to copy data from \"%s\" to \"%s\": %m", from
, t
);
553 (void) copy_times(fd_from
, fd_to
, 0);
555 if (fsync(fd_to
) < 0) {
556 (void) unlink_noerrno(t
);
557 return log_error_errno(errno
, "Failed to copy data from \"%s\" to \"%s\": %m", from
, t
);
560 (void) fsync_directory_of_file(fd_to
);
562 if (renameat(AT_FDCWD
, t
, AT_FDCWD
, to
) < 0) {
563 (void) unlink_noerrno(t
);
564 return log_error_errno(errno
, "Failed to rename \"%s\" to \"%s\": %m", t
, to
);
567 log_info("Copied \"%s\" to \"%s\".", from
, to
);
572 static int mkdir_one(const char *prefix
, const char *suffix
) {
573 _cleanup_free_
char *p
= NULL
;
575 p
= path_join(prefix
, suffix
);
576 if (mkdir(p
, 0700) < 0) {
578 return log_error_errno(errno
, "Failed to create \"%s\": %m", p
);
580 log_info("Created \"%s\".", p
);
585 static const char *const esp_subdirs
[] = {
586 /* The directories to place in the ESP */
594 static const char *const dollar_boot_subdirs
[] = {
595 /* The directories to place in the XBOOTLDR partition or the ESP, depending what exists */
597 "loader/entries", /* Type #1 entries */
599 "EFI/Linux", /* Type #2 entries */
603 static int create_subdirs(const char *root
, const char * const *subdirs
) {
604 const char *const *i
;
607 STRV_FOREACH(i
, subdirs
) {
608 r
= mkdir_one(root
, *i
);
616 static int copy_one_file(const char *esp_path
, const char *name
, bool force
) {
621 p
= strjoina(BOOTLIBDIR
"/", name
);
622 q
= strjoina(esp_path
, "/EFI/systemd/", name
);
623 r
= copy_file_with_version_check(p
, q
, force
);
625 e
= startswith(name
, "systemd-boot");
630 /* Create the EFI default boot loader name (specified for removable devices) */
631 v
= strjoina(esp_path
, "/EFI/BOOT/BOOT", e
);
632 ascii_strupper(strrchr(v
, '/') + 1);
634 k
= copy_file_with_version_check(p
, v
, force
);
642 static int install_binaries(const char *esp_path
, bool force
) {
644 _cleanup_closedir_
DIR *d
= NULL
;
647 d
= opendir(BOOTLIBDIR
);
649 return log_error_errno(errno
, "Failed to open \""BOOTLIBDIR
"\": %m
");
651 FOREACH_DIRENT(de, d, return log_error_errno(errno, "Failed to read
\""BOOTLIBDIR"\": %m
")) {
654 if (!endswith_no_case(de->d_name, ".efi
"))
657 k = copy_one_file(esp_path, de->d_name, force);
665 static bool same_entry(uint16_t id, sd_id128_t uuid, const char *path) {
666 _cleanup_free_ char *opath = NULL;
670 r = efi_get_boot_option(id, NULL, &ouuid, &opath, NULL);
673 if (!sd_id128_equal(uuid, ouuid))
675 if (!streq_ptr(path, opath))
681 static int find_slot(sd_id128_t uuid, const char *path, uint16_t *id) {
682 _cleanup_free_ uint16_t *options = NULL;
685 n = efi_get_boot_options(&options);
689 /* find already existing systemd-boot entry */
690 for (i = 0; i < n; i++)
691 if (same_entry(options[i], uuid, path)) {
696 /* find free slot in the sorted BootXXXX variable list */
697 for (i = 0; i < n; i++)
698 if (i != options[i]) {
703 /* use the next one */
710 static int insert_into_order(uint16_t slot, bool first) {
711 _cleanup_free_ uint16_t *order = NULL;
715 n = efi_get_boot_order(&order);
717 /* no entry, add us */
718 return efi_set_boot_order(&slot, 1);
720 /* are we the first and only one? */
721 if (n == 1 && order[0] == slot)
724 /* are we already in the boot order? */
725 for (i = 0; i < n; i++) {
726 if (order[i] != slot)
729 /* we do not require to be the first one, all is fine */
733 /* move us to the first slot */
734 memmove(order + 1, order, i * sizeof(uint16_t));
736 return efi_set_boot_order(order, n);
740 t = reallocarray(order, n + 1, sizeof(uint16_t));
745 /* add us to the top or end of the list */
747 memmove(order + 1, order, n * sizeof(uint16_t));
752 return efi_set_boot_order(order, n + 1);
755 static int remove_from_order(uint16_t slot) {
756 _cleanup_free_ uint16_t *order = NULL;
759 n = efi_get_boot_order(&order);
763 for (i = 0; i < n; i++) {
764 if (order[i] != slot)
768 memmove(order + i, order + i+1, (n - i) * sizeof(uint16_t));
769 return efi_set_boot_order(order, n - 1);
775 static int install_variables(const char *esp_path,
776 uint32_t part, uint64_t pstart, uint64_t psize,
777 sd_id128_t uuid, const char *path,
783 if (!is_efi_boot()) {
784 log_warning("Not booted with EFI
, skipping EFI variable setup
.");
788 p = prefix_roota(esp_path, path);
789 if (access(p, F_OK) < 0) {
793 return log_error_errno(errno, "Cannot access
\"%s
\": %m
", p);
796 r = find_slot(uuid, path, &slot);
798 return log_error_errno(r,
800 "Failed to access EFI variables
. Is the
\"efivarfs
\" filesystem mounted
?" :
801 "Failed to determine current boot order
: %m
");
803 if (first || r == 0) {
804 r = efi_add_boot_option(slot, "Linux Boot Manager
",
808 return log_error_errno(r, "Failed to create EFI Boot variable entry
: %m
");
810 log_info("Created EFI boot entry
\"Linux Boot Manager
\".");
813 return insert_into_order(slot, first);
816 static int remove_boot_efi(const char *esp_path) {
817 _cleanup_closedir_ DIR *d = NULL;
822 p = prefix_roota(esp_path, "/EFI
/BOOT
");
828 return log_error_errno(errno, "Failed to open directory
\"%s
\": %m
", p);
831 FOREACH_DIRENT(de, d, break) {
832 _cleanup_close_ int fd = -1;
833 _cleanup_free_ char *v = NULL;
835 if (!endswith_no_case(de->d_name, ".efi
"))
838 if (!startswith_no_case(de->d_name, "boot
"))
841 fd = openat(dirfd(d), de->d_name, O_RDONLY|O_CLOEXEC);
843 return log_error_errno(errno, "Failed to open
\"%s
/%s
\" for reading
: %m
", p, de->d_name);
845 r = get_file_version(fd, &v);
848 if (r > 0 && startswith(v, "systemd
-boot
")) {
849 r = unlinkat(dirfd(d), de->d_name, 0);
851 return log_error_errno(errno, "Failed to remove
\"%s
/%s
\": %m
", p, de->d_name);
853 log_info("Removed
\"%s
/%s
\".", p, de->d_name);
862 static int rmdir_one(const char *prefix, const char *suffix) {
865 p = prefix_roota(prefix, suffix);
867 bool ignore = IN_SET(errno, ENOENT, ENOTEMPTY);
869 log_full_errno(ignore ? LOG_DEBUG : LOG_ERR, errno,
870 "Failed to remove directory
\"%s
\": %m
", p);
874 log_info("Removed
\"%s
\".", p);
879 static int remove_subdirs(const char *root, const char *const *subdirs) {
882 /* We use recursion here to destroy the directories in reverse order. Which should be safe given how
883 * short the array is. */
885 if (!subdirs[0]) /* A the end of the list */
888 r = remove_subdirs(root, subdirs + 1);
889 q = rmdir_one(root, subdirs[0]);
891 return r < 0 ? r : q;
894 static int remove_machine_id_directory(const char *root, sd_id128_t machine_id) {
895 char buf[SD_ID128_STRING_MAX];
899 return rmdir_one(root, sd_id128_to_string(machine_id, buf));
902 static int remove_binaries(const char *esp_path) {
906 p = prefix_roota(esp_path, "/EFI
/systemd
");
907 r = rm_rf(p, REMOVE_ROOT|REMOVE_PHYSICAL);
909 q = remove_boot_efi(esp_path);
916 static int remove_file(const char *root, const char *file) {
922 p = prefix_roota(root, file);
924 log_full_errno(errno == ENOENT ? LOG_DEBUG : LOG_ERR, errno,
925 "Failed to unlink file
\"%s
\": %m
", p);
927 return errno == ENOENT ? 0 : -errno;
930 log_info("Removed
\"%s
\".", p);
934 static int remove_variables(sd_id128_t uuid, const char *path, bool in_order) {
941 r = find_slot(uuid, path, &slot);
945 r = efi_remove_boot_option(slot);
950 return remove_from_order(slot);
955 static int remove_loader_variables(void) {
959 /* Remove all persistent loader variables we define */
962 "LoaderConfigTimeout
",
963 "LoaderConfigTimeoutOneShot
",
964 "LoaderEntryDefault
",
965 "LoaderEntryOneShot
",
966 "LoaderSystemToken
") {
970 q = efi_set_variable(EFI_VENDOR_LOADER, p, NULL, 0);
974 log_warning_errno(q, "Failed to remove
%s variable
: %m
", p);
978 log_info("Removed EFI variable
%s
.", p);
984 static int install_loader_config(const char *esp_path, sd_id128_t machine_id) {
985 char machine_string[SD_ID128_STRING_MAX];
986 _cleanup_(unlink_and_freep) char *t = NULL;
987 _cleanup_fclose_ FILE *f = NULL;
991 p = prefix_roota(esp_path, "/loader
/loader
.conf
");
992 if (access(p, F_OK) >= 0) /* Silently skip creation if the file already exists (early check) */
995 fd = open_tmpfile_linkable(p, O_WRONLY|O_CLOEXEC, &t);
997 return log_error_errno(fd, "Failed to open
\"%s
\" for writing
: %m
", p);
1005 fprintf(f, "#timeout 3\n"
1006 "#console-mode keep\n"
1007 "default %s-*\n", sd_id128_to_string(machine_id, machine_string));
1009 r = fflush_sync_and_check(f);
1011 return log_error_errno(r, "Failed to write \"%s\": %m", p);
1013 r = link_tmpfile(fd, t, p);
1015 return 0; /* Silently skip creation if the file exists now (recheck) */
1017 return log_error_errno(r, "Failed to move \"%s\" into place: %m", p);
1023 static int install_machine_id_directory(const char *root, sd_id128_t machine_id) {
1024 char buf[SD_ID128_STRING_MAX];
1028 return mkdir_one(root, sd_id128_to_string(machine_id, buf));
1031 static int help(int argc, char *argv[], void *userdata) {
1032 _cleanup_free_ char *link = NULL;
1035 r = terminal_urlify_man("bootctl", "1", &link);
1039 printf("%s [COMMAND] [OPTIONS...]\n\n"
1040 "Install, update or remove the systemd-boot EFI boot manager.\n\n"
1041 " -h --help Show this help\n"
1042 " --version Print version\n"
1043 " --esp-path=PATH Path to the EFI System Partition (ESP)\n"
1044 " --boot-path=PATH Path to the $BOOT partition\n"
1045 " -p --print-esp-path Print path to the EFI System Partition\n"
1046 " -x --print-boot-path Print path to the $BOOT partition\n"
1047 " --no-variables Don't touch EFI variables\n"
1048 " --no-pager Do not pipe output into a pager\n"
1049 "\nBoot Loader Commands:\n"
1050 " status Show status of installed systemd-boot and EFI variables\n"
1051 " install Install systemd-boot to the ESP and EFI variables\n"
1052 " update Update systemd-boot in the ESP and EFI variables\n"
1053 " remove Remove systemd-boot from the ESP and EFI variables\n"
1054 " random-seed Initialize random seed in ESP and EFI variables\n"
1055 " is-installed Test whether systemd-boot is installed in the ESP\n"
1056 "\nBoot Loader Entries Commands:\n"
1057 " list List boot loader entries\n"
1058 " set-default ID Set default boot loader entry\n"
1059 " set-oneshot ID Set default boot loader entry, for next boot only\n"
1060 "\nSee the %s for details.\n"
1061 , program_invocation_short_name
1067 static int parse_argv(int argc, char *argv[]) {
1069 ARG_ESP_PATH = 0x100,
1076 static const struct option options[] = {
1077 { "help", no_argument, NULL, 'h' },
1078 { "version", no_argument, NULL, ARG_VERSION },
1079 { "esp-path", required_argument, NULL, ARG_ESP_PATH },
1080 { "path", required_argument, NULL, ARG_ESP_PATH }, /* Compatibility alias */
1081 { "boot-path", required_argument, NULL, ARG_BOOT_PATH },
1082 { "print-esp-path", no_argument, NULL, 'p' },
1083 { "print-path", no_argument, NULL, 'p' }, /* Compatibility alias */
1084 { "print-boot-path", no_argument, NULL, 'x' },
1085 { "no-variables", no_argument, NULL, ARG_NO_VARIABLES },
1086 { "no-pager", no_argument, NULL, ARG_NO_PAGER },
1095 while ((c = getopt_long(argc, argv, "hpx", options, NULL)) >= 0)
1099 help(0, NULL, NULL);
1106 r = free_and_strdup(&arg_esp_path, optarg);
1112 r = free_and_strdup(&arg_xbootldr_path, optarg);
1118 if (arg_print_dollar_boot_path)
1119 return log_error_errno(SYNTHETIC_ERRNO(EINVAL),
1120 "--print-boot-path/-x cannot be combined with --print-esp-path/-p");
1121 arg_print_esp_path = true;
1125 if (arg_print_esp_path)
1126 return log_error_errno(SYNTHETIC_ERRNO(EINVAL),
1127 "--print-boot-path/-x cannot be combined with --print-esp-path/-p");
1128 arg_print_dollar_boot_path = true;
1131 case ARG_NO_VARIABLES:
1132 arg_touch_variables = false;
1136 arg_pager_flags |= PAGER_DISABLE;
1143 assert_not_reached("Unknown option");
1149 static void read_loader_efi_var(const char *name, char **var) {
1152 r = efi_get_variable_string(EFI_VENDOR_LOADER, name, var);
1153 if (r < 0 && r != -ENOENT)
1154 log_warning_errno(r, "Failed to read EFI variable %s: %m", name);
1157 static int verb_status(int argc, char *argv[], void *userdata) {
1158 sd_id128_t esp_uuid = SD_ID128_NULL, xbootldr_uuid = SD_ID128_NULL;
1161 r = acquire_esp(geteuid() != 0, NULL, NULL, NULL, &esp_uuid);
1162 if (arg_print_esp_path) {
1163 if (r == -EACCES) /* If we couldn't acquire the ESP path, log about access errors (which is the only
1164 * error the
find_esp_and_warn() won
't log on its own) */
1165 return log_error_errno(r, "Failed to determine ESP location: %m");
1172 r = acquire_xbootldr(geteuid() != 0, &xbootldr_uuid);
1173 if (arg_print_dollar_boot_path) {
1175 return log_error_errno(r, "Failed to determine XBOOTLDR location: %m");
1179 const char *path = arg_dollar_boot_path();
1181 return log_error_errno(SYNTHETIC_ERRNO(EACCES), "Failed to determine XBOOTLDR location: %m");
1186 if (arg_print_esp_path || arg_print_dollar_boot_path)
1189 r = 0; /* If we couldn't determine the path
, then don
't consider that a problem from here on, just show what we
1192 (void) pager_open(arg_pager_flags);
1194 if (is_efi_boot()) {
1195 static const struct {
1199 { EFI_LOADER_FEATURE_BOOT_COUNTING, "Boot counting" },
1200 { EFI_LOADER_FEATURE_CONFIG_TIMEOUT, "Menu timeout control" },
1201 { EFI_LOADER_FEATURE_CONFIG_TIMEOUT_ONE_SHOT, "One-shot menu timeout control" },
1202 { EFI_LOADER_FEATURE_ENTRY_DEFAULT, "Default entry control" },
1203 { EFI_LOADER_FEATURE_ENTRY_ONESHOT, "One-shot entry control" },
1204 { EFI_LOADER_FEATURE_XBOOTLDR, "Support for XBOOTLDR partition" },
1205 { EFI_LOADER_FEATURE_RANDOM_SEED, "Support for passing random seed to OS" },
1208 _cleanup_free_ char *fw_type = NULL, *fw_info = NULL, *loader = NULL, *loader_path = NULL, *stub = NULL;
1209 sd_id128_t loader_part_uuid = SD_ID128_NULL;
1210 uint64_t loader_features = 0;
1213 read_loader_efi_var("LoaderFirmwareType", &fw_type);
1214 read_loader_efi_var("LoaderFirmwareInfo", &fw_info);
1215 read_loader_efi_var("LoaderInfo", &loader);
1216 read_loader_efi_var("StubInfo", &stub);
1217 read_loader_efi_var("LoaderImageIdentifier", &loader_path);
1218 (void) efi_loader_get_features(&loader_features);
1221 efi_tilt_backslashes(loader_path);
1223 k = efi_loader_get_device_part_uuid(&loader_part_uuid);
1224 if (k < 0 && k != -ENOENT)
1225 r = log_warning_errno(k, "Failed to read EFI variable LoaderDevicePartUUID: %m");
1227 printf("System:\n");
1228 printf(" Firmware: %s%s (%s)%s\n", ansi_highlight(), strna(fw_type), strna(fw_info), ansi_normal());
1229 printf(" Secure Boot: %sd\n", enable_disable(is_efi_secure_boot()));
1230 printf(" Setup Mode: %s\n", is_efi_secure_boot_setup_mode() ? "setup" : "user");
1233 printf("Current Boot Loader:\n");
1234 printf(" Product: %s%s%s\n", ansi_highlight(), strna(loader), ansi_normal());
1236 for (i = 0; i < ELEMENTSOF(flags); i++) {
1239 printf(" Features: ");
1243 if (FLAGS_SET(loader_features, flags[i].flag))
1244 printf("%s%s%s %s\n", ansi_highlight_green(), special_glyph(SPECIAL_GLYPH_CHECK_MARK), ansi_normal(), flags[i].name);
1246 printf("%s%s%s %s\n", ansi_highlight_red(), special_glyph(SPECIAL_GLYPH_CROSS_MARK), ansi_normal(), flags[i].name);
1250 printf(" Stub: %s\n", stub);
1251 if (!sd_id128_is_null(loader_part_uuid))
1252 printf(" ESP: /dev/disk/by-partuuid/" SD_ID128_UUID_FORMAT_STR "\n",
1253 SD_ID128_FORMAT_VAL(loader_part_uuid));
1255 printf(" ESP: n/a\n");
1256 printf(" File: %s%s\n", special_glyph(SPECIAL_GLYPH_TREE_RIGHT), strna(loader_path));
1259 printf("Random Seed:\n");
1260 printf(" Passed to OS: %s\n", yes_no(access("/sys/firmware/efi/efivars/LoaderRandomSeed-4a67b082-0a4c-41cf-b6c7-440b29bb8c4f", F_OK) >= 0));
1261 printf(" System Token: %s\n", access("/sys/firmware/efi/efivars/LoaderSystemToken-4a67b082-0a4c-41cf-b6c7-440b29bb8c4f", F_OK) >= 0 ? "set" : "not set");
1264 _cleanup_free_ char *p = NULL;
1266 p = path_join(arg_esp_path, "/loader/random-seed");
1270 printf(" Exists: %s\n", yes_no(access(p, F_OK) >= 0));
1275 printf("System:\n Not booted with EFI\n\n");
1278 k = status_binaries(arg_esp_path, esp_uuid);
1283 if (is_efi_boot()) {
1284 k = status_variables();
1289 if (arg_esp_path || arg_xbootldr_path) {
1290 k = status_entries(arg_esp_path, esp_uuid, arg_xbootldr_path, xbootldr_uuid);
1298 static int verb_list(int argc, char *argv[], void *userdata) {
1299 _cleanup_(boot_config_free) BootConfig config = {};
1302 /* If we lack privileges we invoke find_esp_and_warn() in "unprivileged mode" here, which does two things: turn
1303 * off logging about access errors and turn off potentially privileged device probing. Here we're interested in
1304 * the latter but
not the former
, hence request the mode
, and log about EACCES
. */
1306 r
= acquire_esp(geteuid() != 0, NULL
, NULL
, NULL
, NULL
);
1307 if (r
== -EACCES
) /* We really need the ESP path for this call, hence also log about access errors */
1308 return log_error_errno(r
, "Failed to determine ESP: %m");
1312 r
= acquire_xbootldr(geteuid() != 0, NULL
);
1314 return log_error_errno(r
, "Failed to determine XBOOTLDR partition: %m");
1318 r
= boot_entries_load_config(arg_esp_path
, arg_xbootldr_path
, &config
);
1322 (void) boot_entries_augment_from_loader(&config
, false);
1324 if (config
.n_entries
== 0)
1325 log_info("No boot loader entries found.");
1329 (void) pager_open(arg_pager_flags
);
1331 printf("Boot Loader Entries:\n");
1333 for (n
= 0; n
< config
.n_entries
; n
++) {
1334 r
= boot_entry_show(config
.entries
+ n
, n
== (size_t) config
.default_entry
);
1338 if (n
+1 < config
.n_entries
)
1346 static int install_random_seed(const char *esp
) {
1347 _cleanup_(unlink_and_freep
) char *tmp
= NULL
;
1348 _cleanup_free_
void *buffer
= NULL
;
1349 _cleanup_free_
char *path
= NULL
;
1350 _cleanup_close_
int fd
= -1;
1351 size_t sz
, token_size
;
1357 path
= path_join(esp
, "/loader/random-seed");
1361 sz
= random_pool_size();
1363 buffer
= malloc(sz
);
1367 r
= genuine_random_bytes(buffer
, sz
, RANDOM_BLOCK
);
1369 return log_error_errno(r
, "Failed to acquire random seed: %m");
1371 r
= tempfn_random(path
, "bootctl", &tmp
);
1375 fd
= open(tmp
, O_CREAT
|O_EXCL
|O_NOFOLLOW
|O_NOCTTY
|O_WRONLY
|O_CLOEXEC
, 0600);
1378 return log_error_errno(fd
, "Failed to open random seed file for writing: %m");
1381 n
= write(fd
, buffer
, sz
);
1383 return log_error_errno(errno
, "Failed to write random seed file: %m");
1384 if ((size_t) n
!= sz
)
1385 return log_error_errno(SYNTHETIC_ERRNO(EIO
), "Short write while writing random seed file.");
1387 if (rename(tmp
, path
) < 0)
1388 return log_error_errno(r
, "Failed to move random seed file into place: %m");
1392 log_info("Random seed file %s successfully written (%zu bytes).", path
, sz
);
1394 if (!arg_touch_variables
)
1397 if (!is_efi_boot()) {
1398 log_notice("Not booted with EFI, skipping EFI variable setup.");
1402 r
= getenv_bool("SYSTEMD_WRITE_SYSTEM_TOKEN");
1405 log_warning_errno(r
, "Failed to parse $SYSTEMD_WRITE_SYSTEM_TOKEN, ignoring.");
1407 if (detect_vm() > 0) {
1408 /* Let's not write a system token if we detect we are running in a VM
1409 * environment. Why? Our default security model for the random seed uses the system
1410 * token as a mechanism to ensure we are not vulnerable to golden master sloppiness
1411 * issues, i.e. that people initialize the random seed file, then copy the image to
1412 * many systems and end up with the same random seed in each that is assumed to be
1413 * valid but in reality is the same for all machines. By storing a system token in
1414 * the EFI variable space we can make sure that even though the random seeds on disk
1415 * are all the same they will be different on each system under the assumption that
1416 * the EFI variable space is maintained separate from the random seed storage. That
1417 * is generally the case on physical systems, as the ESP is stored on persistant
1418 * storage, and the EFI variables in NVRAM. However in virtualized environments this
1419 * is generally not true: the EFI variable set is typically stored along with the
1420 * disk image itself. For example, using the OVMF EFI firmware the EFI variables are
1421 * stored in a file in the ESP itself. */
1423 log_notice("Not installing system token, since we are running in a virtualized environment.");
1426 } else if (r
== 0) {
1427 log_notice("Not writing system token, because $SYSTEMD_WRITE_SYSTEM_TOKEN is set to false.");
1431 r
= efi_get_variable(EFI_VENDOR_LOADER
, "LoaderSystemToken", NULL
, NULL
, &token_size
);
1434 return log_error_errno(r
, "Failed to test system token validity: %m");
1436 if (token_size
>= sz
) {
1437 /* Let's avoid writes if we can, and initialize this only once. */
1438 log_debug("System token already written, not updating.");
1442 log_debug("Existing system token size (%zu) does not match our expectations (%zu), replacing.", token_size
, sz
);
1445 r
= genuine_random_bytes(buffer
, sz
, RANDOM_BLOCK
);
1447 return log_error_errno(r
, "Failed to acquire random seed: %m");
1449 /* Let's write this variable with an umask in effect, so that unprivileged users can't see the token
1450 * and possibly get identification information or too much insight into the kernel's entropy pool
1452 RUN_WITH_UMASK(0077) {
1453 r
= efi_set_variable(EFI_VENDOR_LOADER
, "LoaderSystemToken", buffer
, sz
);
1455 return log_error_errno(r
, "Failed to set LoaderSystemToken EFI variable: %m");
1458 log_info("Successfully initialized system token in EFI variable with %zu bytes.", sz
);
1462 static int sync_everything(void) {
1466 k
= syncfs_path(AT_FDCWD
, arg_esp_path
);
1468 ret
= log_error_errno(k
, "Failed to synchronize the ESP '%s': %m", arg_esp_path
);
1471 if (arg_xbootldr_path
) {
1472 k
= syncfs_path(AT_FDCWD
, arg_xbootldr_path
);
1474 ret
= log_error_errno(k
, "Failed to synchronize $BOOT '%s': %m", arg_xbootldr_path
);
1480 static int verb_install(int argc
, char *argv
[], void *userdata
) {
1481 sd_id128_t uuid
= SD_ID128_NULL
;
1482 uint64_t pstart
= 0, psize
= 0;
1484 sd_id128_t machine_id
;
1488 r
= acquire_esp(false, &part
, &pstart
, &psize
, &uuid
);
1492 r
= acquire_xbootldr(false, NULL
);
1496 r
= sd_id128_get_machine(&machine_id
);
1498 return log_error_errno(r
, "Failed to get machine id: %m");
1500 install
= streq(argv
[0], "install");
1502 RUN_WITH_UMASK(0002) {
1504 /* Don't create any of these directories when we are just updating. When we update
1505 * we'll drop-in our files (unless there are newer ones already), but we won't create
1506 * the directories for them in the first place. */
1507 r
= create_subdirs(arg_esp_path
, esp_subdirs
);
1511 r
= create_subdirs(arg_dollar_boot_path(), dollar_boot_subdirs
);
1516 r
= install_binaries(arg_esp_path
, install
);
1521 r
= install_loader_config(arg_esp_path
, machine_id
);
1525 r
= install_machine_id_directory(arg_dollar_boot_path(), machine_id
);
1529 r
= install_random_seed(arg_esp_path
);
1535 (void) sync_everything();
1537 if (arg_touch_variables
)
1538 r
= install_variables(arg_esp_path
,
1539 part
, pstart
, psize
, uuid
,
1540 "/EFI/systemd/systemd-boot" EFI_MACHINE_TYPE_NAME
".efi",
1546 static int verb_remove(int argc
, char *argv
[], void *userdata
) {
1547 sd_id128_t uuid
= SD_ID128_NULL
, machine_id
;
1550 r
= acquire_esp(false, NULL
, NULL
, NULL
, &uuid
);
1554 r
= acquire_xbootldr(false, NULL
);
1558 r
= sd_id128_get_machine(&machine_id
);
1560 return log_error_errno(r
, "Failed to get machine id: %m");
1562 r
= remove_binaries(arg_esp_path
);
1564 q
= remove_file(arg_esp_path
, "/loader/loader.conf");
1565 if (q
< 0 && r
>= 0)
1568 q
= remove_file(arg_esp_path
, "/loader/random-seed");
1569 if (q
< 0 && r
>= 0)
1572 q
= remove_subdirs(arg_esp_path
, esp_subdirs
);
1573 if (q
< 0 && r
>= 0)
1576 q
= remove_subdirs(arg_esp_path
, dollar_boot_subdirs
);
1577 if (q
< 0 && r
>= 0)
1580 q
= remove_machine_id_directory(arg_esp_path
, machine_id
);
1581 if (q
< 0 && r
>= 0)
1584 if (arg_xbootldr_path
) {
1585 /* Remove the latter two also in the XBOOTLDR partition if it exists */
1586 q
= remove_subdirs(arg_xbootldr_path
, dollar_boot_subdirs
);
1587 if (q
< 0 && r
>= 0)
1590 q
= remove_machine_id_directory(arg_xbootldr_path
, machine_id
);
1591 if (q
< 0 && r
>= 0)
1595 (void) sync_everything();
1597 if (!arg_touch_variables
)
1600 q
= remove_variables(uuid
, "/EFI/systemd/systemd-boot" EFI_MACHINE_TYPE_NAME
".efi", true);
1601 if (q
< 0 && r
>= 0)
1604 q
= remove_loader_variables();
1605 if (q
< 0 && r
>= 0)
1611 static int verb_is_installed(int argc
, char *argv
[], void *userdata
) {
1612 _cleanup_free_
char *p
= NULL
;
1615 r
= acquire_esp(false, NULL
, NULL
, NULL
, NULL
);
1619 /* Tests whether systemd-boot is installed. It's not obvious what to use as check here: we could
1620 * check EFI variables, we could check what binary /EFI/BOOT/BOOT*.EFI points to, or whether the
1621 * loader entries directory exists. Here we opted to check whether /EFI/systemd/ is non-empty, which
1622 * should be a suitable and very minimal check for a number of reasons:
1624 * → The check is architecture independent (i.e. we check if any systemd-boot loader is installed, not a
1627 * → It doesn't assume we are the only boot loader (i.e doesn't check if we own the main
1628 * /EFI/BOOT/BOOT*.EFI fallback binary.
1630 * → It specifically checks for systemd-boot, not for other boot loaders (which a check for
1631 * /boot/loader/entries would do). */
1633 p
= path_join(arg_esp_path
, "/EFI/systemd/");
1637 r
= dir_is_empty(p
);
1638 if (r
> 0 || r
== -ENOENT
) {
1640 return EXIT_FAILURE
;
1643 return log_error_errno(r
, "Failed to detect whether systemd-boot is installed: %m");
1646 return EXIT_SUCCESS
;
1649 static int verb_set_default(int argc
, char *argv
[], void *userdata
) {
1654 return log_error_errno(SYNTHETIC_ERRNO(EOPNOTSUPP
),
1655 "Not booted with UEFI.");
1657 if (access("/sys/firmware/efi/efivars/LoaderInfo-4a67b082-0a4c-41cf-b6c7-440b29bb8c4f", F_OK
) < 0) {
1658 if (errno
== ENOENT
) {
1659 log_error_errno(errno
, "Not booted with a supported boot loader.");
1663 return log_error_errno(errno
, "Failed to detect whether boot loader supports '%s' operation: %m", argv
[0]);
1666 if (detect_container() > 0)
1667 return log_error_errno(SYNTHETIC_ERRNO(EOPNOTSUPP
),
1668 "'%s' operation not supported in a container.",
1671 if (!arg_touch_variables
)
1672 return log_error_errno(SYNTHETIC_ERRNO(EINVAL
),
1673 "'%s' operation cannot be combined with --touch-variables=no.",
1676 name
= streq(argv
[0], "set-default") ? "LoaderEntryDefault" : "LoaderEntryOneShot";
1678 if (isempty(argv
[1])) {
1679 r
= efi_set_variable(EFI_VENDOR_LOADER
, name
, NULL
, 0);
1680 if (r
< 0 && r
!= -ENOENT
)
1681 return log_error_errno(r
, "Failed to remove EFI variale: %m");
1683 _cleanup_free_ char16_t
*encoded
= NULL
;
1685 encoded
= utf8_to_utf16(argv
[1], strlen(argv
[1]));
1689 r
= efi_set_variable(EFI_VENDOR_LOADER
, name
, encoded
, char16_strlen(encoded
) * 2 + 2);
1691 return log_error_errno(r
, "Failed to update EFI variable: %m");
1697 static int verb_random_seed(int argc
, char *argv
[], void *userdata
) {
1700 r
= acquire_esp(false, NULL
, NULL
, NULL
, NULL
);
1704 r
= install_random_seed(arg_esp_path
);
1708 (void) sync_everything();
1712 static int bootctl_main(int argc
, char *argv
[]) {
1713 static const Verb verbs
[] = {
1714 { "help", VERB_ANY
, VERB_ANY
, 0, help
},
1715 { "status", VERB_ANY
, 1, VERB_DEFAULT
, verb_status
},
1716 { "install", VERB_ANY
, 1, 0, verb_install
},
1717 { "update", VERB_ANY
, 1, 0, verb_install
},
1718 { "remove", VERB_ANY
, 1, 0, verb_remove
},
1719 { "random-seed", VERB_ANY
, 1, 0, verb_random_seed
},
1720 { "is-installed", VERB_ANY
, 1, 0, verb_is_installed
},
1721 { "list", VERB_ANY
, 1, 0, verb_list
},
1722 { "set-default", 2, 2, 0, verb_set_default
},
1723 { "set-oneshot", 2, 2, 0, verb_set_default
},
1727 return dispatch_verb(argc
, argv
, verbs
, NULL
);
1730 static int run(int argc
, char *argv
[]) {
1733 log_parse_environment();
1736 /* If we run in a container, automatically turn off EFI file system access */
1737 if (detect_container() > 0)
1738 arg_touch_variables
= false;
1740 r
= parse_argv(argc
, argv
);
1744 return bootctl_main(argc
, argv
);
1747 DEFINE_MAIN_FUNCTION(run
);