hmon -- Command

Monitor the COHERENT System
hmon

The command hmon continually  displays a summary of your system's activity.
It uses an interactive display with which you can easily send a signal to a
selected process.

When you invoke hmon, it displays a display that resembles the following:


    Last PID=91     Total Mem=15684K        Free Mem=7844K (50.01%)
    Total=20  Running=1   Zombies=0   Locked=0   Waiting=5   Sleeping=14
    PID=91  Idle=75.68%     User= 8.11%     Sys=16.22%
    Load= 1.60      Load Averages:  1:3.38  5:1.01  20:0.27

    PID   PPID  Username Ksize User  Sys   %User %Sys  Flag tty     S Command
       91    89 fred       148 00:04 00:01  5.41  1.80 4001 ttyp1   R hmon
       89    88 fred       129 00:00 00:00  0.00  0.00 6001 ttyp1   W ksh
       88     1 root       735 00:04 00:19  0.00  1.80 4001 null    S xterm
       86    80 fred       208 00:00 00:00  0.00  0.00 6001 ttyp0   S me
       80    78 fred       129 00:00 00:00  0.00  0.00 6001 ttyp0   W ksh
       79    76 fred       284 00:00 00:07  0.90  9.01 4001 null    S fvwm
       78    76 root       727 00:00 00:01  0.00  0.00 4001 null    S xterm
       76    64 fred        79 00:00 00:00  0.00  0.00 6001 null    S sh
       70    64 root      2423 00:15 00:11  1.80  3.60 6001 console S X
       64    54 fred       105 00:00 00:00  0.00  0.00 6001 color0  W xinit
       56     1 root        28 00:00 00:00  0.00  0.00 4001 com2l   S getty
       55     1 root        28 00:00 00:00  0.00  0.00 4001 com3l   S getty
       54     1 fred       129 00:00 00:00  0.00  0.00 6001 color0  W ksh
       53     1 root        28 00:00 00:00  0.00  0.00 4001 color1  S getty
       52     1 root        28 00:00 00:00  0.00  0.00 4001 color2  S getty
       51     1 root        28 00:00 00:00  0.00  0.00 4001 color3  S getty
       47     1 daemon      55 00:00 00:00  0.00  0.00    1 null    S lpsched
       45     1 root        36 00:00 00:00  0.00  0.00    1 null    S cron


The first four lines

    Last PID=91     Total Mem=15684K        Free Mem=7844K (50.01%)
    Total=20  Running=1   Zombies=0   Locked=0   Waiting=5   Sleeping=14
    PID=91  Idle=75.68%     User= 8.11%     Sys=16.22%
    Load= 1.60      Load Averages:  1:3.38  5:1.01  20:0.27

summarize  your system's  status.   The lines  that  follow summarize  each
process.  Each line contains the following information:

PID  The identifier of the process.

PPID The process identifier its parent process.  Note that process 1, init,
     has no parent process.  For more details on init, see its entry in the
     Lexicon

Username
     The login identifier of the user who owns this process.

Ksize
     The process's  size, in  kilobytes.  Note  that this does  not include
     memory that the process allocates for itself.

User The amount of user time that this process has consumed.

Sys  The amount of system time that this process has consumed.

%User
     The percent of user time this process has consumed.

%Sys The percent of system time this process has consumed.

Flag The process's flag bits OR'd together, as follows:

     PFCORE  00001 Process is in core
     PFLOCK  00002 Process is locked in core
     PFSWIO  00004 Swap I/O in progress
     PFSWAP  00010 Process is swapped out
     PFWAIT  00020 Process is stopped (not waited)
     PFSTOP  00040 Process is stopped (waited on)
     PFTRAC  00100 Process is being traced
     PFKERN  00200 Kernel process
     PFAUXM  00400 Auxiliary segments in memory
     PFDISP  01000 Dispatch at earliest convenience
     PFNDMP  02000 Command mode forbids dump
     PFWAKE  04000 Wakeup requested

     For  example, process  8460 has  flag ``4001''.   This means  that the
     process is swapped out and and that a wakeup has been requested.  This
     is consistent  with the `S'  status, which means that  it is sleeping.
     Note that the flags for  swapping do not contain useful information as
     COHERENT does not yet support demand paging.

tty  The  port  from which  the  process  was launched.   This  can be  the
     console, a pseudo-tty, or a serial port.

S    The process's status, as follows:

     R   Ready to run (waiting for CPU time)
     S   Stopped for other reasons (I/O completion, pause, etc.)
     T   Process is being traced by another process
     W   Waiting for an existent child
     Z   Zombie (dead, but parent not waiting)

Command
     The name of the program that this process represents.

One of  the process lines will  be highlighted.  You can  shift the line of
highlighting  by  pressing the  keys  ^  and v.   When  a  process line  is
highlighted, you can  send that process a signal simply  by pressing a key,
as follows:

1  Send signal HUP. Equivalent to typing kill -1.

2  Send signal INTR. Equivalent to typing kill -2.

3  Send signal QUIT. Equivalent to typing kill -3.

9  Send signal KILL. Equivalent to typing kill -9.

Whether the signal  has any effect will, of course,  depend upon the degree
of control you have over that process.

To refresh the hmon screen, type L. To quit, type Q.

See Also

commands,
ps

Notes

hmon reads the free memory from /dev/freemem. If this device does not exist
on your system, create it as follows:

    mknod /dev/freemem c 0 12
    chmog 444 sys sys /dev/freemem

hmon  uses curses  to  manage its  display.   Your screen  will not  appear
properly if  the environmental variable  TERM is not set  correctly for the
display device you are using, or if its terminfo entry is not correct.

hmon was written by Harry C. Pulley, IV (hpulley@uoguelph.ca).

© 2012 by Stephen A. Ness