X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fkernel-install.xml;h=929ceef4afdf2094124b2d834ff3894f7a66a428;hb=672682a6b9d6fb6a3722c3fea1a93b4831747b54;hp=93dc0ae4fdd176c387927ae1e78062fb5aacb0a5;hpb=2d0614d3d310e1fa0246bb6fcf90f7014acaf209;p=elogind.git
diff --git a/man/kernel-install.xml b/man/kernel-install.xml
index 93dc0ae4f..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,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 +154,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,7 +163,7 @@ 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.
@@ -148,7 +171,7 @@ along with systemd; If not, see .
/etc/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.