7caa86ac4d19f65e396d759bfb02b96646fc09ebLennart Poettering<!--*-nxml-*-->
12b42c76672a66c2d4ea7212c14f8f1b5a62b78dTom Gundersen<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
7caa86ac4d19f65e396d759bfb02b96646fc09ebLennart Poettering This file is part of systemd.
7caa86ac4d19f65e396d759bfb02b96646fc09ebLennart Poettering Copyright 2014 Lennart Poettering
7caa86ac4d19f65e396d759bfb02b96646fc09ebLennart Poettering systemd is free software; you can redistribute it and/or modify it
7caa86ac4d19f65e396d759bfb02b96646fc09ebLennart Poettering under the terms of the GNU Lesser General Public License as published by
7caa86ac4d19f65e396d759bfb02b96646fc09ebLennart Poettering the Free Software Foundation; either version 2.1 of the License, or
7caa86ac4d19f65e396d759bfb02b96646fc09ebLennart Poettering (at your option) any later version.
7caa86ac4d19f65e396d759bfb02b96646fc09ebLennart Poettering systemd is distributed in the hope that it will be useful, but
7caa86ac4d19f65e396d759bfb02b96646fc09ebLennart Poettering WITHOUT ANY WARRANTY; without even the implied warranty of
7caa86ac4d19f65e396d759bfb02b96646fc09ebLennart Poettering MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
7caa86ac4d19f65e396d759bfb02b96646fc09ebLennart Poettering Lesser General Public License for more details.
7caa86ac4d19f65e396d759bfb02b96646fc09ebLennart Poettering You should have received a copy of the GNU Lesser General Public License
7caa86ac4d19f65e396d759bfb02b96646fc09ebLennart Poettering along with systemd; If not, see <http://www.gnu.org/licenses/>.
7caa86ac4d19f65e396d759bfb02b96646fc09ebLennart Poettering<refentry id="systemd-update-done.service">
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <title>systemd-update-done.service</title>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <productname>systemd</productname>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <email>lennart@poettering.net</email>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refentrytitle>systemd-update-done.service</refentrytitle>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refname>systemd-update-done.service</refname>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refname>systemd-update-done</refname>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refpurpose>Mark <filename>/etc</filename> and <filename>/var</filename> fully updated</refpurpose>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refsynopsisdiv>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para><filename>systemd-update-done.service</filename></para>
12b42c76672a66c2d4ea7212c14f8f1b5a62b78dTom Gundersen <para><filename>/usr/lib/systemd/systemd-update-done</filename></para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </refsynopsisdiv>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para><filename>systemd-update-done.service</filename> is a
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek service that is invoked as part of the first boot after the vendor
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek operating system resources in <filename>/usr</filename> have been
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek updated. This is useful to implement offline updates of
a8eaaee72a2f06e0fb64fb71de3b71ecba31dafbJan Engelhardt <filename>/usr</filename> which might require updates to
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <filename>/etc</filename> or <filename>/var</filename> on the
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek following boot.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para><filename>systemd-update-done.service</filename> updates the
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek file modification time (mtime) of the stamp files
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <filename>/etc/.updated</filename> and
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <filename>/var/.updated</filename> to the modification time of the
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <filename>/usr</filename> directory, unless the stamp files are
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek already newer.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>Services that shall run after offline upgrades of
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <filename>/usr</filename> should order themselves before
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <filename>systemd-update-done.service</filename>, and use the
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <varname>ConditionNeedsUpdate=</varname> (see
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>)
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek condition to make sure to run when <filename>/etc</filename> or
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <filename>/var</filename> are older than <filename>/usr</filename>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek according to the modification times of the files described above.
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek This requires that updates to <filename>/usr</filename> are always
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek followed by an update of the modification time of
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <filename>/usr</filename>, for example by invoking
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry project='man-pages'><refentrytitle>touch</refentrytitle><manvolnum>1</manvolnum></citerefentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry project='man-pages'><refentrytitle>touch</refentrytitle><manvolnum>1</manvolnum></citerefentry>