Debian Codegraph @

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

raw
1 '\" t
2 .TH "SYSTEMD\-UPDATE\-DONE\&.SERVICE" "8" "" "systemd 257.13" "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/ 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) of the stamp 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\&.
50 .PP
51 Services that shall run after offline upgrades of
52 /usr/
53 should order themselves before
54 systemd\-update\-done\&.service, and use the
55 \fIConditionNeedsUpdate=\fR
56 (see
57 \fBsystemd.unit\fR(5)) condition to make sure to run when
58 /etc/
59 or
60 /var/
61 are older than
62 /usr/
63 according to the modification times of the files described above\&. This requires that updates to
64 /usr/
65 are always followed by an update of the modification time of
66 /usr/, for example by invoking
67 \fBtouch\fR(1)
68 on it\&.
69 .PP
70 Note that if the
71 \fIsystemd\&.condition_needs_update=\fR
72 kernel command line option is used it overrides the
73 \fIConditionNeedsUpdate=\fR
74 unit condition checks\&. In that case
75 systemd\-update\-done\&.service
76 will not reset the condition state until a follow\-up reboot where the kernel switch is not specified anymore\&.
77 .SH "SEE ALSO"
78 .PP
79 \fBsystemd\fR(1), \fBsystemd.unit\fR(5), \fBtouch\fR(1)