| .\" slabtop.1 - manpage for the slabtop(1) utility, part of procps |
| .\" |
| .\" Copyright (C) 2003 Chris Rivera |
| .\" Licensed under the terms of the GNU Library General Public License, v2 |
| .TH SLABTOP 1 "13 Sep 2003" "Linux" "Linux User's Manual" |
| .SH NAME |
| slabtop \- display kernel slab cache information in real time |
| |
| .SH SYNOPSIS |
| .BI "slabtop [ " options " ] " |
| |
| .SH DESCRIPTION |
| .BR slabtop (1) |
| 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. |
| |
| .SH OPTIONS |
| Normal invocation of |
| .BR slabtop (1) |
| does not require any options. The behavior, however, can be fine-tuned by |
| specifying one or more of the following flags: |
| .TP |
| .B \-\^\-delay=n, \-d n |
| Refresh the display every n seconds. By default, |
| .BR slabtop (1) |
| refreshes the display every three seconds. To exit the program, hit |
| .BR q. |
| .TP |
| .B \-\^\-sort=S, \-s S |
| Sort by S, where S is one of the sort criteria. |
| .TP |
| .B \-\^\-once, \-o |
| Display the output once and then exit. |
| .TP |
| .B \-\^\-version, \-V |
| Display version information and exit. |
| .TP |
| .B \-\^\-help |
| Display usage information and exit. |
| |
| .SH SORT CRITERIA |
| The following are valid sort criteria used to sort the individual slab caches |
| and thereby determine what are the "top" slab caches to display. The default |
| sort criteria is to sort by the number of objects ("o"). |
| |
| The sort criteria can also be changed while slabtop is running by pressing |
| the associated character. |
| .TP |
| .BR a: |
| sort by number of active objects |
| .TP |
| .BR b: |
| sort by objects per slab |
| .TP |
| .BR c: |
| sort by cache size |
| .TP |
| .BR l: |
| sort by number of slabs |
| .TP |
| .BR v |
| sort by number of active slabs |
| .TP |
| .BR n: |
| sort by name |
| .TP |
| .BR o: |
| sort by number of objects |
| .TP |
| .BR p: |
| sort by pages per slab |
| .TP |
| .BR s: |
| sort by object size |
| .TP |
| .BR u: |
| sort by cache utilization |
| |
| .SH COMMANDS |
| .BR slabtop (1) |
| accepts keyboard commands from the user during use. The following are |
| supported. In the case of letters, both cases are accepted. |
| |
| Each of the valid sort characters are also accepted, to change the sort |
| routine. See the section |
| .IR "SORT CRITERIA" . |
| |
| .TP |
| .BR <SPACEBAR> |
| Refresh the screen. |
| .TP |
| .BR Q |
| Quit the program. |
| |
| .SH FILES |
| .IR /proc/slabinfo " \-\- slab information" |
| |
| .SH "SEE ALSO" |
| .BR free (1), |
| .BR ps (1), |
| .BR top (1), |
| .BR vmstat (8) |
| |
| .SH NOTES |
| Currently, |
| .BR slabtop (1) |
| requires a 2.4 or later kernel (specifically, a version 1.1 or later |
| .IR /proc/slabinfo ). |
| Kernel 2.2 should be supported in the future. |
| |
| The slabtop statistic header is tracking how many bytes of slabs are being used |
| and it not a measure of physical memory. The 'Slab' field in the /proc/meminfo |
| file is tracking information about used slab physical memory. |
| |
| .SH AUTHORS |
| Written by Chris Rivera and Robert Love. |
| |
| .BR slabtop (1) |
| was inspired by Martin Bligh's perl script, |
| .BR vmtop . |
| The procps package is maintained by Albert Cahalan <albert@users.sf.net>. |
| |
| Please send bug reports to <procps-feedback@lists.sf.net>. |
