systemd/man/systemd-system-update-generator.xml

<?xml version="1.0"?>
<!--*-nxml-*-->
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
<!--
  SPDX-License-Identifier: LGPL-2.1+
-->
<refentry id="systemd-system-update-generator">

  <refentryinfo>
    <title>systemd-system-update-generator</title>
    <productname>systemd</productname>

    <authorgroup>
      <author>
        <contrib>Developer</contrib>
        <firstname>Lennart</firstname>
        <surname>Poettering</surname>
        <email>lennart@poettering.net</email>
      </author>
    </authorgroup>
  </refentryinfo>

  <refmeta>
    <refentrytitle>systemd-system-update-generator</refentrytitle>
    <manvolnum>8</manvolnum>
  </refmeta>

  <refnamediv>
    <refname>systemd-system-update-generator</refname>
    <refpurpose>Generator for redirecting boot to offline update mode</refpurpose>
  </refnamediv>

  <refsynopsisdiv>
    <para><filename>/usr/lib/systemd/system-generators/systemd-system-update-generator</filename></para>
  </refsynopsisdiv>

  <refsect1>
    <title>Description</title>

    <para><filename>systemd-system-update-generator</filename> is a
    generator that automatically redirects the boot process to
    <filename>system-update.target</filename>, if
    <filename>/system-update</filename> exists. This is required to
    implement the logic explained in the
    <citerefentry><refentrytitle>systemd.offline-updates</refentrytitle><manvolnum>7</manvolnum></citerefentry>.
    </para>

    <para><filename>systemd-system-update-generator</filename> implements
    <citerefentry><refentrytitle>systemd.generator</refentrytitle><manvolnum>7</manvolnum></citerefentry>.</para>
  </refsect1>

  <refsect1>
    <title>See Also</title>
    <para>
      <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
      <citerefentry><refentrytitle>systemd.special</refentrytitle><manvolnum>7</manvolnum></citerefentry>
    </para>
  </refsect1>

</refentry>
man: document systemd-update-generator 2012-06-27 21:12:29 +08:00			`<?xml version="1.0"?>`
			`<!---nxml--->`
man: revert dynamic paths for split-usr setups This did not really work out as we had hoped. Trying to do this upstream introduced several problems that probably makes it better suited as a downstream patch after all. At any rate, it is not releaseable in the current state, so we at least need to revert this before the release. * by adjusting the path to binaries, but not do the same thing to the search path we end up with inconsistent man-pages. Adjusting the search path too would be quite messy, and it is not at all obvious that this is worth the effort, but at any rate it would have to be done before we could ship this. * this means that distributed man-pages does not make sense as they depend on config options, and for better or worse we are still distributing man pages, so that is something that definitely needs sorting out before we could ship with this patch. * we have long held that split-usr is only minimally supported in order to boot, and something we hope will eventually go away. So before we start adding even more magic/effort in order to make this work nicely, we should probably question if it makes sense at all. 2015-06-19 01:47:44 +08:00			`<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">`
man: document systemd-update-generator 2012-06-27 21:12:29 +08:00			`<!--`
Add SPDX license identifiers to man pages 2017-11-19 00:22:32 +08:00			`SPDX-License-Identifier: LGPL-2.1+`
man: document systemd-update-generator 2012-06-27 21:12:29 +08:00			`-->`
			`<refentry id="systemd-system-update-generator">`

Reindent man pages to 2ch 2015-02-04 10:14:13 +08:00			`<refentryinfo>`
			`<title>systemd-system-update-generator</title>`
			`<productname>systemd</productname>`
man: document systemd-update-generator 2012-06-27 21:12:29 +08:00
Reindent man pages to 2ch 2015-02-04 10:14:13 +08:00			`<authorgroup>`
			`<author>`
			`<contrib>Developer</contrib>`
			`<firstname>Lennart</firstname>`
			`<surname>Poettering</surname>`
			`<email>lennart@poettering.net</email>`
			`</author>`
			`</authorgroup>`
			`</refentryinfo>`
