Debian Codegraph @

upstream/debian-unstable/man8/systemd-update-done.service.8

raw
1 '\" t
2 .TH "SYSTEMD\-UPDATE\-DONE\&.SERVICE" "8" "" "systemd 261~rc3" "systemd-update-done.service"
3 .\" -----------------------------------------------------------------
4 .\" * Define some portability stuff
5 .\" -----------------------------------------------------------------
6 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
7 .\" http://bugs.debian.org/507673
8 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
9 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
10 .ie \n(.g .ds Aq \(aq
11 .el .ds Aq '
12 .\" -----------------------------------------------------------------
13 .\" * set default formatting
14 .\" -----------------------------------------------------------------
15 .\" disable hyphenation
16 .nh
17 .\" disable justification (adjust text to left margin only)
18 .ad l
19 .\" -----------------------------------------------------------------
20 .\" * MAIN CONTENT STARTS HERE *
21 .\" -----------------------------------------------------------------
22 .SH "NAME"
23 systemd-update-done.service, systemd-update-done \- Mark /etc/ and /var/ as fully updated
24 .SH "SYNOPSIS"
25 .PP
26 systemd\-update\-done\&.service
27 .PP
28 /usr/lib/systemd/systemd\-update\-done
29 .SH "DESCRIPTION"
30 .PP
31 systemd\-update\-done\&.service
32 is a service that is invoked as part of the first boot after the vendor operating system resources in
33 /usr/
34 have been updated\&. This is useful to implement offline updates of
35 /usr/
36 which might require updates to
37 /etc/
38 or
39 /var/
40 on the following boot\&.
41 .PP
42 systemd\-update\-done\&.service
43 updates the file modification time (mtime) stored in and "on" the files
44 /etc/\&.updated
45 and
46 /var/\&.updated
47 to the modification time of the
48 /usr/
49 directory, unless the stamp files are already newer\&. (The timestamp is stored as the mtime field on the file, but also
50 \fIin\fR
51 the file to support filesystems that do not store full timestamp precision\&.)
52 .PP
53 Services that shall run after offline upgrades of
54 /usr/
55 should order themselves before
56 systemd\-update\-done\&.service, and use the
57 \fIConditionNeedsUpdate=\fR
58 (see
59 \fBsystemd.unit\fR(5)) condition to make sure to run when
60 /etc/
61 or
62 /var/
63 are older than
64 /usr/
65 according to the modification times of the files described above\&. This requires that updates to
66 /usr/
67 are always followed by an update of the modification time of
68 /usr/, for example by invoking
69 \fBtouch\fR(1)
70 on it\&.
71 .PP
72 Note that if the
73 \fIsystemd\&.condition_needs_update=\fR
74 kernel command line option is used it overrides the
75 \fIConditionNeedsUpdate=\fR
76 unit condition checks\&. In that case
77 systemd\-update\-done\&.service
78 will not reset the condition state until a follow\-up reboot where the kernel switch is not specified anymore\&.
79 .SH "OPTIONS"
80 .PP
81 The following options are understood:
82 .PP
83 \fB\-\-root=\fR\fB\fIroot\fR\fR
84 .RS 4
85 Takes a directory path as an argument\&. The program will operate on paths below the specified root directory\&.
86 .sp
87 Added in version 258\&.
88 .RE
89 .PP
90 \fB\-h\fR, \fB\-\-help\fR
91 .RS 4
92 Print a short help text and exit\&.
93 .RE
94 .PP
95 \fB\-\-version\fR
96 .RS 4
97 Print a short version string and exit\&.
98 .RE
99 .SH "SEE ALSO"
100 .PP
101 \fBsystemd\fR(1), \fBsystemd.unit\fR(5), \fBtouch\fR(1)