systemd-efi-boot-generator.xml revision 12b42c76672a66c2d4ea7212c14f8f1b5a62b78d
0c27b3fe77ac1d5094ba3521e8142d9e7973133fMark Andrews<!--*-nxml-*-->
0c27b3fe77ac1d5094ba3521e8142d9e7973133fMark Andrews<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
0c27b3fe77ac1d5094ba3521e8142d9e7973133fMark Andrews This file is part of systemd.
1b855974958ebca91882c4b59f66c48dd5784b87Andreas Gustafsson Copyright 2013 Lennart Poettering
1b855974958ebca91882c4b59f66c48dd5784b87Andreas Gustafsson systemd is free software; you can redistribute it and/or modify it
1b855974958ebca91882c4b59f66c48dd5784b87Andreas Gustafsson under the terms of the GNU Lesser General Public License as published by
1b855974958ebca91882c4b59f66c48dd5784b87Andreas Gustafsson the Free Software Foundation; either version 2.1 of the License, or
1b855974958ebca91882c4b59f66c48dd5784b87Andreas Gustafsson (at your option) any later version.
abea3fdc7fafcadf4275a14f261ad6e2332cace4Andreas Gustafsson systemd is distributed in the hope that it will be useful, but
dde525678a94746d4ffefd156a98dc20c96c2b3aDanny Mayer WITHOUT ANY WARRANTY; without even the implied warranty of
abea3fdc7fafcadf4275a14f261ad6e2332cace4Andreas Gustafsson MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
abea3fdc7fafcadf4275a14f261ad6e2332cace4Andreas Gustafsson Lesser General Public License for more details.
abea3fdc7fafcadf4275a14f261ad6e2332cace4Andreas Gustafsson You should have received a copy of the GNU Lesser General Public License
abea3fdc7fafcadf4275a14f261ad6e2332cace4Andreas Gustafsson along with systemd; If not, see <http://www.gnu.org/licenses/>.
abea3fdc7fafcadf4275a14f261ad6e2332cace4Andreas Gustafsson<refentry id="systemd-efi-boot-generator">
abea3fdc7fafcadf4275a14f261ad6e2332cace4Andreas Gustafsson <refentryinfo>
95b6b97ae0942ceb8244693c3d68d2b396af9960Andreas Gustafsson <title>systemd-efi-boot-generator</title>
1b855974958ebca91882c4b59f66c48dd5784b87Andreas Gustafsson </authorgroup>
1b855974958ebca91882c4b59f66c48dd5784b87Andreas Gustafsson </refentryinfo>
1b855974958ebca91882c4b59f66c48dd5784b87Andreas Gustafsson <refentrytitle>systemd-efi-boot-generator</refentrytitle>
95b6b97ae0942ceb8244693c3d68d2b396af9960Andreas Gustafsson <refname>systemd-efi-boot-generator</refname>
1b855974958ebca91882c4b59f66c48dd5784b87Andreas Gustafsson <refpurpose>Generator for automatically mounting the
1b855974958ebca91882c4b59f66c48dd5784b87Andreas Gustafsson EFI System Partition used by the current boot to
1b855974958ebca91882c4b59f66c48dd5784b87Andreas Gustafsson <refsynopsisdiv>
1b855974958ebca91882c4b59f66c48dd5784b87Andreas Gustafsson <para><filename>/usr/lib/systemd/system-generators/systemd-efi-boot-generator</filename></para>
c81bf797a812236e4a6d13a6473bc029d7ce280aAndreas Gustafsson </refsynopsisdiv>
1b855974958ebca91882c4b59f66c48dd5784b87Andreas Gustafsson <para><filename>systemd-efi-boot-generator</filename> is a
1b855974958ebca91882c4b59f66c48dd5784b87Andreas Gustafsson generator that automatically creates mount and automount units for
1b855974958ebca91882c4b59f66c48dd5784b87Andreas Gustafsson the EFI System Partition (ESP), mounting it to
1b855974958ebca91882c4b59f66c48dd5784b87Andreas Gustafsson <filename>/boot</filename>. Note that this generator will execute
5b4397d387b89d696b5eb90c328a385e07d4a380Brian Wellington no operation on non-EFI systems, on systems where the boot loader
5b4397d387b89d696b5eb90c328a385e07d4a380Brian Wellington does not communicate the used ESP to the OS, on systems where
5b4397d387b89d696b5eb90c328a385e07d4a380Brian Wellington <filename>/boot</filename> is an explicitly configured mount (for
5b4397d387b89d696b5eb90c328a385e07d4a380Brian Wellington example, listed in
1b855974958ebca91882c4b59f66c48dd5784b87Andreas Gustafsson <citerefentry project='man-pages'><refentrytitle>fstab</refentrytitle><manvolnum>5</manvolnum></citerefentry>)
1cb5d53b09cded8298285fdcdcc6a261f2b47afbBrian Wellington or where the <filename>/boot</filename> mount point is non-empty.
1cb5d53b09cded8298285fdcdcc6a261f2b47afbBrian Wellington Since this generator creates an automount unit, the mount will
1b855974958ebca91882c4b59f66c48dd5784b87Andreas Gustafsson only be activated on-demand, when accessed.</para>
95b6b97ae0942ceb8244693c3d68d2b396af9960Andreas Gustafsson <para><filename>systemd-efi-boot-generator</filename> implements
c81bf797a812236e4a6d13a6473bc029d7ce280aAndreas Gustafsson <citerefentry><refentrytitle>systemd.generator</refentrytitle><manvolnum>7</manvolnum></citerefentry>.</para>
c81bf797a812236e4a6d13a6473bc029d7ce280aAndreas Gustafsson <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
e4946c508eb331c28ce1f2b05c7e2adfe73fe701Andreas Gustafsson <citerefentry><refentrytitle>systemd.mount</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
e4946c508eb331c28ce1f2b05c7e2adfe73fe701Andreas Gustafsson <citerefentry><refentrytitle>systemd.automount</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
e4946c508eb331c28ce1f2b05c7e2adfe73fe701Andreas Gustafsson <citerefentry><refentrytitle>systemd-gpt-auto-generator</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
e4946c508eb331c28ce1f2b05c7e2adfe73fe701Andreas Gustafsson <citerefentry project='man-pages'><refentrytitle>fstab</refentrytitle><manvolnum>5</manvolnum></citerefentry>