/* * GRUB -- GRand Unified Bootloader * Copyright (C) 2013 Free Software Foundation, Inc. * * GRUB is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation, either version 3 of the License, or * (at your option) any later version. * * GRUB is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with GRUB. If not, see . */ #ifndef GRUB_UTIL_INSTALL_HEADER #define GRUB_UTIL_INSTALL_HEADER 1 #include #include #include #include #include #define GRUB_INSTALL_OPTIONS \ { "modules", GRUB_INSTALL_OPTIONS_MODULES, N_("MODULES"), \ 0, N_("pre-load specified modules MODULES"), 1 }, \ { "dtb", GRUB_INSTALL_OPTIONS_DTB, N_("FILE"), \ 0, N_("embed a specific DTB"), 1 }, \ { "install-modules", GRUB_INSTALL_OPTIONS_INSTALL_MODULES, \ N_("MODULES"), 0, \ N_("install only MODULES and their dependencies [default=all]"), 1 }, \ { "themes", GRUB_INSTALL_OPTIONS_INSTALL_THEMES, N_("THEMES"), \ 0, N_("install THEMES [default=%s]"), 1 }, \ { "fonts", GRUB_INSTALL_OPTIONS_INSTALL_FONTS, N_("FONTS"), \ 0, N_("install FONTS [default=%s]"), 1 }, \ { "locales", GRUB_INSTALL_OPTIONS_INSTALL_LOCALES, N_("LOCALES"),\ 0, N_("install only LOCALES [default=all]"), 1 }, \ { "compress", GRUB_INSTALL_OPTIONS_INSTALL_COMPRESS, \ "no|xz|gz|lzo", 0, \ N_("compress GRUB files [optional]"), 1 }, \ {"core-compress", GRUB_INSTALL_OPTIONS_INSTALL_CORE_COMPRESS, \ "xz|none|auto", \ 0, N_("choose the compression to use for core image"), 2}, \ /* TRANSLATORS: platform here isn't identifier. It can be translated. */ \ { "directory", 'd', N_("DIR"), 0, \ N_("use images and modules under DIR [default=%s/]"), 1 }, \ { "override-directory", GRUB_INSTALL_OPTIONS_DIRECTORY2, \ N_("DIR"), OPTION_HIDDEN, \ N_("use images and modules under DIR [default=%s/]"), 1 }, \ { "locale-directory", GRUB_INSTALL_OPTIONS_LOCALE_DIRECTORY, \ N_("DIR"), 0, \ N_("use translations under DIR [default=%s]"), 1 }, \ { "themes-directory", GRUB_INSTALL_OPTIONS_THEMES_DIRECTORY, \ N_("DIR"), OPTION_HIDDEN, \ N_("use themes under DIR [default=%s]"), 1 }, \ { "grub-mkimage", GRUB_INSTALL_OPTIONS_GRUB_MKIMAGE, \ "FILE", OPTION_HIDDEN, 0, 1 }, \ /* TRANSLATORS: "embed" is a verb (command description). "*/ \ { "pubkey", 'k', N_("FILE"), 0, \ N_("embed FILE as public key for signature checking"), 0}, \ { "sbat", GRUB_INSTALL_OPTIONS_SBAT, N_("FILE"), 0, \ N_("SBAT metadata"), 0 }, \ { "disable-shim-lock", GRUB_INSTALL_OPTIONS_DISABLE_SHIM_LOCK, 0, 0, \ N_("disable shim_lock verifier"), 0 }, \ { "verbose", 'v', 0, 0, \ N_("print verbose messages."), 1 } int grub_install_parse (int key, char *arg); void grub_install_push_module (const char *val); void grub_install_pop_module (void); char * grub_install_help_filter (int key, const char *text, void *input __attribute__ ((unused))); enum grub_install_plat { GRUB_INSTALL_PLATFORM_I386_PC, GRUB_INSTALL_PLATFORM_I386_EFI, GRUB_INSTALL_PLATFORM_I386_QEMU, GRUB_INSTALL_PLATFORM_I386_COREBOOT, GRUB_INSTALL_PLATFORM_I386_MULTIBOOT, GRUB_INSTALL_PLATFORM_I386_IEEE1275, GRUB_INSTALL_PLATFORM_X86_64_EFI, GRUB_INSTALL_PLATFORM_MIPSEL_LOONGSON, GRUB_INSTALL_PLATFORM_SPARC64_IEEE1275, GRUB_INSTALL_PLATFORM_POWERPC_IEEE1275, GRUB_INSTALL_PLATFORM_MIPSEL_ARC, GRUB_INSTALL_PLATFORM_MIPS_ARC, GRUB_INSTALL_PLATFORM_IA64_EFI, GRUB_INSTALL_PLATFORM_ARM_UBOOT, GRUB_INSTALL_PLATFORM_ARM_EFI, GRUB_INSTALL_PLATFORM_MIPSEL_QEMU_MIPS, GRUB_INSTALL_PLATFORM_MIPS_QEMU_MIPS, GRUB_INSTALL_PLATFORM_I386_XEN, GRUB_INSTALL_PLATFORM_X86_64_XEN, GRUB_INSTALL_PLATFORM_I386_XEN_PVH, GRUB_INSTALL_PLATFORM_ARM64_EFI, GRUB_INSTALL_PLATFORM_ARM_COREBOOT, GRUB_INSTALL_PLATFORM_RISCV32_EFI, GRUB_INSTALL_PLATFORM_RISCV64_EFI, GRUB_INSTALL_PLATFORM_MAX }; enum grub_install_options { GRUB_INSTALL_OPTIONS_DIRECTORY = 'd', GRUB_INSTALL_OPTIONS_VERBOSITY = 'v', GRUB_INSTALL_OPTIONS_MODULES = 0x201, GRUB_INSTALL_OPTIONS_INSTALL_MODULES, GRUB_INSTALL_OPTIONS_INSTALL_THEMES, GRUB_INSTALL_OPTIONS_INSTALL_FONTS, GRUB_INSTALL_OPTIONS_INSTALL_LOCALES, GRUB_INSTALL_OPTIONS_INSTALL_COMPRESS, GRUB_INSTALL_OPTIONS_DIRECTORY2, GRUB_INSTALL_OPTIONS_LOCALE_DIRECTORY, GRUB_INSTALL_OPTIONS_THEMES_DIRECTORY, GRUB_INSTALL_OPTIONS_GRUB_MKIMAGE, GRUB_INSTALL_OPTIONS_INSTALL_CORE_COMPRESS, GRUB_INSTALL_OPTIONS_DTB, GRUB_INSTALL_OPTIONS_SBAT, GRUB_INSTALL_OPTIONS_DISABLE_SHIM_LOCK }; extern char *grub_install_source_directory; enum grub_install_plat grub_install_get_target (const char *src); void grub_install_mkdir_p (const char *dst); void grub_install_copy_files (const char *src, const char *dst, enum grub_install_plat platid); char * grub_install_get_platform_name (enum grub_install_plat platid); const char * grub_install_get_platform_cpu (enum grub_install_plat platid); const char * grub_install_get_platform_platform (enum grub_install_plat platid); char * grub_install_get_platforms_string (void); typedef enum { GRUB_COMPRESSION_AUTO, GRUB_COMPRESSION_NONE, GRUB_COMPRESSION_XZ, GRUB_COMPRESSION_LZMA } grub_compression_t; void grub_install_make_image_wrap (const char *dir, const char *prefix, const char *outname, char *memdisk_path, char *config_path, const char *format, int note); void grub_install_make_image_wrap_file (const char *dir, const char *prefix, FILE *fp, const char *outname, char *memdisk_path, char *config_path, const char *mkimage_target, int note); int grub_install_copy_file (const char *src, const char *dst, int is_critical); struct grub_install_image_target_desc; void grub_install_generate_image (const char *dir, const char *prefix, FILE *out, const char *outname, char *mods[], char *memdisk_path, char **pubkey_paths, size_t npubkeys, char *config_path, const struct grub_install_image_target_desc *image_target, int note, grub_compression_t comp, const char *dtb_file, const char *sbat_path, const int disable_shim_lock); const struct grub_install_image_target_desc * grub_install_get_image_target (const char *arg); void grub_util_bios_setup (const char *dir, const char *boot_file, const char *core_file, const char *dest, int force, int fs_probe, int allow_floppy, int add_rs_codes, int warn_short_mbr_gap); void grub_util_sparc_setup (const char *dir, const char *boot_file, const char *core_file, const char *dest, int force, int fs_probe, int allow_floppy, int add_rs_codes, int warn_short_mbr_gap); char * grub_install_get_image_targets_string (void); const char * grub_util_get_target_dirname (const struct grub_install_image_target_desc *t); void grub_install_create_envblk_file (const char *name); const char * grub_install_get_default_arm_platform (void); const char * grub_install_get_default_x86_platform (void); int grub_install_register_efi (grub_device_t efidir_grub_dev, const char *efifile_path, const char *efi_distributor); void grub_install_register_ieee1275 (int is_prep, const char *install_device, int partno, const char *relpath); void grub_install_sgi_setup (const char *install_device, const char *imgfile, const char *destname); int grub_install_compress_gzip (const char *src, const char *dest); int grub_install_compress_lzop (const char *src, const char *dest); int grub_install_compress_xz (const char *src, const char *dest); void grub_install_get_blocklist (grub_device_t root_dev, const char *core_path, const char *core_img, size_t core_size, void (*callback) (grub_disk_addr_t sector, unsigned offset, unsigned length, void *data), void *hook_data); void grub_util_create_envblk_file (const char *name); void grub_util_glue_efi (const char *file32, const char *file64, const char *out); void grub_util_render_label (const char *label_font, const char *label_bgcolor, const char *label_color, const char *label_string, const char *label); const char * grub_util_get_target_name (const struct grub_install_image_target_desc *t); extern char *grub_install_copy_buffer; #define GRUB_INSTALL_COPY_BUFFER_SIZE 1048576 int grub_install_is_short_mbrgap_supported (void); /* * grub-install-common tries to make backups of modules & auxiliary files, * and restore the backup upon failure to install core.img. There are * platforms with additional actions after modules & core got installed * in place. It is a point of no return, as core.img cannot be reverted * from this point onwards, and new modules should be kept installed. * Before performing these additional actions call grub_set_install_backup_ponr() * to set the grub_install_backup_ponr flag. This way failure to perform * subsequent actions will not result in reverting new modules to the * old ones, e.g. in case efivars updates fails. */ #ifdef HAVE_ATEXIT extern void grub_set_install_backup_ponr (void); #else static inline void grub_set_install_backup_ponr (void) { } #endif #endif