NAME
procinfo - display system statistics gathered from /proc
SYNOPSIS
procinfo [ -fdDSbrhv ] [ -nN ]
DESCRIPTION
procinfo gathers some system data from the /proc directory and prints
it nicely formatted on the standard output device.
The meanings of the fields are as follows:
Memory:
See the man page for free(1)
Bootup:
The time the system was booted.
Load average:
The average number of jobs running, followed by the number of
runnable processes and the total number of processes, followed
by the PID of the last process run. The pid of the last running
process will probably always be procinfo’s PID.
user: The amount of time spent running jobs in user space.
nice: The amount of time spent running niced jobs in user space.
system:
The amount of time spent running in kernel space. Note: the
time spent servicing interrupts is not counted by the kernel
(and nothing that procinfo can do about it).
idle: The amount of time spent doing nothing.
uptime:
The time that the system has been up. The above four should more
or less add up to this one.
page in:
The number of disk blocks paged into core from disk. 1 block is
equal to 1 kiB.
page out:
The number of disk blocks paged out of core to disk. This
includes regular disk-writes.
swap in:
The number of memory pages paged in from swap.
swap out:
The number of memory pages paged out to swap.
context:
The number of context switches, either since bootup or per
interval.
Disk stats(hda, hdb, sda, sdb):
The number of reads and writes made to disks, whether CD-ROM,
hard-drive, or USB. Shows all disks if they either are an hdX
or sdX, or if they have a non-zero read/write count.
Interrupts:
Number of interrupts serviced since boot, or per interval,
listed per IRQ.
OPTIONS
-nN Pause N second between updates. This option implies -f. It may
contain a decimal point. The default is 5 seconds. When run by
root with a pause of 0 seconds, the program will run at the
highest possible priority level.
-d For memory, CPU times, paging, swapping, disk, context and
interrupt stats, display values per second rather than totals.
This option implies -f.
-D Same as -d, except that memory stats are displayed as totals.
-S When running with -d or -D, always show values per second, even
when running with -n N with N greater than one second.
-b Display numbers of bytes rather than number of I/O requests.
-r This option adds an extra line to the memory info showing ’real’
free memory, just as free(1) does. The numbers produced assume
that Buffers and Cache are disposable.
-H Displays memory stats in ’Human’ (base 1024) numbers (KiB, MiB,
GiB), instead of implied KBytes.
-h Print a brief help message.
-v Print version info.
INTERACTIVE COMMANDS
When running procinfo fullscreen, you can change its behaviour by
pressing d, D, S, r and b, which toggle the flags that correspond to
their same-named commandline-options. In addition you can press q
which quits the program.
FILES
/proc The proc file system.
BUGS
All of these statistics are taken verbatim from the kernel, without any
scaling. Any case where the kernel specifies that a particular field
means something different from how it is documented in this man-page,
the kernel always wins.
Some features of the original procinfo were elided, as they were
considered non-useful, especially as many of them don’t change anymore,
and have better utilities for listing/displaying them.
SEE ALSO
free(1), uptime(1), w(1), init(8), proc(5).
AUTHOR
Adam Schrotenboer <adam@tabris.net>