{"id":3093,"date":"2022-12-20T16:43:28","date_gmt":"2022-12-20T19:43:28","guid":{"rendered":"http:\/\/lode.uno\/linux-man\/index.php\/2022\/12\/20\/kernelinstall-man8\/"},"modified":"2022-12-20T16:43:28","modified_gmt":"2022-12-20T19:43:28","slug":"kernelinstall-man8","status":"publish","type":"post","link":"https:\/\/lode.uno\/linux-man\/2022\/12\/20\/kernelinstall-man8\/","title":{"rendered":"KERNEL−INSTALL (man8)"},"content":{"rendered":"

KERNEL\u2212INSTALL<\/h1>\n

NAME<\/a>
SYNOPSIS<\/a>
DESCRIPTION<\/a>
COMMANDS<\/a>
THE $BOOT PARTITION<\/a>
OPTIONS<\/a>
ENVIRONMENT VARIABLES<\/a>
EXIT STATUS<\/a>
FILES<\/a>
SEE ALSO<\/a>
NOTES<\/a> <\/p>\n

\n

NAME <\/a> <\/h2>\n

kernel-install \u2212 Add and remove kernel and initramfs images to and from \/boot<\/p>\n

SYNOPSIS <\/a> <\/h2>\n\n\n
<\/td>\n\n

kernel\u2212install<\/b> COMMAND [OPTIONS…] KERNEL\u2212VERSION KERNEL\u2212IMAGE<\/i> [INITRD\u2212FILE<\/i>…]<\/p>\n<\/td>\n<\/tr>\n<\/table>\n

DESCRIPTION <\/a> <\/h2>\n

kernel\u2212install<\/b> is used to install and remove kernel and initramfs images to and from the boot loader partition, referred to as $BOOT<\/i> here. It will usually be one of \/boot\/, \/efi\/, or \/boot\/efi\/, see below.<\/p>\n

kernel\u2212install<\/b> will execute the files located in the directory \/usr\/lib\/kernel\/install.d\/ and the local administration directory \/etc\/kernel\/install.d\/. All files are collectively sorted and executed in lexical order, regardless of the directory in which they live. However, files with identical filenames replace each other. Files in \/etc\/kernel\/install.d\/ take precedence over files with the same name in \/usr\/lib\/kernel\/install.d\/. This can be used to override a system\u2212supplied executables with a local file if needed; a symbolic link in \/etc\/kernel\/install.d\/ with the same name as an executable in \/usr\/lib\/kernel\/install.d\/, pointing to \/dev\/null, disables the executable entirely. Executables must have the extension “.install”; other extensions are ignored.<\/p>\n

An executable should return 0<\/b> on success. It may also return 77<\/b> to cause the whole operation to terminate (executables later in lexical order will be skipped).<\/p>\n

COMMANDS <\/a> <\/h2>\n

The following commands are understood:<\/p>\n

add<\/b> KERNEL\u2212VERSION KERNEL\u2212IMAGE<\/i> [<\/b>INITRD\u2212FILE<\/i> …]<\/b><\/p>\n

This command expects a kernel version string and a path to a kernel image file as arguments. kernel\u2212install<\/b> calls the executables from \/usr\/lib\/kernel\/install.d\/00-entry-directory.install \/usr\/lib\/kernel\/install.d\/50-depmod.install \/usr\/lib\/kernel\/install.d\/50-dracut.install \/usr\/lib\/kernel\/install.d\/51-dracut-rescue.install \/usr\/lib\/kernel\/install.d\/90-loaderentry.install and \/etc\/kernel\/install.d\/*.install with the following arguments:<\/p>\n

add KERNEL\u2212VERSION<\/i> $BOOT\/MACHINE\u2212ID<\/i>\/KERNEL\u2212VERSION<\/i>\/ KERNEL\u2212IMAGE<\/i> [INITRD\u2212FILE<\/i> …]<\/p>\n

Three default plugins execute the following operations in this case:<\/p>\n

\u2022 00\u2212entry\u2212directory.install creates the directory $BOOT\/MACHINE\u2212ID<\/i>\/KERNEL\u2212VERSION<\/i>\/ if $BOOT\/MACHINE\u2212ID<\/i>\/ already exists.<\/p>\n

\u2022 50\u2212depmod.install runs depmod<\/b>(8) for the KERNEL\u2212VERSION<\/i>.<\/p>\n

\u2022 90\u2212loaderentry.install copies KERNEL\u2212IMAGE<\/i> to $BOOT\/MACHINE\u2212ID<\/i>\/KERNEL\u2212VERSION<\/i>\/linux. If an INITRD\u2212FILE<\/i> is provided, it also copies INITRD\u2212FILE<\/i> to $BOOT\/MACHINE\u2212ID<\/i>\/KERNEL_VERSION<\/i>\/INITRD\u2212FILE<\/i>. It also creates a boot loader entry according to the Boot Loader Specification<\/font><\/b> [1]<\/font><\/small> in $BOOT\/loader\/entries\/MACHINE\u2212ID<\/i>\u2212KERNEL\u2212VERSION<\/i>.conf. The title of the entry is the PRETTY_NAME<\/i> parameter specified in \/etc\/os\u2212release or \/usr\/lib\/os\u2212release (if the former is missing), or “Linux KERNEL\u2212VERSION<\/i>“, if unset.<\/font><\/p>\n

If the entry directory $BOOT\/MACHINE\u2212ID<\/i>\/KERNEL\u2212VERSION<\/i>\/ does not exist, this plugin does nothing.<\/font><\/p>\n

remove<\/b> KERNEL\u2212VERSION<\/i><\/font><\/p>\n

This command expects a kernel version string as single argument. This calls executables from \/usr\/lib\/kernel\/install.d\/00-entry-directory.install \/usr\/lib\/kernel\/install.d\/50-depmod.install \/usr\/lib\/kernel\/install.d\/50-dracut.install \/usr\/lib\/kernel\/install.d\/51-dracut-rescue.install \/usr\/lib\/kernel\/install.d\/90-loaderentry.install and \/etc\/kernel\/install.d\/*.install with the following arguments:<\/font><\/p>\n

remove KERNEL\u2212VERSION<\/i> $BOOT\/MACHINE\u2212ID<\/i>\/KERNEL\u2212VERSION<\/i>\/<\/font><\/p>\n

Afterwards, kernel\u2212install<\/b> removes the directory $BOOT\/MACHINE\u2212ID<\/i>\/KERNEL\u2212VERSION<\/i>\/ and its contents.<\/font><\/p>\n

Two default plugins execute the following operations in this case:<\/font><\/p>\n

\u2022 50\u2212depmod.install removes the files generated by depmod<\/b> for this kernel again.<\/font><\/p>\n

\u2022 90\u2212loaderentry.install removes the file $BOOT\/loader\/entries\/MACHINE\u2212ID<\/i>\u2212KERNEL\u2212VERSION<\/i>.conf.<\/font><\/p>\n

THE $BOOT PARTITION <\/a> <\/h2>\n

The partition where the kernels and<\/font> Boot Loader Specification<\/font><\/b> [1]<\/font><\/small> snippets are located is called $BOOT<\/i>. kernel\u2212install<\/b> determines the location of this partition by checking \/efi\/, \/boot\/, and \/boot\/efi\/ in turn. The first location where $BOOT\/loader\/entries\/ or $BOOT\/$MACHINE_ID\/ exists is used.<\/font><\/p>\n

OPTIONS <\/a> <\/h2>\n

The following options are understood:<\/font><\/p>\n

\u2212v<\/b>, \u2212\u2212verbose<\/b><\/font><\/p>\n

Output additional information about operations being performed.<\/font><\/p>\n

\u2212h<\/b>, \u2212\u2212help<\/b><\/font><\/p>\n

Print a short help text and exit.<\/font><\/p>\n

ENVIRONMENT VARIABLES <\/a> <\/h2>\n

If \u2212\u2212verbose<\/b> is used, $KERNEL_INSTALL_VERBOSE=1<\/i> will be set for the plugins. They may output additional logs in this case.<\/font><\/p>\n

EXIT STATUS <\/a> <\/h2>\n

If every executable returns 0 or 77, 0 is returned, and a non\u2212zero failure code otherwise.<\/font><\/p>\n

FILES <\/a> <\/h2>\n

\/usr\/lib\/kernel\/install.d\/*.install \/etc\/kernel\/install.d\/*.install<\/font><\/p>\n

Drop\u2212in files which are executed by kernel\u2212install.<\/font><\/p>\n

\/etc\/kernel\/cmdline \/proc\/cmdline<\/font><\/p>\n

Read by 90\u2212loaderentry.install. The content of the file \/etc\/kernel\/cmdline specifies the kernel command line to use. If that file does not exist, \/proc\/cmdline is used.<\/font><\/p>\n

\/etc\/kernel\/tries<\/font><\/p>\n

Read by 90\u2212loaderentry.install. If this file exists a numeric value is read from it and the naming of the generated entry file is slightly altered to include it as $BOOT\/loader\/entries\/MACHINE\u2212ID<\/i>\u2212KERNEL\u2212VERSION<\/i>+TRIES<\/i>.conf. This is useful for boot loaders such as systemd-boot<\/b>(7) which implement boot attempt counting with a counter embedded in the entry file name.<\/font><\/p>\n

\/etc\/machine\u2212id<\/font><\/p>\n

The content of the file specifies the machine identification MACHINE\u2212ID<\/i>.<\/font><\/p>\n

\/etc\/os\u2212release \/usr\/lib\/os\u2212release<\/font><\/p>\n

The content of the file specifies the operating system title PRETTY_NAME<\/i>.<\/font><\/p>\n

SEE ALSO <\/a> <\/h2>\n

machine-id<\/b>(5), os-release<\/b>(5), depmod<\/b>(8), systemd-boot<\/b>(7),<\/font> Boot Loader Specification<\/font><\/b> [1]<\/font><\/small><\/p>\n

NOTES <\/a> <\/h2>\n\n\n
<\/td>\n\n

1.<\/font><\/p>\n<\/td>\n

<\/td>\n\n

Boot Loader Specification<\/font><\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n<\/table>\n

https:\/\/systemd.io\/BOOT_LOADER_SPECIFICATION<\/font><\/p>\n

\n","protected":false},"excerpt":{"rendered":"

kernel-install \u2212 Add and remove kernel and initramfs images to and from \/boot <\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2],"tags":[5,52,242,4],"class_list":["post-3093","post","type-post","status-publish","format-standard","hentry","category-8-administracion-del-sistema","tag-5","tag-administracion","tag-kernel-install","tag-man8"],"gutentor_comment":0,"_links":{"self":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/3093","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/comments?post=3093"}],"version-history":[{"count":0,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/3093\/revisions"}],"wp:attachment":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/media?parent=3093"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/categories?post=3093"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/tags?post=3093"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}