docs: free.1 now follows the latest used/cache changes

This commit is contained in:
Jaromir Capik 2014-07-31 16:46:54 +02:00
parent f47001c9e9
commit 51cd57259a

24
free.1
View File

@ -2,7 +2,7 @@
.\" This page Copyright (C) 1993 Matt Welsh, mdw@sunsite.unc.edu. .\" This page Copyright (C) 1993 Matt Welsh, mdw@sunsite.unc.edu.
.\" Long options where added at April 15th, 2011. .\" Long options where added at April 15th, 2011.
.\" Freely distributable under the terms of the GPL .\" Freely distributable under the terms of the GPL
.TH FREE 1 "September 2011" "procps-ng" "User Commands" .TH FREE 1 "July 2014" "procps-ng" "User Commands"
.SH NAME .SH NAME
free \- Display amount of free and used memory in the system free \- Display amount of free and used memory in the system
.SH SYNOPSIS .SH SYNOPSIS
@ -19,7 +19,7 @@ columns are:
Total installed memory (MemTotal and SwapTotal in /proc/meminfo) Total installed memory (MemTotal and SwapTotal in /proc/meminfo)
.TP .TP
\fBused\fR \fBused\fR
Used memory (calculated as total - free) Used memory (calculated as \fBtotal\fR - \fBfree\fR - \fBbuffers\fR - \fBcache\fR)
.TP .TP
\fBfree\fR \fBfree\fR
Unused memory (MemFree and SwapFree in /proc/meminfo) Unused memory (MemFree and SwapFree in /proc/meminfo)
@ -31,13 +31,16 @@ kernels 2.6.32, displayed as zero if not available)
\fBbuffers\fR \fBbuffers\fR
Memory used by kernel buffers (Buffers in /proc/meminfo) Memory used by kernel buffers (Buffers in /proc/meminfo)
.TP .TP
\fBcached\fR \fBcache\fR
Memory used by the page cache (Cached in /proc/meminfo) Memory used by the page cache and slabs (Cached and Slab in /proc/meminfo)
.TP
\fBbuff/cache\fR
Sum of \fBbuffers\fR and \fBcache\fR
.TP .TP
\fBavailable\fR \fBavailable\fR
Estimation of how much memory is available for starting Estimation of how much memory is available for starting
new applications, without swapping. Unlike the data new applications, without swapping. Unlike the data
provided by the \fBcached\fR or \fBfree\fR fields, provided by the \fBcache\fR or \fBfree\fR fields,
this field takes into account page cache and also that this field takes into account page cache and also that
not all reclaimable memory slabs will be reclaimed not all reclaimable memory slabs will be reclaimed
due to items being in use (MemAvailable in /proc/meminfo, available on due to items being in use (MemAvailable in /proc/meminfo, available on
@ -74,9 +77,10 @@ display the units of print out. Following units are used.
If unit is missing, and you have petabyte of RAM or swap, the number is in If unit is missing, and you have petabyte of RAM or swap, the number is in
terabytes and columns might not be aligned with header. terabytes and columns might not be aligned with header.
.TP .TP
\fB\-a\fR, \fB\-\-available\fR \fB\-w\fR, \fB\-\-wide\fR
Display the estimation of memory available for starting new applications, Switch to the wide mode. The wide mode produces lines longer
without swapping. This switch makes the output wider than 80 characters. than 80 characters. In this mode \fBbuffers\fR and \fBcache\fR
are reported in two separate columns.
.TP .TP
\fB\-c\fR, \fB\-\-count\fR \fIcount\fR \fB\-c\fR, \fB\-\-count\fR \fIcount\fR
Display the result Display the result
@ -88,10 +92,6 @@ option.
\fB\-l\fR, \fB\-\-lohi\fR \fB\-l\fR, \fB\-\-lohi\fR
Show detailed low and high memory statistics. Show detailed low and high memory statistics.
.TP .TP
\fB\-o\fR, \fB\-\-old\fR
Display the output in old format, the only difference being this option
will disable the display of the "buffer adjusted" line.
.TP
\fB\-s\fR, \fB\-\-seconds\fR \fIseconds\fR \fB\-s\fR, \fB\-\-seconds\fR \fIseconds\fR
Continuously display the result delay Continuously display the result delay
.I seconds .I seconds