man/kernel-install.8

   1 '\" t
   2 .TH "KERNEL\-INSTALL" "8" "" "systemd 217" "kernel-install"
   3 .\" -----------------------------------------------------------------
   4 .\" * Define some portability stuff
   5 .\" -----------------------------------------------------------------
   6 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
   7 .\" http://bugs.debian.org/507673
   8 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
   9 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  10 .ie \n(.g .ds Aq \(aq
  11 .el       .ds Aq '
  12 .\" -----------------------------------------------------------------
  13 .\" * set default formatting
  14 .\" -----------------------------------------------------------------
  15 .\" disable hyphenation
  16 .nh
  17 .\" disable justification (adjust text to left margin only)
  18 .ad l
  19 .\" -----------------------------------------------------------------
  20 .\" * MAIN CONTENT STARTS HERE *
  21 .\" -----------------------------------------------------------------
  22 .SH "NAME"
  23 kernel-install \- Add and remove kernel and initramfs images to and from /boot
  24 .SH "SYNOPSIS"
  25 .HP \w'\fBkernel\-install\fR\ 'u
  26 \fBkernel\-install\fR COMMAND \fIKERNEL\-VERSION\fR [\fIKERNEL\-IMAGE\fR]
  27 .SH "DESCRIPTION"
  28 .PP
  29 \fBkernel\-install\fR
  30 is used to install and remove kernel and initramfs images to and from
  31 /boot\&.
  32 .PP
  33 \fBkernel\-install\fR
  34 will execute the files located in the directory
  35 /usr/lib/kernel/install\&.d/
  36 and the local administration directory
  37 /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
  38 /etc/kernel/install\&.d/
  39 take precedence over files with the same name in
  40 /usr/lib/kernel/install\&.d/\&. This can be used to override a system\-supplied executables with a local file if needed; a symbolic link in
  41 /etc/kernel/install\&.d/
  42 with the same name as an executable in
  43 /usr/lib/kernel/install\&.d/, pointing to /dev/null, disables the executable entirely\&. Executables must have the extension
  44 "\&.install"; other extensions are ignored\&.
  45 .SH "COMMANDS"
  46 .PP
  47 The following commands are understood:
  48 .PP
  49 \fBadd \fR\fB\fIKERNEL\-VERSION\fR\fR\fB \fR\fB\fIKERNEL\-IMAGE\fR\fR
  50 .RS 4
  51 \fBkernel\-install\fR
  52 creates the directory
  53 /boot/\fIMACHINE\-ID\fR/\fIKERNEL\-VERSION\fR/
  54 and calls every executable
  55 /usr/lib/kernel/install\&.d/*\&.install
  56 and
  57 /etc/kernel/install\&.d/*\&.install
  58 with the arguments
  59 .sp
  60 .if n \{\
  61 .RS 4
  62 .\}
  63 .nf
  64 add \fIKERNEL\-VERSION\fR /boot/\fIMACHINE\-ID\fR/\fIKERNEL\-VERSION\fR/
  65 .fi
  66 .if n \{\
  67 .RE
  68 .\}
  69 .sp
  70 The kernel\-install plugin
  71 50\-depmod\&.install
  72 runs depmod for the
  73 \fIKERNEL\-VERSION\fR\&.
  74 .sp
  75 The kernel\-install plugin
  76 90\-loaderentry\&.install
  77 copies
  78 \fIKERNEL\-IMAGE\fR
  79 to
  80 /boot/\fIMACHINE\-ID\fR/\fIKERNEL\-VERSION\fR/linux\&. It also creates a boot loader entry according to the boot loader specification in
  81 /boot/loader/entries/\fIMACHINE\-ID\fR\-\fIKERNEL\-VERSION\fR\&.conf\&. The title of the entry is the
  82 \fIPRETTY_NAME\fR
  83 parameter specified in
  84 /etc/os\-release
  85 or
  86 /usr/lib/os\-release
  87 (if the former is missing), or "Linux
  88 \fIKERNEL\-VERSION\fR", if unset\&. If the file
  89 initrd
  90 is found next to the
  91 linux
  92 file, the initrd will be added to the configuration\&.
  93 .RE
  94 .PP
  95 \fBremove \fR\fB\fIKERNEL\-VERSION\fR\fR
  96 .RS 4
  97 Calls every executable
  98 /usr/lib/kernel/install\&.d/*\&.install
  99 and
 100 /etc/kernel/install\&.d/*\&.install
 101 with the arguments
 102 .sp
 103 .if n \{\
 104 .RS 4
 105 .\}
 106 .nf
 107 remove \fIKERNEL\-VERSION\fR /boot/\fIMACHINE\-ID\fR/\fIKERNEL\-VERSION\fR/
 108 .fi
 109 .if n \{\
 110 .RE
 111 .\}
 112 .sp
 113 \fBkernel\-install\fR
 114 removes the entire directory
 115 /boot/\fIMACHINE\-ID\fR/\fIKERNEL\-VERSION\fR/
 116 afterwards\&.
 117 .sp
 118 The kernel\-install plugin
 119 90\-loaderentry\&.install
 120 removes the file
 121 /boot/loader/entries/\fIMACHINE\-ID\fR\-\fIKERNEL\-VERSION\fR\&.conf\&.
 122 .RE
 123 .SH "EXIT STATUS"
 124 .PP
 125 If every executable returns with 0, 0 is returned, a non\-zero failure code otherwise\&.
 126 .SH "FILES"
 127 .PP
 128 /usr/lib/kernel/install\&.d/*\&.install /etc/kernel/install\&.d/*\&.install
 129 .RS 4
 130 Drop\-in files which are executed by kernel\-install\&.
 131 .RE
 132 .PP
 133 /etc/kernel/cmdline /proc/cmdline
 134 .RS 4
 135 The content of the file
 136 /etc/kernel/cmdline
 137 specifies the kernel command line to use\&. If that file does not exist,
 138 /proc/cmdline
 139 is used\&.
 140 .RE
 141 .PP
 142 /etc/machine\-id
 143 .RS 4
 144 The content of the file specifies the machine identification
 145 \fIMACHINE\-ID\fR\&.
 146 .RE
 147 .PP
 148 /etc/os\-release /usr/lib/os\-release
 149 .RS 4
 150 The content of the file specifies the operating system title
 151 \fIPRETTY_NAME\fR\&.
 152 .RE
 153 .SH "SEE ALSO"
 154 .PP
 155 \fBmachine-id\fR(5),
 156 \fBos-release\fR(5),
 157 \m[blue]\fBBoot loader specification\fR\m[]\&\s-2\u[1]\d\s+2
 158 .SH "NOTES"
 159 .IP " 1." 4
 160 Boot loader specification
 161 .RS 4
 162 \%http://www.freedesktop.org/wiki/Specifications/BootLoaderSpec
 163 .RE