man/systemd-update-done.service.xml

   1 <?xml version="1.0"?>
   2 <!--*-nxml-*-->
   3 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
   4 <!--
   5   SPDX-License-Identifier: LGPL-2.1+
   6
   7   Copyright 2014 Lennart Poettering
   8 -->
   9 <refentry id="systemd-update-done.service">
  10
  11   <refentryinfo>
  12     <title>systemd-update-done.service</title>
  13     <productname>systemd</productname>
  14
  15     <authorgroup>
  16       <author>
  17         <contrib>Developer</contrib>
  18         <firstname>Lennart</firstname>
  19         <surname>Poettering</surname>
  20         <email>lennart@poettering.net</email>
  21       </author>
  22     </authorgroup>
  23   </refentryinfo>
  24
  25   <refmeta>
  26     <refentrytitle>systemd-update-done.service</refentrytitle>
  27     <manvolnum>8</manvolnum>
  28   </refmeta>
  29
  30   <refnamediv>
  31     <refname>systemd-update-done.service</refname>
  32     <refname>systemd-update-done</refname>
  33     <refpurpose>Mark <filename>/etc</filename> and <filename>/var</filename> fully updated</refpurpose>
  34   </refnamediv>
  35
  36   <refsynopsisdiv>
  37     <para><filename>systemd-update-done.service</filename></para>
  38     <para><filename>/usr/lib/systemd/systemd-update-done</filename></para>
  39   </refsynopsisdiv>
  40
  41   <refsect1>
  42     <title>Description</title>
  43
  44     <para><filename>systemd-update-done.service</filename> is a
  45     service that is invoked as part of the first boot after the vendor
  46     operating system resources in <filename>/usr</filename> have been
  47     updated. This is useful to implement offline updates of
  48     <filename>/usr</filename> which might require updates to
  49     <filename>/etc</filename> or <filename>/var</filename> on the
  50     following boot.</para>
  51
  52     <para><filename>systemd-update-done.service</filename> updates the
  53     file modification time (mtime) of the stamp files
  54     <filename>/etc/.updated</filename> and
  55     <filename>/var/.updated</filename> to the modification time of the
  56     <filename>/usr</filename> directory, unless the stamp files are
  57     already newer.</para>
  58
  59     <para>Services that shall run after offline upgrades of
  60     <filename>/usr</filename> should order themselves before
  61     <filename>systemd-update-done.service</filename>, and use the
  62     <varname>ConditionNeedsUpdate=</varname> (see
  63     <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>)
  64     condition to make sure to run when <filename>/etc</filename> or
  65     <filename>/var</filename> are older than <filename>/usr</filename>
  66     according to the modification times of the files described above.
  67     This requires that updates to <filename>/usr</filename> are always
  68     followed by an update of the modification time of
  69     <filename>/usr</filename>, for example by invoking
  70     <citerefentry project='man-pages'><refentrytitle>touch</refentrytitle><manvolnum>1</manvolnum></citerefentry>
  71     on it.</para>
  72
  73   </refsect1>
  74
  75   <refsect1>
  76     <title>See Also</title>
  77     <para>
  78       <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
  79       <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
  80       <citerefentry project='man-pages'><refentrytitle>touch</refentrytitle><manvolnum>1</manvolnum></citerefentry>
  81     </para>
  82   </refsect1>
  83
  84 </refentry>