X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fkernel-install.xml;h=929ceef4afdf2094124b2d834ff3894f7a66a428;hb=248fc619b5e3e24d78f171f95b85916eee7987bd;hp=06939fa090656a52093854626b3a898561d9ec01;hpb=81516adcb71a47837544340f72eb8ee810274119;p=elogind.git
diff --git a/man/kernel-install.xml b/man/kernel-install.xml
index 06939fa09..929ceef4a 100644
--- a/man/kernel-install.xml
+++ b/man/kernel-install.xml
@@ -49,7 +49,10 @@ along with systemd; If not, see .
- kernel-install COMMAND KERNEL VERSION KERNEL IMAGE
+ kernel-install
+ COMMAND
+ KERNEL-VERSION
+ KERNEL-IMAGE
@@ -60,16 +63,17 @@ along with systemd; If not, see .
initramfs images to and from /boot.
- kernel-install will execute the files located in the directory /usr/lib/kernel/install.d/
+ kernel-install 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 directories in
- which they live. However, files with identical file names replace each other.
+ 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-supplied
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.
+ extension .install; other extensions are ignored.
@@ -78,29 +82,48 @@ along with systemd; If not, see .
The following commands are understood:
- add <KERNEL VERSION> <KERNEL IMAGE>
+ add KERNEL-VERSION KERNEL-IMAGE
- calls every executable /usr/lib/kernel/install.d/*.install
- and /etc/kernel/install.d/*.install with the arguments
- "add <KERNEL VERSION> /boot/<MACHINE-ID>/<KERNEL VERSION>/"
-
- kernel-install copies <KERNEL IMAGE> to
- /boot/<MACHINE-ID>/<KERNEL VERSION>/linux.
-
- kernel-install also creates a boot loader entry according to the boot loader specification
- in /boot/loader/entries/<OS-ID>-<KERNEL VERSION>-<MACHINE-ID>.conf.
- If the file initrd is found next to the linux file,
- the initrd will be added to the configuration.
+ kernel-install creates the directory
+ /boot/MACHINE-ID/KERNEL-VERSION/
+ and calls every executable
+ /usr/lib/kernel/install.d/*.install and
+ /etc/kernel/install.d/*.install with
+ the arguments
+
+add KERNEL-VERSION /boot/MACHINE-ID/KERNEL-VERSION/
+
+
+
+ The kernel-install plugin 50-depmod.install runs depmod for the KERNEL-VERSION.
+
+ The kernel-install plugin 90-loaderentry.install copies
+ KERNEL-IMAGE to
+ /boot/MACHINE-ID/KERNEL-VERSION/linux.
+ It also creates a boot loader entry according to the boot loader specification in
+ /boot/loader/entries/MACHINE-ID-KERNEL-VERSION.conf.
+ The title of the entry is the PRETTY_NAME parameter specified in /etc/os-release,
+ or "Linux KERNEL-VERSION", if unset.
+ If the file initrd is found next to the
+ linux file, the initrd will be added to
+ the configuration.
- remove <KERNEL VERSION> <KERNEL IMAGE>
- calls every executable /usr/lib/kernel/install.d/*.install
- and /etc/kernel/install.d/*.install with the arguments:
- "remove <KERNEL VERSION> /boot/<MACHINE-ID>/<KERNEL VERSION>/"
-
- kernel-install removes the entire directory /boot/<MACHINE-ID>/<KERNEL VERSION>/
- and the file /boot/loader/entries/<OS-ID>-<KERNEL VERSION>-<MACHINE-ID>.conf
+ remove KERNEL-VERSION
+
+ Calls every executable /usr/lib/kernel/install.d/*.install
+ and /etc/kernel/install.d/*.install with the arguments
+
+remove KERNEL-VERSION /boot/MACHINE-ID/KERNEL-VERSION/
+
+
+
+ kernel-install removes the entire directory
+ /boot/MACHINE-ID/KERNEL-VERSION/ afterwards.
+
+ The kernel-install plugin 90-loaderentry.install removes the file
+ /boot/loader/entries/MACHINE-ID-KERNEL-VERSION.conf.
@@ -122,7 +145,33 @@ along with systemd; If not, see .
/etc/kernel/install.d/*.install
- Drop-in files, which are executed by kernel-install.
+ Drop-in files which are executed by kernel-install.
+
+
+
+
+ /etc/kernel/cmdline
+ /proc/cmdline
+
+
+ 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.
+
+
+
+
+ /etc/machine-id
+
+
+ The content of the file specifies the machine identification MACHINE-ID.
+
+
+
+
+ /etc/os-release
+
+
+ The content of the file specifies the operating system title PRETTY_NAME.
@@ -131,6 +180,8 @@ along with systemd; If not, see .
See Also
+ machine-id5,
+ os-release5,
Boot loader specification