procinfo - display system status gathered from /proc


SYNOPSIS

       procinfo [ -fsmadiDSbrChv ] [ -nN ] [ -Ffile ]


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) (preferably the proc-
              version of free (If you weren't around  during  the
              Linux  1.x  days,  that's  the only version of free
              you'll have)).

       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 (if your  kernel  is  recent  enough),
              followed by the PID of the last process run (idem).

       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


       page in:
              The number of disk block paged into core from disk.
              (A block is almost always 1 kilobyte).

       page out:
              The  reverse  of  the  above. (What does that mean,
              anyways?)

       swap in:
              The number of memory pages paged in from swapspace.

       swap out:
              The  number of memory pages paged out to swapspace.

       context:
              The total number of context switches since  bootup.

       disk 1-4:
              The  number  of  times  your  hard  disks have been
              accessed. This won't work for  1.0.x/1.1.x  kernels
              unless  you  have applied the diskstat patch avail­
              able elsewhere to your kernel, and might give  sur­
              prising  results  if all your hard disks are of the
              same type (e.g. all IDE, all SCSI). [I'm  not  sure
              to  what extend this is still true with recent ker­
              nels, but I don't have a mixed system  so  I  can't
              check.]

       Interrupts:
              This is either a single number for all IRQ channels
              together if  your  kernel  is  older  than  version
              1.0.5,  or two rows of numbers for each IRQ channel
              if your kernel is at version  1.0.5  or  later.  On
              Intel  architecture there are sixteen different IRQ
              channels, and their default meanings  are  as  fol­
              lows:

              0      Timer channel 0
              1      Keyboard
              2      Cascade for controller 2 (which controls IRQ
                     8-15)
              3      Serial Port 2
              4      Serial Port 1
              5      Parallel Port 2
              6      Floppy Diskette Controller

              8      Real-time Clock
              9      Redirected to IRQ2
              10     --
              11     --
              12     --
              13     Math Coprocessor
              14     Hard Disk Controller
              15     --

              Note that the meanings of the IRQ channels for par­
              allel  ports, serial ports and those left empty may
              have been changed depending on your hardware setup.
              If that's the case on your machine, you're probably
              aware of it. If you're not,  upgrade  to  at  least
              Linux  1.1.43  and let procinfo enlighten you about
              who uses what.

       Modules:
              The modules (loadable device drivers) installed  on
              your  machine, with their sizes in kilobytes. (Only
              with -m or -a option). Modules  with  a  use  count
              larger than 0 are marked with an asterisk.

       Character and Block Devices:
              All  available  devices  with  their major numbers.
              (Only with -m or -a option).

       File Systems:
              All available file systems. (Only  with  -m  or  -a
              option). Those that do not require an actual device
              (like  procfs  itself)  are  noted  between  square
              brackets.


OPTIONS

       -f     Run procinfo continuously full-screen.

       -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 sec­
              onds, the program will run at the highest  possible
              priority level.

       -m     Show  info about modules and device drivers instead
              of CPU and memory stats.

       -a     Show all information that  procinfo  knows  how  to
              find.

       -d     For memory, CPU times, paging, swapping, disk, con­
              text and interrupt stats, display values per second
              rather than totals. This option implies -f.

              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.

       -Ffile Redirect output to file (usually a tty).  Nice  if,
              for  example,  you want to run procinfo permanently
              on a virtual console or on a terminal, by  starting
              it from init(8) with a line like:

              p8:23:respawn:/usr/bin/procinfo -biDn1 -F/dev/tty8

       -b     If your kernel is recent enough to display separate
              read and write numbers for disk I/O,  the  -b  flag
              makes  procinfo  display  numbers  of blocks rather
              that numbers of I/O requests (neither of which  is,
              alas, reliably translatable into kilobytes).

       -i     Normally the IRQ portion of the display is squeezed
              to only display non-zero IRQ  channels.  With  this
              option  you'll get the full list, but on Alphas and
              on  Intel  boxen  with  2.1.104  kernels  or  later
              procinfo  won't  fit inside a 80x24 screen anymore.
              Price of progress, I suppose.

       -r     This option adds an extra line to the  memory  info
              showing 'real' free memory, just as free(1) does.

       -h     Print a brief help message.

       -v     Print version info.


INTERACTIVE COMMANDS

       When  running  procinfo  fullscreen,  you  can  change its
       behaviour by pressing n, d, D, S, i, m, a, r and b,  which
       have  the  same  effect  as the corresponding command line
       options.  In addition you can press q which quits the pro­
       gram;  s  which  switches  back  to  the main screen after
       pressing m or a;  t  which  switches  back  to  displaying
       totals  after  pressing  d or D; <space> which freezes the
       screen untill you press another key again; C and  R  which
       sets and releases a checkpoint in totals mode; and finally
       Ctrl-L which refreshes the screen.


FILES

       /proc  The proc file system.


BUGS

       What, me worry?

       free(1), uptime(1), w(1), init(8), proc(5).


AUTHOR

       Sander van Malssen <svm@kozmix.cistron.nl>


Man(1) output converted with man2html