]> git.proxmox.com Git - systemd.git/blame - man/kernel-install.html
projects / systemd.git / blame
? search:
summary | shortlog | log | commit | commitdiff | tree
blob | blame (incremental) | history | HEAD
Imported Upstream version 218
[systemd.git] / man / kernel-install.html
CommitLineData
663996b3
MS		 1<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>kernel-install</title><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><style>
2 a.headerlink {
3 color: #c60f0f;
4 font-size: 0.8em;
5 padding: 0 4px 0 4px;
6 text-decoration: none;
7 visibility: hidden;
8 }
9
10 a.headerlink:hover {
11 background-color: #c60f0f;
12 color: white;
13 }
14
15 h1:hover > a.headerlink, h2:hover > a.headerlink, h3:hover > a.headerlink, dt:hover > a.headerlink {
16 visibility: visible;
17 }
18 </style><a href="index.html">Index </a>·
19 <a href="systemd.directives.html">Directives </a>·
20 <a href="../python-systemd/index.html">Python </a>·
21 <a href="../libudev/index.html">libudev </a>·
f47781d8 22 <a href="../libudev/index.html">gudev </a><span style="float:right">systemd 218</span><hr><div class="refentry"><a name="kernel-install"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>kernel-install — Add and remove kernel and initramfs images to and from /boot</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">kernel-install</code> COMMAND <em class="replaceable"><code>KERNEL-VERSION</code></em> [<em class="replaceable"><code>KERNEL-IMAGE</code></em>]</p></div></div><div class="refsect1"><a name="idm139974439933104"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p>
663996b3
MS		 23 <span class="command"><strong>kernel-install</strong></span> is used to install and remove kernel and
24 initramfs images to and from <code class="filename">/boot</code>.
25 </p><p><span class="command"><strong>kernel-install</strong></span> will execute the files
26 located in the directory <code class="filename">/usr/lib/kernel/install.d/</code>
27 and the local administration directory <code class="filename">/etc/kernel/install.d/</code>.
28 All files are collectively sorted and executed in lexical order, regardless of the directory in
14228c0d 29 which they live. However, files with identical filenames replace each other.
663996b3
MS		 30 Files in <code class="filename">/etc/kernel/install.d/</code> take precedence over files with the same name
31 in <code class="filename">/usr/lib/kernel/install.d/</code>. This can be used to override a system-supplied
32 executables with a local file if needed; a symbolic link in <code class="filename">/etc/kernel/install.d/</code>
33 with the same name as an executable in <code class="filename">/usr/lib/kernel/install.d/</code>,
34 pointing to /dev/null, disables the executable entirely. Executables must have the
f47781d8 35 extension "<code class="literal">.install</code>"; other extensions are ignored.</p></div><div class="refsect1"><a name="idm139974439924208"></a><h2 id="Commands">Commands<a class="headerlink" title="Permalink to this headline" href="#Commands">¶</a></h2><p>The following commands are understood:</p><div class="variablelist"><dl class="variablelist"><dt id="add KERNEL-VERSION KERNEL-IMAGE"><span class="term"><span class="command"><strong>add <em class="replaceable"><code>KERNEL-VERSION</code></em> <em class="replaceable"><code>KERNEL-IMAGE</code></em></strong></span></span><a class="headerlink" title="Permalink to this term" href="#add%20KERNEL-VERSION%20KERNEL-IMAGE">¶</a></dt><dd><p><span class="command"><strong>kernel-install</strong></span> creates the directory
663996b3
MS		 36 <code class="filename">/boot/<em class="replaceable"><code>MACHINE-ID</code></em>/<em class="replaceable"><code>KERNEL-VERSION</code></em>/</code>
37 and calls every executable
38 <code class="filename">/usr/lib/kernel/install.d/*.install</code> and
39 <code class="filename">/etc/kernel/install.d/*.install</code> with
40 the arguments
60f067b4 41 </p><pre class="programlisting">add <em class="replaceable"><code>KERNEL-VERSION</code></em> <code class="filename">/boot/<em class="replaceable"><code>MACHINE-ID</code></em>/<em class="replaceable"><code>KERNEL-VERSION</code></em>/</code></pre><p>
e842803a
MB		 42 </p><p>The kernel-install plugin <code class="filename">50-depmod.install</code> runs depmod for the <em class="replaceable"><code>KERNEL-VERSION</code></em>.</p><p>The kernel-install plugin
43 <code class="filename">90-loaderentry.install</code> copies
663996b3
MS		 44 <em class="replaceable"><code>KERNEL-IMAGE</code></em> to
45 <code class="filename">/boot/<em class="replaceable"><code>MACHINE-ID</code></em>/<em class="replaceable"><code>KERNEL-VERSION</code></em>/linux</code>.
e842803a
MB		 46 It also creates a boot loader entry according to the boot
47 loader specification in
663996b3 48 <code class="filename">/boot/loader/entries/<em class="replaceable"><code>MACHINE-ID</code></em>-<em class="replaceable"><code>KERNEL-VERSION</code></em>.conf</code>.
e842803a
MB		 49 The title of the entry is the
50 <em class="replaceable"><code>PRETTY_NAME</code></em> parameter specified
51 in <code class="filename">/etc/os-release</code> or
52 <code class="filename">/usr/lib/os-release</code> (if the former is
53 missing), or "Linux
54 <em class="replaceable"><code>KERNEL-VERSION</code></em>", if unset. If
55 the file <code class="filename">initrd</code> is found next to the
663996b3 56 <code class="filename">linux</code> file, the initrd will be added to
14228c0d 57 the configuration.</p></dd><dt id="remove KERNEL-VERSION"><span class="term"><span class="command"><strong>remove <em class="replaceable"><code>KERNEL-VERSION</code></em></strong></span></span><a class="headerlink" title="Permalink to this term" href="#remove%20KERNEL-VERSION">¶</a></dt><dd><p>Calls every executable <code class="filename">/usr/lib/kernel/install.d/*.install</code>
663996b3 58 and <code class="filename">/etc/kernel/install.d/*.install</code> with the arguments
60f067b4 59 </p><pre class="programlisting">remove <em class="replaceable"><code>KERNEL-VERSION</code></em> <code class="filename">/boot/<em class="replaceable"><code>MACHINE-ID</code></em>/<em class="replaceable"><code>KERNEL-VERSION</code></em>/</code></pre><p>
663996b3
MS		 60 </p><p><span class="command"><strong>kernel-install</strong></span> removes the entire directory
61 <code class="filename">/boot/<em class="replaceable"><code>MACHINE-ID</code></em>/<em class="replaceable"><code>KERNEL-VERSION</code></em>/</code> afterwards.</p><p>The kernel-install plugin <code class="filename">90-loaderentry.install</code> removes the file
f47781d8 62 <code class="filename">/boot/loader/entries/<em class="replaceable"><code>MACHINE-ID</code></em>-<em class="replaceable"><code>KERNEL-VERSION</code></em>.conf</code>.</p></dd></dl></div></div><div class="refsect1"><a name="idm139974443844448"></a><h2 id="Exit status">Exit status<a class="headerlink" title="Permalink to this headline" href="#Exit%20status">¶</a></h2><p>If every executable returns with 0, 0 is returned, a non-zero failure code otherwise.</p></div><div class="refsect1"><a name="idm139974443843264"></a><h2 id="Files">Files<a class="headerlink" title="Permalink to this headline" href="#Files">¶</a></h2><div class="variablelist"><dl class="variablelist"><dt id="
663996b3
MS		 63 /usr/lib/kernel/install.d/*.install
64 /etc/kernel/install.d/*.install
65 "><span class="term">
66 <code class="filename">/usr/lib/kernel/install.d/*.install</code>
67 <code class="filename">/etc/kernel/install.d/*.install</code>
14228c0d 68 </span><a class="headerlink" title="Permalink to this term" href="#%0A%20%20%20%20%20%20%20%20%20%20/usr/lib/kernel/install.d/*.install%0A%20%20%20%20%20%20%20%20%20%20/etc/kernel/install.d/*.install%0A%20%20%20%20%20%20%20%20">¶</a></dt><dd><p>Drop-in files which are executed by kernel-install.</p></dd><dt id="
663996b3
MS		 69 /etc/kernel/cmdline
70 /proc/cmdline
71 "><span class="term">
72 <code class="filename">/etc/kernel/cmdline</code>
73 <code class="filename">/proc/cmdline</code>
74 </span><a class="headerlink" title="Permalink to this term" href="#%0A%20%20%20%20%20%20%20%20%20%20/etc/kernel/cmdline%0A%20%20%20%20%20%20%20%20%20%20/proc/cmdline%0A%20%20%20%20%20%20%20%20">¶</a></dt><dd><p>The content of the file <code class="filename">/etc/kernel/cmdline</code> specifies the kernel command line to use.
75 If that file does not exist, <code class="filename">/proc/cmdline</code> is used.</p></dd><dt id="
76 /etc/machine-id
77 "><span class="term">
78 <code class="filename">/etc/machine-id</code>
79 </span><a class="headerlink" title="Permalink to this term" href="#%0A%20%20%20%20%20%20%20%20%20%20/etc/machine-id%0A%20%20%20%20%20%20%20%20">¶</a></dt><dd><p>The content of the file specifies the machine identification <em class="replaceable"><code>MACHINE-ID</code></em>.</p></dd><dt id="
80 /etc/os-release
e842803a 81 /usr/lib/os-release
663996b3
MS		 82 "><span class="term">
83 <code class="filename">/etc/os-release</code>
e842803a 84 <code class="filename">/usr/lib/os-release</code>
f47781d8 85 </span><a class="headerlink" title="Permalink to this term" href="#%0A%20%20%20%20%20%20%20%20%20%20/etc/os-release%0A%20%20%20%20%20%20%20%20%20%20/usr/lib/os-release%0A%20%20%20%20%20%20%20%20">¶</a></dt><dd><p>The content of the file specifies the operating system title <em class="replaceable"><code>PRETTY_NAME</code></em>.</p></dd></dl></div></div><div class="refsect1"><a name="idm139974438859200"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
663996b3
MS		 86 <a href="machine-id.html"><span class="citerefentry"><span class="refentrytitle">machine-id</span>(5)</span></a>,
87 <a href="os-release.html"><span class="citerefentry"><span class="refentrytitle">os-release</span>(5)</span></a>,
88 <a class="ulink" href="http://www.freedesktop.org/wiki/Specifications/BootLoaderSpec" target="_top">Boot loader specification</a>
89 </p></div></div></body></html>
systemd for Proxmox projects