Debian Codegraph @

upstream/debian-unstable/man8/dnf4-needs-restarting.8

raw
1 .\" Man page generated from reStructuredText.
2 .
3 .
4 .nr rst2man-indent-level 0
5 .
6 .de1 rstReportMargin
7 \\$1 \\n[an-margin]
8 level \\n[rst2man-indent-level]
9 level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
10 -
11 \\n[rst2man-indent0]
12 \\n[rst2man-indent1]
13 \\n[rst2man-indent2]
14 ..
15 .de1 INDENT
16 .\" .rstReportMargin pre:
17 . RS \\$1
18 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
19 . nr rst2man-indent-level +1
20 .\" .rstReportMargin post:
21 ..
22 .de UNINDENT
23 . RE
24 .\" indent \\n[an-margin]
25 .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
26 .nr rst2man-indent-level -1
27 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
28 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
29 ..
30 .TH "DNF4-NEEDS-RESTARTING" "8" "Sep 27, 2025" "4.10.1" "dnf-plugins-core"
31 .SH NAME
32 dnf4-needs-restarting \- DNF needs_restarting Plugin
33 .sp
34 Check for running processes that should be restarted.
35 .SH SYNOPSIS
36 .sp
37 \fBdnf needs\-restarting [\-u] [\-r] [\-s]\fP
38 .SH DESCRIPTION
39 .sp
40 \fIneeds\-restarting\fP looks through running processes and tries to detect those that use files from packages that have been updated after the given process started. Such processes are reported by this tool.
41 .sp
42 Note that in most cases a process should survive update of its binary and libraries it is using without requiring to be restarted for proper operation. There are however specific cases when this does not apply. Separately, processes often need to be restarted to reflect security updates.
43 .sp
44 \fBNOTE:\fP
45 .INDENT 0.0
46 .INDENT 3.5
47 Needs\-restarting will try to guess the boot time using three different methods:
48 .INDENT 0.0
49 .TP
50 .B \fBUnitsLoadStartTimestamp\fP
51 D\-Bus property on \fB/org/freedesktop/systemd1\fP\&.
52 Works unless the system was not booted with systemd,
53 such as in (most) containers.
54 .TP
55 .B \fBst_mtime of /proc/1\fP
56 Reflects the time the first process was run after booting.
57 This works for all known cases except machines without
58 a RTC—they awake at the start of the epoch.
59 .TP
60 .B \fB/proc/uptime\fP
61 Seconds field of \fB/proc/uptime\fP subtracted from the current time.
62 Works for machines without RTC if the current time is reasonably correct.
63 Does not work on containers which share their kernel with the
64 host—there, the host kernel uptime is returned.
65 .UNINDENT
66 .UNINDENT
67 .UNINDENT
68 .sp
69 \fBWARNING:\fP
70 .INDENT 0.0
71 .INDENT 3.5
72 Some systems are configured to read the RTC time in the local time
73 zone. This mode cannot be fully supported. It will create various problems
74 with time zone changes and daylight saving time adjustments. The RTC time
75 is never updated, it relies on external facilities to maintain it. \fBIf at
76 all possible, use RTC in UTC by calling\fP \fBtimedatectl set\-local\-rtc 0\fP\&.
77 See \fBman timedatectl\fP for more information.
78 .UNINDENT
79 .UNINDENT
80 .SH OPTIONS
81 .sp
82 All general DNF options are accepted, see \fIOptions\fP in \fBdnf(8)\fP for details.
83 .INDENT 0.0
84 .TP
85 .B \fB\-u, \-\-useronly\fP
86 Only consider processes belonging to the running user.
87 .TP
88 .B \fB\-r, \-\-reboothint\fP
89 Only report whether a reboot is required (exit code 1) or not (exit code 0).
90 .TP
91 .B \fB\-s, \-\-services\fP
92 Only list the affected systemd services.
93 .TP
94 .B \fB\-\-exclude\-services\fP
95 Don’t list stale processes that correspond to a systemd service.
96 .UNINDENT
97 .SH CONFIGURATION
98 .sp
99 \fB/etc/dnf/plugins/needs\-restarting.d/\fP
100 .sp
101 \fB/etc/dnf/plugins/needs\-restarting.d/pkgname.conf\fP
102 .sp
103 Packages can be added to \fBneeds\-restarting\fP via conf files in config
104 directory. Config files need to have \fB\&.conf\fP extension or will be ignored.
105 .sp
106 More than one package is allowed in each file (one package per line) although
107 it is advised to use one file for each package.
108 .sp
109 Example:
110 .INDENT 0.0
111 .INDENT 3.5
112 .sp
113 .EX
114 echo \(dqdwm\(dq > /etc/dnf/plugins/needs\-restarting.d/dwm.conf
115 .EE
116 .UNINDENT
117 .UNINDENT
118 .SH AUTHOR
119 See AUTHORS in your Core DNF Plugins distribution
120 .SH COPYRIGHT
121 2014, Red Hat, Licensed under GPLv2+
122 .\" Generated by docutils manpage writer.
123 .