176 lines
5.4 KiB
HTML
176 lines
5.4 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of FREE</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>FREE</H1>
|
|
Section: User Commands (1)<BR>Updated: 2018-05-31<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
free - Display amount of free and used memory in the system
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>free</B>
|
|
|
|
[<I>options</I>]
|
|
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<B>free</B>
|
|
|
|
displays the total amount of free and used physical and swap memory in the
|
|
system, as well as the buffers and caches used by the kernel. The
|
|
information is gathered by parsing /proc/meminfo. The displayed
|
|
columns are:
|
|
<DL COMPACT>
|
|
<DT id="1"><B>total</B><DD>
|
|
Total installed memory (MemTotal and SwapTotal in /proc/meminfo)
|
|
<DT id="2"><B>used</B><DD>
|
|
Used memory (calculated as <B>total</B> - <B>free</B> - <B>buffers</B> - <B>cache</B>)
|
|
<DT id="3"><B>free</B><DD>
|
|
Unused memory (MemFree and SwapFree in /proc/meminfo)
|
|
<DT id="4"><B>shared</B><DD>
|
|
Memory used (mostly) by tmpfs (Shmem in /proc/meminfo)
|
|
<DT id="5"><B>buffers</B><DD>
|
|
Memory used by kernel buffers (Buffers in /proc/meminfo)
|
|
<DT id="6"><B>cache</B><DD>
|
|
Memory used by the page cache and slabs (Cached and SReclaimable in /proc/meminfo)
|
|
<DT id="7"><B>buff/cache</B><DD>
|
|
Sum of <B>buffers</B> and <B>cache</B>
|
|
<DT id="8"><B>available</B><DD>
|
|
Estimation of how much memory is available for starting
|
|
new applications, without swapping. Unlike the data
|
|
provided by the <B>cache</B> or <B>free</B> fields,
|
|
this field takes into account page cache and also that
|
|
not all reclaimable memory slabs will be reclaimed
|
|
due to items being in use (MemAvailable in /proc/meminfo, available on
|
|
kernels 3.14, emulated on kernels 2.6.27+, otherwise the same as <B>free</B>)
|
|
</DL>
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="9"><B>-b</B>, <B>--bytes</B><DD>
|
|
Display the amount of memory in bytes.
|
|
<DT id="10"><B>-k</B>, <B>--kibi</B><DD>
|
|
Display the amount of memory in kibibytes. This is the default.
|
|
<DT id="11"><B>-m</B>, <B>--mebi</B><DD>
|
|
Display the amount of memory in mebibytes.
|
|
<DT id="12"><B>-g</B>, <B>--gibi</B><DD>
|
|
Display the amount of memory in gibibytes.
|
|
<DT id="13"><B>--tebi</B><DD>
|
|
Display the amount of memory in tebibytes.
|
|
<DT id="14"><B>--pebi</B><DD>
|
|
Display the amount of memory in pebibytes.
|
|
<DT id="15"><B>--kilo</B><DD>
|
|
Display the amount of memory in kilobytes. Implies --si.
|
|
<DT id="16"><B>--mega</B><DD>
|
|
Display the amount of memory in megabytes. Implies --si.
|
|
<DT id="17"><B>--giga</B><DD>
|
|
Display the amount of memory in gigabytes. Implies --si.
|
|
<DT id="18"><B>--tera</B><DD>
|
|
Display the amount of memory in terabytes. Implies --si.
|
|
<DT id="19"><B>--peta</B><DD>
|
|
Display the amount of memory in petabytes. Implies --si.
|
|
<DT id="20"><B>-h</B>, <B>--human</B><DD>
|
|
Show all output fields automatically scaled to shortest three digit unit and
|
|
display the units of print out. Following units are used.
|
|
<P>
|
|
<PRE>
|
|
B = bytes
|
|
Ki = kibibyte
|
|
Mi = mebibyte
|
|
Gi = gibibyte
|
|
Ti = tebibyte
|
|
Pi = pebibyte
|
|
</PRE>
|
|
|
|
<P>
|
|
If unit is missing, and you have exbibyte of RAM or swap, the number is in
|
|
tebibytes and columns might not be aligned with header.
|
|
<DT id="21"><B>-w</B>, <B>--wide</B><DD>
|
|
Switch to the wide mode. The wide mode produces lines longer
|
|
than 80 characters. In this mode <B>buffers</B> and <B>cache</B>
|
|
are reported in two separate columns.
|
|
<DT id="22"><B>-c</B>, <B>--count</B> <I>count</I><DD>
|
|
Display the result
|
|
<I>count</I>
|
|
|
|
times. Requires the
|
|
<B>-s</B>
|
|
|
|
option.
|
|
<DT id="23"><B>-l</B>, <B>--lohi</B><DD>
|
|
Show detailed low and high memory statistics.
|
|
<DT id="24"><B>-s</B>, <B>--seconds</B> <I>delay</I><DD>
|
|
Continuously display the result <I>delay</I> seconds
|
|
apart. You may actually specify any floating point number for
|
|
<I>delay</I> using either . or , for decimal point.
|
|
<B><A HREF="/cgi-bin/man/man2html?3+usleep">usleep</A></B>(3)
|
|
|
|
is used for microsecond resolution delay times.
|
|
<DT id="25"><B>--si</B><DD>
|
|
Use kilo, mega, giga etc (power of 1000) instead of kibi, mebi, gibi (power
|
|
of 1024).
|
|
<DT id="26"><B>-t</B>, <B>--total</B><DD>
|
|
Display a line showing the column totals.
|
|
<DT id="27"><B>--help</B><DD>
|
|
Print help.
|
|
<DT id="28"><B>-V</B>, <B>--version</B><DD>
|
|
Display version information.
|
|
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>FILES</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="29">/proc/meminfo<DD>
|
|
memory information
|
|
|
|
</DL>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>BUGS</H2>
|
|
|
|
The value for the <B>shared</B> column is not available from kernels before
|
|
2.6.32 and is displayed as zero.
|
|
<DL COMPACT>
|
|
<DT id="30">Please send bug reports to<DD>
|
|
|
|
|
|
</DL>
|
|
<A NAME="lbAH"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+ps">ps</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+slabtop">slabtop</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+top">top</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?8+vmstat">vmstat</A></B>(8).
|
|
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="31"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="32"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="33"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="34"><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT id="35"><A HREF="#lbAF">FILES</A><DD>
|
|
<DT id="36"><A HREF="#lbAG">BUGS</A><DD>
|
|
<DT id="37"><A HREF="#lbAH">SEE ALSO</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:12 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|