[thirdparty/systemd.git] / man / kernel-install.xml

<?xml version='1.0'?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
  "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
<!-- SPDX-License-Identifier: LGPL-2.1+ -->

<refentry id="kernel-install"
          xmlns:xi="http://www.w3.org/2001/XInclude">

  <refentryinfo>
    <title>kernel-install</title>
    <productname>systemd</productname>
  </refentryinfo>

  <refmeta>
    <refentrytitle>kernel-install</refentrytitle>
    <manvolnum>8</manvolnum>
  </refmeta>

  <refnamediv>
    <refname>kernel-install</refname>
    <refpurpose>Add and remove kernel and initramfs images to and from /boot</refpurpose>
  </refnamediv>

  <refsynopsisdiv>
    <cmdsynopsis>
      <command>kernel-install</command>
      <arg choice="plain">COMMAND</arg>
      <arg choice="opt" rep="repeat">OPTIONS</arg>
      <arg choice="plain"><replaceable>KERNEL-VERSION</replaceable></arg>
      <arg choice="plain"><replaceable>KERNEL-IMAGE</replaceable></arg>
      <arg choice="opt" rep="repeat"><replaceable>INITRD-FILE</replaceable></arg>
    </cmdsynopsis>
  </refsynopsisdiv>

  <refsect1>
    <title>Description</title>
    <para><command>kernel-install</command> is used to install and remove kernel and initramfs images to and
    from the boot loader partition, referred to as <varname>$BOOT</varname> here. It will usually be one of
    <filename>/boot</filename>, <filename>/efi</filename>, or <filename>/boot/efi</filename>, see below.
    </para>

    <para><command>kernel-install</command> will execute the files
    located in the directory <filename>/usr/lib/kernel/install.d/</filename>
    and the local administration directory <filename>/etc/kernel/install.d/</filename>.
    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 <filename>/etc/kernel/install.d/</filename> take precedence over files with the same name
    in <filename>/usr/lib/kernel/install.d/</filename>. This can be used to override a system-supplied
    executables with a local file if needed; a symbolic link in <filename>/etc/kernel/install.d/</filename>
    with the same name as an executable in <filename>/usr/lib/kernel/install.d/</filename>,
    pointing to <filename>/dev/null</filename>, disables the executable entirely. Executables must have the
    extension <literal>.install</literal>; other extensions are ignored.</para>

    <para>An executable should return <constant>0</constant> on success. It may also
    return <constant>77</constant> to cause the whole operation to terminate
    (executables later in lexical order will be skipped).</para>
  </refsect1>

  <refsect1>
    <title>Commands</title>
    <para>The following commands are understood:</para>
    <variablelist>
      <varlistentry>
        <term><command>add <replaceable>KERNEL-VERSION</replaceable> <replaceable>KERNEL-IMAGE</replaceable> [<replaceable>INITRD-FILE</replaceable> ...]</command></term>
        <listitem>
          <para>This command expects a kernel version string and a path to a kernel image file as
          arguments. <command>kernel-install</command> calls the executables from
          <filename>/usr/lib/kernel/install.d/*.install</filename> and
          <filename>/etc/kernel/install.d/*.install</filename> with the following arguments:

          <programlisting>add <replaceable>KERNEL-VERSION</replaceable> <filename>$BOOT/<replaceable>MACHINE-ID</replaceable>/<replaceable>KERNEL-VERSION</replaceable>/</filename> <replaceable>KERNEL-IMAGE</replaceable> [<replaceable>INITRD-FILE</replaceable> ...]</programlisting>
          </para>

          <para>Three default plugins execute the following operations in this case:</para>

          <itemizedlist>
            <listitem><para><filename>00-entry-directory.install</filename> creates the directory
            <filename>$BOOT/<replaceable>MACHINE-ID</replaceable>/<replaceable>KERNEL-VERSION</replaceable>/</filename>
            if <filename>$BOOT/<replaceable>MACHINE-ID</replaceable>/</filename> already exists.
            </para></listitem>

            <listitem><para><filename>50-depmod.install</filename> runs
            <citerefentry><refentrytitle>depmod</refentrytitle><manvolnum>8</manvolnum></citerefentry> for the
            <replaceable>KERNEL-VERSION</replaceable>.</para></listitem>

            <listitem><para><filename>90-loaderentry.install</filename> copies <replaceable>KERNEL-IMAGE</replaceable>
            to
            <filename>$BOOT/<replaceable>MACHINE-ID</replaceable>/<replaceable>KERNEL-VERSION</replaceable>/linux</filename>.
            If an <replaceable>INITRD-FILE</replaceable> is provided, it also copies <replaceable>INITRD-FILE</replaceable>
            to
            <filename>$BOOT/<replaceable>MACHINE-ID</replaceable>/<replaceable>KERNEL_VERSION</replaceable>/<replaceable>INITRD-FILE</replaceable></filename>.
            It also creates a boot loader entry according to the <ulink
            url="https://systemd.io/BOOT_LOADER_SPECIFICATION">Boot Loader Specification</ulink> in
            <filename>$BOOT/loader/entries/<replaceable>MACHINE-ID</replaceable>-<replaceable>KERNEL-VERSION</replaceable>.conf</filename>.
            The title of the entry is the <replaceable>PRETTY_NAME</replaceable> parameter specified in
            <filename>/etc/os-release</filename> or <filename>/usr/lib/os-release</filename> (if the former is
            missing), or "Linux <replaceable>KERNEL-VERSION</replaceable>", if unset.</para>

            <para>If the entry directory
            <filename>$BOOT/<replaceable>MACHINE-ID</replaceable>/<replaceable>KERNEL-VERSION</replaceable>/</filename>
            does not exist, this plugin does nothing.</para></listitem>
          </itemizedlist>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term><command>remove <replaceable>KERNEL-VERSION</replaceable></command></term>
        <listitem>
          <para>This command expects a kernel version string as single argument. This calls executables from
          <filename>/usr/lib/kernel/install.d/*.install</filename> and
          <filename>/etc/kernel/install.d/*.install</filename> with the following arguments:

          <programlisting>remove <replaceable>KERNEL-VERSION</replaceable> <filename>$BOOT/<replaceable>MACHINE-ID</replaceable>/<replaceable>KERNEL-VERSION</replaceable>/</filename></programlisting>
          </para>

          <para>Afterwards, <command>kernel-install</command> removes the directory
          <filename>$BOOT/<replaceable>MACHINE-ID</replaceable>/<replaceable>KERNEL-VERSION</replaceable>/</filename>
          and its contents.</para>

          <para>Two default plugins execute the following operations in this case:</para>

          <itemizedlist>

            <listitem><para><filename>50-depmod.install</filename> removes the files generated by <command>depmod</command> for this kernel again.</para></listitem>

            <listitem><para><filename>90-loaderentry.install</filename> removes the file
            <filename>$BOOT/loader/entries/<replaceable>MACHINE-ID</replaceable>-<replaceable>KERNEL-VERSION</replaceable>.conf</filename>.</para></listitem>
          </itemizedlist>

        </listitem>
      </varlistentry>

    </variablelist>
  </refsect1>

  <refsect1>
    <title>The <varname>$BOOT</varname> partition</title>
    <para>The partition where the kernels and <ulink url="https://systemd.io/BOOT_LOADER_SPECIFICATION">Boot
    Loader Specification</ulink> snippets are located is called <varname>$BOOT</varname>.
    <command>kernel-install</command> determines the location of this partition by checking
    <filename>/efi/</filename>, <filename>/boot/</filename>, and <filename>/boot/efi</filename>
    in turn. The first location where <filename>$BOOT/loader/entries/</filename> or
    <filename>$BOOT/$MACHINE_ID/</filename> exists is used.</para>
  </refsect1>

  <refsect1>
    <title>Options</title>
    <para>The following options are understood:</para>

    <variablelist>
      <varlistentry>
        <term><option>-v</option></term>
        <term><option>--verbose</option></term>
        <listitem>
          <para>Output additional information about operations being performed.</para>
        </listitem>
      </varlistentry>

      <xi:include href="standard-options.xml" xpointer="help" />
    </variablelist>
  </refsect1>

  <refsect1>
    <title>Environment variables</title>
    <para>If <option>--verbose</option> is used, <varname>$KERNEL_INSTALL_VERBOSE=1</varname> will be set for
    the plugins. They may output additional logs in this case.</para>
  </refsect1>

  <refsect1>
    <title>Exit status</title>
    <para>If every executable returns 0 or 77, 0 is returned, and a non-zero failure code otherwise.</para>
  </refsect1>

  <refsect1>
    <title>Files</title>
    <variablelist>
      <varlistentry>
        <term>
          <filename>/usr/lib/kernel/install.d/*.install</filename>
          <filename>/etc/kernel/install.d/*.install</filename>
        </term>
          <listitem>
            <para>Drop-in files which are executed by kernel-install.</para>
          </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <filename>/etc/kernel/cmdline</filename>
          <filename>/proc/cmdline</filename>
        </term>
          <listitem>
            <para>Read by <filename>90-loaderentry.install</filename>. The content of the file
            <filename>/etc/kernel/cmdline</filename> specifies the kernel command line to use.  If that file does not
            exist, <filename>/proc/cmdline</filename> is used.</para>
          </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <filename>/etc/kernel/tries</filename>
        </term>
          <listitem>
            <para>Read by <filename>90-loaderentry.install</filename>. If this file exists a numeric value is read from
            it and the naming of the generated entry file is slightly altered to include it as
            <filename>$BOOT/loader/entries/<replaceable>MACHINE-ID</replaceable>-<replaceable>KERNEL-VERSION</replaceable>+<replaceable>TRIES</replaceable>.conf</filename>. This
            is useful for boot loaders such as
            <citerefentry><refentrytitle>systemd-boot</refentrytitle><manvolnum>7</manvolnum></citerefentry> which
            implement boot attempt counting with a counter embedded in the entry file name.</para>
          </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <filename>/etc/machine-id</filename>
        </term>
          <listitem>
            <para>The content of the file specifies the machine identification <replaceable>MACHINE-ID</replaceable>.</para>
          </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <filename>/etc/os-release</filename>
          <filename>/usr/lib/os-release</filename>
        </term>
          <listitem>
            <para>The content of the file specifies the operating system title <replaceable>PRETTY_NAME</replaceable>.</para>
          </listitem>
      </varlistentry>
    </variablelist>
  </refsect1>

  <refsect1>
    <title>See Also</title>
    <para>
      <citerefentry><refentrytitle>machine-id</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
      <citerefentry><refentrytitle>os-release</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
      <citerefentry><refentrytitle>depmod</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
      <citerefentry><refentrytitle>systemd-boot</refentrytitle><manvolnum>7</manvolnum></citerefentry>,
      <ulink url="https://systemd.io/BOOT_LOADER_SPECIFICATION">Boot Loader Specification</ulink>
    </para>
  </refsect1>

</refentry>
Commit	Line	Data
514094f9	1	<?xml version='1.0'?>
3a54a157 ZJS	2	<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3a54a157 ZJS	3	"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
0307f791	4	<!-- SPDX-License-Identifier: LGPL-2.1+ -->
81516adc	5
7054308a ZJS	6	<refentry id="kernel-install"
7054308a ZJS	7	xmlns:xi="http://www.w3.org/2001/XInclude">
81516adc HH	8
	9	<refentryinfo>
	10	<title>kernel-install</title>
	11	<productname>systemd</productname>
81516adc HH	12	</refentryinfo>
	13
	14	<refmeta>
	15	<refentrytitle>kernel-install</refentrytitle>
	16	<manvolnum>8</manvolnum>
	17	</refmeta>
	18
	19	<refnamediv>
	20	<refname>kernel-install</refname>
	21	<refpurpose>Add and remove kernel and initramfs images to and from /boot</refpurpose>
	22	</refnamediv>
	23
	24	<refsynopsisdiv>
	25	<cmdsynopsis>
845c5324 ZJS	26	<command>kernel-install</command>
845c5324 ZJS	27	<arg choice="plain">COMMAND</arg>
7054308a	28	<arg choice="opt" rep="repeat">OPTIONS</arg>
845c5324	29	<arg choice="plain"><replaceable>KERNEL-VERSION</replaceable></arg>
04ca4d19	30	<arg choice="plain"><replaceable>KERNEL-IMAGE</replaceable></arg>
0912c0b8	31	<arg choice="opt" rep="repeat"><replaceable>INITRD-FILE</replaceable></arg>
81516adc HH	32	</cmdsynopsis>
	33	</refsynopsisdiv>
	34
	35	<refsect1>
	36	<title>Description</title>
694fe6da ZJS	37	<para><command>kernel-install</command> is used to install and remove kernel and initramfs images to and
	38	from the boot loader partition, referred to as <varname>$BOOT</varname> here. It will usually be one of
	39	<filename>/boot</filename>, <filename>/efi</filename>, or <filename>/boot/efi</filename>, see below.
81516adc HH	40	</para>
81516adc HH	41
845c5324 ZJS	42	<para><command>kernel-install</command> will execute the files
845c5324 ZJS	43	located in the directory <filename>/usr/lib/kernel/install.d/</filename>
81516adc	44	and the local administration directory <filename>/etc/kernel/install.d/</filename>.
845c5324	45	All files are collectively sorted and executed in lexical order, regardless of the directory in
e9dd9f95	46	which they live. However, files with identical filenames replace each other.
81516adc HH	47	Files in <filename>/etc/kernel/install.d/</filename> take precedence over files with the same name
	48	in <filename>/usr/lib/kernel/install.d/</filename>. This can be used to override a system-supplied
	49	executables with a local file if needed; a symbolic link in <filename>/etc/kernel/install.d/</filename>
	50	with the same name as an executable in <filename>/usr/lib/kernel/install.d/</filename>,
eb933128	51	pointing to <filename>/dev/null</filename>, disables the executable entirely. Executables must have the
409dee2e	52	extension <literal>.install</literal>; other extensions are ignored.</para>
81516adc	53
eb933128 ZJS	54	<para>An executable should return <constant>0</constant> on success. It may also
	55	return <constant>77</constant> to cause the whole operation to terminate
	56	(executables later in lexical order will be skipped).</para>
81516adc HH	57	</refsect1>
	58
	59	<refsect1>
	60	<title>Commands</title>
	61	<para>The following commands are understood:</para>
	62	<variablelist>
	63	<varlistentry>
0912c0b8	64	<term><command>add <replaceable>KERNEL-VERSION</replaceable> <replaceable>KERNEL-IMAGE</replaceable> [<replaceable>INITRD-FILE</replaceable> ...]</command></term>
81516adc	65	<listitem>
4b2d80bb	66	<para>This command expects a kernel version string and a path to a kernel image file as
cf73f650 ZJS	67	arguments. <command>kernel-install</command> calls the executables from
cf73f650 ZJS	68	<filename>/usr/lib/kernel/install.d/*.install</filename> and
4b2d80bb LP	69	<filename>/etc/kernel/install.d/*.install</filename> with the following arguments:
4b2d80bb LP	70
694fe6da	71	<programlisting>add <replaceable>KERNEL-VERSION</replaceable> <filename>$BOOT/<replaceable>MACHINE-ID</replaceable>/<replaceable>KERNEL-VERSION</replaceable>/</filename> <replaceable>KERNEL-IMAGE</replaceable> [<replaceable>INITRD-FILE</replaceable> ...]</programlisting>
845c5324 ZJS	72	</para>
845c5324 ZJS	73
cf73f650	74	<para>Three default plugins execute the following operations in this case:</para>
4b2d80bb LP	75
4b2d80bb LP	76	<itemizedlist>
cf73f650	77	<listitem><para><filename>00-entry-directory.install</filename> creates the directory
694fe6da ZJS	78	<filename>$BOOT/<replaceable>MACHINE-ID</replaceable>/<replaceable>KERNEL-VERSION</replaceable>/</filename>
694fe6da ZJS	79	if <filename>$BOOT/<replaceable>MACHINE-ID</replaceable>/</filename> already exists.
cf73f650	80	</para></listitem>
4b2d80bb LP	81
	82	<listitem><para><filename>50-depmod.install</filename> runs
	83	<citerefentry><refentrytitle>depmod</refentrytitle><manvolnum>8</manvolnum></citerefentry> for the
	84	<replaceable>KERNEL-VERSION</replaceable>.</para></listitem>
	85
	86	<listitem><para><filename>90-loaderentry.install</filename> copies <replaceable>KERNEL-IMAGE</replaceable>
	87	to
694fe6da	88	<filename>$BOOT/<replaceable>MACHINE-ID</replaceable>/<replaceable>KERNEL-VERSION</replaceable>/linux</filename>.
0912c0b8	89	If an <replaceable>INITRD-FILE</replaceable> is provided, it also copies <replaceable>INITRD-FILE</replaceable>
04ca4d19	90	to
694fe6da	91	<filename>$BOOT/<replaceable>MACHINE-ID</replaceable>/<replaceable>KERNEL_VERSION</replaceable>/<replaceable>INITRD-FILE</replaceable></filename>.
4b2d80bb LP	92	It also creates a boot loader entry according to the <ulink
4b2d80bb LP	93	url="https://systemd.io/BOOT_LOADER_SPECIFICATION">Boot Loader Specification</ulink> in
694fe6da	94	<filename>$BOOT/loader/entries/<replaceable>MACHINE-ID</replaceable>-<replaceable>KERNEL-VERSION</replaceable>.conf</filename>.
4b2d80bb LP	95	The title of the entry is the <replaceable>PRETTY_NAME</replaceable> parameter specified in
4b2d80bb LP	96	<filename>/etc/os-release</filename> or <filename>/usr/lib/os-release</filename> (if the former is
cf73f650 ZJS	97	missing), or "Linux <replaceable>KERNEL-VERSION</replaceable>", if unset.</para>
	98
	99	<para>If the entry directory
694fe6da	100	<filename>$BOOT/<replaceable>MACHINE-ID</replaceable>/<replaceable>KERNEL-VERSION</replaceable>/</filename>
cf73f650	101	does not exist, this plugin does nothing.</para></listitem>
4b2d80bb	102	</itemizedlist>
81516adc HH	103	</listitem>
	104	</varlistentry>
	105	<varlistentry>
8f51399e	106	<term><command>remove <replaceable>KERNEL-VERSION</replaceable></command></term>
845c5324	107	<listitem>
4b2d80bb LP	108	<para>This command expects a kernel version string as single argument. This calls executables from
	109	<filename>/usr/lib/kernel/install.d/*.install</filename> and
	110	<filename>/etc/kernel/install.d/*.install</filename> with the following arguments:
	111
694fe6da	112	<programlisting>remove <replaceable>KERNEL-VERSION</replaceable> <filename>$BOOT/<replaceable>MACHINE-ID</replaceable>/<replaceable>KERNEL-VERSION</replaceable>/</filename></programlisting>
845c5324 ZJS	113	</para>
845c5324 ZJS	114
4b2d80bb	115	<para>Afterwards, <command>kernel-install</command> removes the directory
694fe6da	116	<filename>$BOOT/<replaceable>MACHINE-ID</replaceable>/<replaceable>KERNEL-VERSION</replaceable>/</filename>
4b2d80bb LP	117	and its contents.</para>
	118
	119	<para>Two default plugins execute the following operations in this case:</para>
	120
	121	<itemizedlist>
	122
	123	<listitem><para><filename>50-depmod.install</filename> removes the files generated by <command>depmod</command> for this kernel again.</para></listitem>
	124
	125	<listitem><para><filename>90-loaderentry.install</filename> removes the file
694fe6da	126	<filename>$BOOT/loader/entries/<replaceable>MACHINE-ID</replaceable>-<replaceable>KERNEL-VERSION</replaceable>.conf</filename>.</para></listitem>
4b2d80bb	127	</itemizedlist>
8f51399e	128
81516adc HH	129	</listitem>
	130	</varlistentry>
	131
	132	</variablelist>
694fe6da	133	</refsect1>
81516adc	134
694fe6da ZJS	135	<refsect1>
	136	<title>The <varname>$BOOT</varname> partition</title>
	137	<para>The partition where the kernels and <ulink url="https://systemd.io/BOOT_LOADER_SPECIFICATION">Boot
	138	Loader Specification</ulink> snippets are located is called <varname>$BOOT</varname>.
	139	<command>kernel-install</command> determines the location of this partition by checking
	140	<filename>/efi/</filename>, <filename>/boot/</filename>, and <filename>/boot/efi</filename>
	141	in turn. The first location where <filename>$BOOT/loader/entries/</filename> or
	142	<filename>$BOOT/$MACHINE_ID/</filename> exists is used.</para>
81516adc HH	143	</refsect1>
81516adc HH	144
7054308a ZJS	145	<refsect1>
	146	<title>Options</title>
	147	<para>The following options are understood:</para>
	148
	149	<variablelist>
	150	<varlistentry>
	151	<term><option>-v</option></term>
	152	<term><option>--verbose</option></term>
	153	<listitem>
	154	<para>Output additional information about operations being performed.</para>
	155	</listitem>
	156	</varlistentry>
	157
	158	<xi:include href="standard-options.xml" xpointer="help" />
	159	</variablelist>
	160	</refsect1>
	161
	162	<refsect1>
	163	<title>Environment variables</title>
	164	<para>If <option>--verbose</option> is used, <varname>$KERNEL_INSTALL_VERBOSE=1</varname> will be set for
	165	the plugins. They may output additional logs in this case.</para>
	166	</refsect1>
	167
81516adc HH	168	<refsect1>
81516adc HH	169	<title>Exit status</title>
c4c50112	170	<para>If every executable returns 0 or 77, 0 is returned, and a non-zero failure code otherwise.</para>
81516adc HH	171	</refsect1>
	172
	173	<refsect1>
	174	<title>Files</title>
	175	<variablelist>
	176	<varlistentry>
	177	<term>
	178	<filename>/usr/lib/kernel/install.d/*.install</filename>
	179	<filename>/etc/kernel/install.d/*.install</filename>
	180	</term>
	181	<listitem>
409dee2e	182	<para>Drop-in files which are executed by kernel-install.</para>
81516adc HH	183	</listitem>
81516adc HH	184	</varlistentry>
2d0614d3 HH	185	<varlistentry>
	186	<term>
	187	<filename>/etc/kernel/cmdline</filename>
	188	<filename>/proc/cmdline</filename>
	189	</term>
	190	<listitem>
4b2d80bb LP	191	<para>Read by <filename>90-loaderentry.install</filename>. The content of the file
	192	<filename>/etc/kernel/cmdline</filename> specifies the kernel command line to use. If that file does not
	193	exist, <filename>/proc/cmdline</filename> is used.</para>
	194	</listitem>
	195	</varlistentry>
	196	<varlistentry>
	197	<term>
	198	<filename>/etc/kernel/tries</filename>
	199	</term>
	200	<listitem>
	201	<para>Read by <filename>90-loaderentry.install</filename>. If this file exists a numeric value is read from
	202	it and the naming of the generated entry file is slightly altered to include it as
694fe6da	203	<filename>$BOOT/loader/entries/<replaceable>MACHINE-ID</replaceable>-<replaceable>KERNEL-VERSION</replaceable>+<replaceable>TRIES</replaceable>.conf</filename>. This
4b2d80bb LP	204	is useful for boot loaders such as
	205	<citerefentry><refentrytitle>systemd-boot</refentrytitle><manvolnum>7</manvolnum></citerefentry> which
	206	implement boot attempt counting with a counter embedded in the entry file name.</para>
2d0614d3 HH	207	</listitem>
	208	</varlistentry>
	209	<varlistentry>
	210	<term>
	211	<filename>/etc/machine-id</filename>
	212	</term>
	213	<listitem>
845c5324	214	<para>The content of the file specifies the machine identification <replaceable>MACHINE-ID</replaceable>.</para>
2d0614d3 HH	215	</listitem>
	216	</varlistentry>
	217	<varlistentry>
	218	<term>
	219	<filename>/etc/os-release</filename>
5ae4d543	220	<filename>/usr/lib/os-release</filename>
2d0614d3 HH	221	</term>
2d0614d3 HH	222	<listitem>
8f51399e	223	<para>The content of the file specifies the operating system title <replaceable>PRETTY_NAME</replaceable>.</para>
2d0614d3 HH	224	</listitem>
2d0614d3 HH	225	</varlistentry>
81516adc HH	226	</variablelist>
	227	</refsect1>
	228
	229	<refsect1>
	230	<title>See Also</title>
	231	<para>
2d0614d3 HH	232	<citerefentry><refentrytitle>machine-id</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
2d0614d3 HH	233	<citerefentry><refentrytitle>os-release</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
4b2d80bb LP	234	<citerefentry><refentrytitle>depmod</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
4b2d80bb LP	235	<citerefentry><refentrytitle>systemd-boot</refentrytitle><manvolnum>7</manvolnum></citerefentry>,
a0848495	236	<ulink url="https://systemd.io/BOOT_LOADER_SPECIFICATION">Boot Loader Specification</ulink>
81516adc HH	237	</para>
	238	</refsect1>
	239
	240	</refentry>