man-pages/man1/slabtop.1.html
2021-03-31 01:06:50 +01:00

178 lines
4.9 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of SLABTOP</TITLE>
</HEAD><BODY>
<H1>SLABTOP</H1>
Section: User Commands (1)<BR>Updated: June 2011<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
slabtop - display kernel slab cache information in real time
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>slabtop</B>
[<I>options</I>]
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
<B>slabtop</B>
displays detailed kernel slab cache information in real time. It displays a
listing of the top caches sorted by one of the listed sort criteria. It also
displays a statistics header filled with slab layer information.
<A NAME="lbAE">&nbsp;</A>
<H2>OPTIONS</H2>
Normal invocation of
<B>slabtop</B>
does not require any options. The behavior, however, can be fine-tuned by
specifying one or more of the following flags:
<DL COMPACT>
<DT id="1"><B>-d</B>, <B>--delay</B>=<I>N</I><DD>
Refresh the display every
<I>n</I>
in seconds. By default,
<B>slabtop</B>
refreshes the display every three seconds. To exit the program, hit
<B>q.</B>
<DT id="2"><B>-s</B>, <B>--sort</B>=<I>S</I><DD>
Sort by <I>S</I>, where <I>S</I> is one of the sort criteria.
<DT id="3"><B>-o</B>, <B>--once</B><DD>
Display the output once and then exit.
<DT id="4"><B>-V</B>, <B>--version</B><DD>
Display version information and exit.
<DT id="5"><B>-h</B>, <B>--help</B><DD>
Display usage information and exit.
</DL>
<A NAME="lbAF">&nbsp;</A>
<H2>SORT CRITERIA</H2>
The following are valid sort criteria used to sort the individual slab caches
and thereby determine what are the &quot;top&quot; slab caches to display. The default
sort criteria is to sort by the number of objects (&quot;o&quot;).
<P>
The sort criteria can also be changed while slabtop is running by pressing
the associated character.
<TABLE>
<TR VALIGN=top><TD><B>character</B></TD><TD>description</TD><TD>header<BR></TD></TR>
<TR VALIGN=top><TD>a</TD><TD>number of active objects</TD><TD>ACTIVE<BR></TD></TR>
<TR VALIGN=top><TD>b</TD><TD>objects per slab</TD><TD>OBJ/SLAB<BR></TD></TR>
<TR VALIGN=top><TD>c</TD><TD>cache size</TD><TD>CACHE SIZE<BR></TD></TR>
<TR VALIGN=top><TD>l</TD><TD>number of slabs</TD><TD>SLABS<BR></TD></TR>
<TR VALIGN=top><TD>v</TD><TD>number of active slabs</TD><TD>N/A<BR></TD></TR>
<TR VALIGN=top><TD>n</TD><TD>name</TD><TD>NAME:<BR></TD></TR>
<TR VALIGN=top><TD>o</TD><TD>number of objects</TD><TD>OBJS<BR></TD></TR>
<TR VALIGN=top><TD>p</TD><TD>pages per slab</TD><TD>N/A<BR></TD></TR>
<TR VALIGN=top><TD>s</TD><TD>object size</TD><TD>OBJ SIZE<BR></TD></TR>
<TR VALIGN=top><TD>u</TD><TD>cache utilization</TD><TD>USE<BR></TD></TR>
</TABLE>
<A NAME="lbAG">&nbsp;</A>
<H2>COMMANDS</H2>
<B>slabtop</B>
accepts keyboard commands from the user during use. The following are
supported. In the case of letters, both cases are accepted.
<P>
Each of the valid sort characters are also accepted, to change the sort
routine. See the section
<B>SORT CRITERIA</B>.
<DL COMPACT>
<DT id="6"><B>&lt;SPACEBAR&gt;</B>
<DD>
Refresh the screen.
<DT id="7"><B>Q</B>
<DD>
Quit the program.
</DL>
<A NAME="lbAH">&nbsp;</A>
<H2>FILES</H2>
<DL COMPACT>
<DT id="8"><I>/proc/slabinfo</I>
<DD>
slab information
</DL>
<A NAME="lbAI">&nbsp;</A>
<H2>SEE ALSO</H2>
<B><A HREF="/cgi-bin/man/man2html?1+free">free</A></B>(1),
<B><A HREF="/cgi-bin/man/man2html?1+ps">ps</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)
<A NAME="lbAJ">&nbsp;</A>
<H2>NOTES</H2>
Currently,
<B>slabtop</B>
requires a 2.4 or later kernel (specifically, a version 1.1 or later
<I>/proc/slabinfo</I>).
Kernel 2.2 should be supported in the future.
<P>
The slabtop statistic header is tracking how many bytes of slabs are being
used and is not a measure of physical memory. The 'Slab' field in the
/proc/meminfo file is tracking information about used slab physical memory.
<A NAME="lbAK">&nbsp;</A>
<H2>AUTHORS</H2>
Written by Chris Rivera and Robert Love.
<P>
<B>slabtop</B>
was inspired by Martin Bligh's perl script,
<B>vmtop</B>.
<A NAME="lbAL">&nbsp;</A>
<H2>REPORTING BUGS</H2>
Please send bug reports to
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="9"><A HREF="#lbAB">NAME</A><DD>
<DT id="10"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="11"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="12"><A HREF="#lbAE">OPTIONS</A><DD>
<DT id="13"><A HREF="#lbAF">SORT CRITERIA</A><DD>
<DT id="14"><A HREF="#lbAG">COMMANDS</A><DD>
<DT id="15"><A HREF="#lbAH">FILES</A><DD>
<DT id="16"><A HREF="#lbAI">SEE ALSO</A><DD>
<DT id="17"><A HREF="#lbAJ">NOTES</A><DD>
<DT id="18"><A HREF="#lbAK">AUTHORS</A><DD>
<DT id="19"><A HREF="#lbAL">REPORTING BUGS</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:27 GMT, March 31, 2021
</BODY>
</HTML>