X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fkernel-install.xml;h=d4d01807a4b69df92e2e91981c4b234b0dbe91ab;hb=795bc7e79107e01d088047e3b3a6f32da992a959;hp=4634680b398a4042ade3bf0045a7d09f70847329;hpb=46e6e4f1e50a56d69f87653f30996766fcb23f8a;p=elogind.git
diff --git a/man/kernel-install.xml b/man/kernel-install.xml
index 4634680b3..d4d01807a 100644
--- a/man/kernel-install.xml
+++ b/man/kernel-install.xml
@@ -1,4 +1,4 @@
-
+
@@ -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,50 @@ 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/<MACHINE-ID>-<KERNEL VERSION>.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
+ /usr/lib/os-release (if the former is
+ missing), 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/<MACHINE-ID>-<KERNEL VERSION>.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 +147,7 @@ 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.
@@ -131,7 +156,7 @@ along with systemd; If not, see .
/proc/cmdline
- The contents of the file /etc/kernel/cmdline specifies the kernel command line to use.
+ 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.
@@ -140,15 +165,16 @@ along with systemd; If not, see .
/etc/machine-id
- The contents of the file specifies the machine identifaction <MACHINE-ID>.
+ The content of the file specifies the machine identification MACHINE-ID.
/etc/os-release
+ /usr/lib/os-release
- The contents of the file specifies the the operating system id <OS-ID>.
+ The content of the file specifies the operating system title PRETTY_NAME.