Adding upstream version 4.23.0.upstream/4.23.0

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 38 insertions, 1 deletions

diff --git a/upstream/fedora-rawhide/man1/needs-restarting.1 b/upstream/fedora-rawhide/man1/needs-restarting.1
index d144c3cf..14bbf2f8 100644
--- a/upstream/fedora-rawhide/man1/needs-restarting.1
+++ b/upstream/fedora-rawhide/man1/needs-restarting.1
@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
-.TH "NEEDS-RESTARTING" "1" "Feb 08, 2024" "4.5.0" "dnf-plugins-core"
+.TH "NEEDS-RESTARTING" "1" "Apr 24, 2024" "4.7.0" "dnf-plugins-core"
 .SH NAME
 needs-restarting \- redirecting to DNF needs-restarting Plugin
 .sp
@@ -40,6 +40,43 @@ Check for running processes that should be restarted.
 \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.
 .sp
 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.
+.sp
+\fBNOTE:\fP
+.INDENT 0.0
+.INDENT 3.5
+Needs\-restarting will try to guess the boot time using three different methods:
+.INDENT 0.0
+.TP
+.B \fBUnitsLoadStartTimestamp\fP
+D\-Bus property on \fB/org/freedesktop/systemd1\fP\&.
+Works unless the system was not booted with systemd,
+such as in (most) containers.
+.TP
+.B \fBst_mtime of /proc/1\fP
+Reflects the time the first process was run after booting.
+This works for all known cases except machines without
+a RTC—they awake at the start of the epoch.
+.TP
+.B \fB/proc/uptime\fP
+Seconds field of \fB/proc/uptime\fP subtracted from the current time.
+Works for machines without RTC if the current time is reasonably correct.
+Does not work on containers which share their kernel with the
+host—there, the host kernel uptime is returned.
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.sp
+\fBWARNING:\fP
+.INDENT 0.0
+.INDENT 3.5
+Some systems are configured to read the RTC time in the local time
+zone. This mode cannot be fully supported. It will create various problems
+with time zone changes and daylight saving time adjustments. The RTC time
+is never updated, it relies on external facilities to maintain it. \fBIf at
+all possible, use RTC in UTC by calling\fP \fBtimedatectl set\-local\-rtc 0\fP\&.
+See \fBman timedatectl\fP for more information.
+.UNINDENT
+.UNINDENT
 .SH OPTIONS
 .sp
 All general DNF options are accepted, see \fIOptions\fP in \fBdnf(8)\fP for details.