free manpage: expand note on negative value with overcommit Resolves: RHEL-100973

This commit is contained in:
Jan Rybar 2025-10-29 15:53:07 +01:00
parent de19327530
commit 0af78bba10
2 changed files with 29 additions and 1 deletions

View File

@ -0,0 +1,23 @@
commit 9a8dc789e83b869ef8c56cc94741dbc3a191f55b
Author: Jan Rybar <jrybar@redhat.com>
Date: Tue Oct 28 06:37:03 2025 +0000
free manpage: note on negative value with overcommitt enabled
diff --git a/man/free.1 b/man/free.1
index 02dae847..3816754a 100644
--- a/man/free.1
+++ b/man/free.1
@@ -142,7 +142,11 @@ Display a line showing the column totals.
\fB\-v\fR, \fB\-\-committed\fR
Display a line showing the memory commit limit and amount of committed/uncommitted
memory. The \fBtotal\fR column on this line will display the memory commit
-limit. This line is relevant if memory overcommit is disabled.
+limit. This line is relevant if memory overcommit is disabled. On systems
+with memory overcommit enabled, the \fBfree\fR value can temporarily appear
+negative. This is not a bug, but an effect of overcommit, as the system has promised
+more memory than the total of its virtual address space.
+The negative value indicates the magnitude of the system's memory over-allocation.
.TP
\fB\-\-help\fR
Print help.

View File

@ -4,7 +4,7 @@
Summary: System and process monitoring utilities
Name: procps-ng
Version: 4.0.4
Release: 8%{?dist}
Release: 9%{?dist}
License: GPL-2.0-or-later AND LGPL-2.0-or-later AND LGPL-2.1-or-later
URL: https://sourceforge.net/projects/procps-ng/
@ -12,6 +12,7 @@ Source0: https://downloads.sourceforge.net/%{name}/%{name}-%{version}.tar.xz
Patch1: osh-findings.patch
Patch2: top-fix-guest-tics.patch
Patch3: free-manpage-overcommit-note.patch
BuildRequires: make
BuildRequires: ncurses-devel
@ -148,6 +149,10 @@ ln -s %{_bindir}/pidof %{buildroot}%{_sbindir}/pidof
%files i18n -f %{name}.lang
%changelog
* Wed Oct 29 2025 Jan Rybar <jrybar@redhat.com> - 4.0.4-9
- free manpage: expand note on negative value with overcommit
- Resolves: RHEL-100973
* Wed Apr 16 2025 Jan Rybar <jrybar@redhat.com> - 4.0.4-8
- fix guest tics (backport upstr patch e1df029e6, 3fb34669)
- Resolves: RHEL-84051