man/kernel-install.html

   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>·
  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>
  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
  29     which they live. However, files with identical filenames replace each other.
  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
  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
  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
  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>
  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
  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>.
  46           It also creates a boot loader entry according to the boot
  47           loader specification in
  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>.
  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
  56           <code class="filename">linux</code> file, the initrd will be added to
  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>
  58           and <code class="filename">/etc/kernel/install.d/*.install</code> with the arguments
  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>
  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
  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="
  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>
  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="
  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
  81           /usr/lib/os-release
  82         "><span class="term">
  83           <code class="filename">/etc/os-release</code>
  84           <code class="filename">/usr/lib/os-release</code>
  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>
  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>