man: document systemd-update-generator 2012-06-27 21:12:29 +08:00
Reindent man pages to 2ch 2015-02-04 10:14:13 +08:00			`<refmeta>`
			`<refentrytitle>systemd-system-update-generator</refentrytitle>`
			`<manvolnum>8</manvolnum>`
			`</refmeta>`
man: document systemd-update-generator 2012-06-27 21:12:29 +08:00
Reindent man pages to 2ch 2015-02-04 10:14:13 +08:00			`<refnamediv>`
			`<refname>systemd-system-update-generator</refname>`
			`<refpurpose>Generator for redirecting boot to offline update mode</refpurpose>`
			`</refnamediv>`
man: document systemd-update-generator 2012-06-27 21:12:29 +08:00
Reindent man pages to 2ch 2015-02-04 10:14:13 +08:00			`<refsynopsisdiv>`
man: revert dynamic paths for split-usr setups This did not really work out as we had hoped. Trying to do this upstream introduced several problems that probably makes it better suited as a downstream patch after all. At any rate, it is not releaseable in the current state, so we at least need to revert this before the release. * by adjusting the path to binaries, but not do the same thing to the search path we end up with inconsistent man-pages. Adjusting the search path too would be quite messy, and it is not at all obvious that this is worth the effort, but at any rate it would have to be done before we could ship this. * this means that distributed man-pages does not make sense as they depend on config options, and for better or worse we are still distributing man pages, so that is something that definitely needs sorting out before we could ship with this patch. * we have long held that split-usr is only minimally supported in order to boot, and something we hope will eventually go away. So before we start adding even more magic/effort in order to make this work nicely, we should probably question if it makes sense at all. 2015-06-19 01:47:44 +08:00			`<para><filename>/usr/lib/systemd/system-generators/systemd-system-update-generator</filename></para>`
Reindent man pages to 2ch 2015-02-04 10:14:13 +08:00			`</refsynopsisdiv>`
man: document systemd-update-generator 2012-06-27 21:12:29 +08:00
Reindent man pages to 2ch 2015-02-04 10:14:13 +08:00			`<refsect1>`
			`<title>Description</title>`
man: document systemd-update-generator 2012-06-27 21:12:29 +08:00
Reindent man pages to 2ch 2015-02-04 10:14:13 +08:00			`<para><filename>systemd-system-update-generator</filename> is a`
			`generator that automatically redirects the boot process to`
man: punctuation fixes Fixes #3376. 2016-05-29 04:43:22 +08:00			`<filename>system-update.target</filename>, if`
Reindent man pages to 2ch 2015-02-04 10:14:13 +08:00			`<filename>/system-update</filename> exists. This is required to`
man: cite systemd.offline-updates(7) instead of linking to old wiki page 2016-05-29 04:49:43 +08:00			`implement the logic explained in the`
			`<citerefentry><refentrytitle>systemd.offline-updates</refentrytitle><manvolnum>7</manvolnum></citerefentry>.`
Reindent man pages to 2ch 2015-02-04 10:14:13 +08:00			`</para>`
man: document systemd-update-generator 2012-06-27 21:12:29 +08:00
man: replace obsolete wiki link with man page 2015-03-05 07:43:20 +08:00			`<para><filename>systemd-system-update-generator</filename> implements`
			`<citerefentry><refentrytitle>systemd.generator</refentrytitle><manvolnum>7</manvolnum></citerefentry>.</para>`
Reindent man pages to 2ch 2015-02-04 10:14:13 +08:00			`</refsect1>`
man: document systemd-update-generator 2012-06-27 21:12:29 +08:00
Reindent man pages to 2ch 2015-02-04 10:14:13 +08:00			`<refsect1>`
			`<title>See Also</title>`
			`<para>`
			`<citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,`
			`<citerefentry><refentrytitle>systemd.special</refentrytitle><manvolnum>7</manvolnum></citerefentry>`
			`</para>`
			`</refsect1>`
man: document systemd-update-generator 2012-06-27 21:12:29 +08:00
			`</refentry>`