SunOS / Solaris?

: top -v
top: version 3.5beta12.10

bash-2.03$ uname -a                                          
SunOS ######## 5.8 Generic_108528-22 sun4us sparc FJSV,GPUZC-
bash-2.03$ which top                                         
/usr/local/bin/top                                           
bash-2.03$ man top                                                   
Kein Eintrag im Online-Handbuch für top.                             
bash-2.03$ info top                                                  
sh: pvers: nicht gefunden                                            
bash-2.03$ top --help                                                
top: illegal option -- -                                             
Top version 3.5beta12                                                
Usage: top [-ISbinqu] [-d x] [-s x] [-o field] [-U username] [number]
bash-2.03$

: uname -a
SunOS #### 5.9 Generic_118558-19 sun4u sparc SUNW,Sun-Fire-V240

: top -h
top: illegal option -- h
Top version 3.5beta12.10
Usage: top [-ISbinquC] [-d x] [-s x] [-o field] [-U username] [-m n|k|m ] [number]

User Commands                                              TOP(1)



NAME
     top - display and  update  information  about  the  top  cpu
     processes

SYNOPSIS
     top [ -SbiInquvC ] [ -dcount ] [ -stime  ]  [  -ofield  ]  [
     -Uusername ] [ -mn|k|m ] [ number ]

DESCRIPTION
     Top displays the top 15 processes on the system and periodi-
     cally  updates this information.  Raw cpu percentage is used
     to rank the processes.  If number is  given,  then  the  top
     number processes will be displayed instead of the default.

     Top makes  a  distinction  between  terminals  that  support
     advanced  capabilities and those that do not.  This distinc-
     tion affects the choice of defaults for certain options.  In
     the remainder of this document, an "intelligent" terminal is
     one that supports cursor addressing, clear screen, and clear
     to  end  of line.  Conversely, a "dumb" terminal is one that
     does not support such features.  If the  output  of  top  is
     redirected  to  a file, it acts as if it were being run on a
     dumb terminal.

OPTIONS
     -S   Show system processes in the display.  Normally, system
          processes  such  as  the  pager and the swapper are not
          shown.  This option makes them visible.

     -b   Use "batch" mode.  In this mode,  all  input  from  the
          terminal  is ignored.  Interrupt characters (such as ^C
          and ^\) still have an effect.  This is the default on a
          dumb terminal, or when the output is not a terminal.

     -i   Use "interactive" mode.  In this  mode,  any  input  is
          immediately  read  for  processing.  See the section on
          "Interactive Mode" for an  explanation  of  which  keys
          perform  what  functions.   After  the  command is pro-
          cessed, the screen will immediately be updated, even if
          the  command  was  not  understood.   This  mode is the
          default when standard output is an  intelligent  termi-
          nal.

     -I   Do  not  display  idle  processes.   By  default,   top
          displays both active and idle processes.

     -m n|k|m
          Format memory size figures using no (n) units, Kbs (k),
          or Mbs (m).  When top is running the "m" command can be
          used to switch between formats.

     -n   Use "non-interactive"  mode.   This  is  indentical  to
          "batch" mode.

     -q   Renice top to -20 so that it will run faster.  This can
          be  used  when  the  system  is  being very sluggish to
          improve the possibility  of  discovering  the  problem.
          This option can only be used by root.

     -u   Do not take the time to map uid numbers  to  usernames.
          Normally,   top   will   read   as  much  of  the  file
          "/etc/passwd" as is necessary to map all  the  user  id
          numbers  it  encounters  into login names.  This option
          disables all that, while possibly decreasing  execution
          time.   The  uid  numbers  are displayed instead of the
          names.

     -v   Write version number information to  stderr  then  exit
          immediately.  No other processing takes place when this
          option is used.  To see  current  revision  information
          while top is running, use the help command "?".


     -C   Use ANSI colours when displaying.  Settings for  colour
          choice are parsed from the TOPCOLOURS environment vari-
          able, which takes the form of 1 or more colour  defini-
          tions  seperated with a colon (:).  Each colour defini-
          tion looks like <type>=<min>,<max>#<colour def>

          Valid  type  names  depend  on  the  machine  dependent
          module,  but include 1min, 5min, 15min, cpu, res, size,
          time. The meaning of the <min> and <max> values  depend
          on the type, for example Mbytes for res and size types,
          and load/100 for load averages, as  only  integers  are
          valid. Leave blank to mean no limit.

          The colour_def is a list  of  ANSI  colour  codes  (Eg.
          black(30), red(31), green(32), yellow(33)), and effects
          (Eg. bright(1), dim(2), underscore(4)).
          Different terminal types handle none, some, or  all  of
          these control codes.

          The default setting is:
          cpu=25,75#31:cpu=75,#31;1:size=50,100#35:size=100,#35;1:res=50,100#35:res=100,#35;1:1min=,100#32:1min=100,500#33:1min=500,#31;1:5min=,100
#32:5min=100,500#33:5min=500,#31;1:15min=,100#32:15min=100,500#33:15min=500,#31;1;host=,#36

     -dcount
          Show only count displays, then exit.  A display is con-
          sidered  to  be  one update of the screen.  This option
          allows the user to select the  number  of  displays  he
          wants  to  see  before  top  automatically  exits.  For
          intelligent terminals, no  upper  limit  is  set.   The
          default is 1 for dumb terminals.

     -stime
          Set the delay between screen updates to  time  seconds.
          The default delay between updates is 5 seconds.

     -ofield
          Sort the process display area on the  specified  field.
          The field name is the name of the column as seen in the
          output, but in lower case.  Likely  values  are  "cpu",
          "size",  "res",  and  "time", but may vary on different
          operating systems.  Note that not all operating systems
          support this option.

     -Uusername
          Show only those  processes  owned  by  username.   This
          option  currently  only  accepts usernames and will not



          understand uid numbers.

     Both count and number fields can be specified as "infinite",
     indicating  that  they can stretch as far as possible.  This
     is accomplished by using any proper prefix of  the  keywords
     "infinity",  "maximum",  or "all".  The default for count on
     an intelligent terminal is, in fact, infinity.

     The environment variable TOP is examined for options  before
     the command line is scanned.  This enables a user to set his
     or her own defaults.  The number of processes to display can
     also  be  specified  in  the  environment variable TOP.  The
     options -I, -S, and  -u  are  actually  toggles.   A  second
     specification of any of these options will negate the first.
     Thus a user who has the environment variable TOP set to "-I"
     may use the command "top -I" to see idle processes.

INTERACTIVE MODE
     When top is running in "interactive mode", it reads commands
     from  the  terminal and acts upon them accordingly.  In this
     mode, the terminal is put in "CBREAK", so that  a  character
     will  be processed as soon as it is typed.  Almost always, a
     key will be pressed when top is between displays;  that  is,
     while  it is waiting for time seconds to elapse.  If this is
     the case, the command will be processed and the display will
     be  updated  immediately  thereafter (reflecting any changes
     that the command may have specified).  This happens even  if
     the command was incorrect.  If a key is pressed while top is
     in the middle of updating the display, it  will  finish  the
     update  and then process the command.  Some commands require
     additional  information,  and  the  user  will  be  prompted
     accordingly.   While  typing this information in, the user's
     erase and kill keys (as set up  by  the  command  stty)  are
     recognized, and a newline terminates the input.

     These  commands  are  currently  recognized  (^L  refers  to
     control-L):

     ^L   Redraw the screen.

     h or ?
          Display a summary of the commands (help screen).   Ver-
          sion information is included in this display.

     q    Quit top.

     c    Toggle colours on/off.

     d    Change the number of displays to show (prompt  for  new
          number).  Remember that the next display counts as one,
          so typing d1 will make top show one final  display  and
          then immediately exit.

     m    Change the  prefered  display  of  memory  size  values
          (none, Kb, Mb).

     n or #
          Change the number of processes to display  (prompt  for
         new number).

     s    Change the number of seconds to delay between  displays
          (prompt for new number).

     k    Send  a  signal  ("kill"  by  default)  to  a  list  of
          processes.    This   acts   similarly  to  the  command
          kill(1)).

     r    Change  the  priority  (the  "nice")  of  a   list   of
          processes.   This  acts  similarly  to the command ren-
          ice(8)).

     u    Display only processes owned  by  a  specific  username
          (prompt  for  username).   If the username specified is
          simply "+", then processes belonging to all users  will
          be displayed.

     o    Change the order in which the display is sorted.   This
          command  is not available on all systems.  The sort key
          names vary fron system to system but  usually  include:
          "cpu", "res", "size", "time".  The default is cpu.

     e    Display a list of system errors (if any)  generated  by
          the last kill or renice command.

     i    (or I) Toggle the display of idle processes.

THE DISPLAY
     The actual display varies depending on the specific  variant
     of  Unix  that the machine is running.  This description may
     not exactly match what is seen by top running on  this  par-
     ticular  machine.  Differences are listed at the end of this
     manual entry.

     The top few lines of the display  show  general  information
     about the state of the system, including the last process id
     assigned to a process (on  most  systems),  the  three  load
     averages,   the   current   time,  the  number  of  existing
     processes, the number of processes in each state  (sleeping,
     running,  starting,  zombies, and stopped), and a percentage
     of time spent in each of the processor states  (user,  nice,
     system,  and idle).  It also includes information about phy-
     sial and virtual memory allocation.

     The remainder of the screen displays information about indi-
     vidual  processes.   This  display  is  similar in spirit to
     ps(1) but it is not exactly the same.  PID  is  the  process
     id,  USERNAME  is  the name of the process's owner (if -u is
     specified, a UID column will be substituted  for  USERNAME),
     PRI is the current priority of the process, NICE is the nice
     amount (in the range -20 to 20), SIZE is the total  size  of
     the  process  (text,  data,  and  stack), RES is the current
     amount of resident memory (both SIZE and RES  are  given  in
     kilobytes),  STATE  is  the  current  state (one of "sleep",
     "WAIT", "run", "idl", "zomb", or "stop"), TIME is the number
     of  system  and  user cpu seconds that the process has used,
     WCPU, when displayed, is the weighted cpu  percentage  (this
     is  the  same  value that ps(1) displays as CPU), CPU is the
     raw percentage and is the field that is sorted to  determine
     the  order  of the processes, and COMMAND is the name of the
     command that the process is currently running (if  the  pro-
     cess is swapped out, this column is marked "<swapped>").

NOTES
     The "ABANDONED" state (known in the kernel as  "SWAIT")  was
     abandoned,  thus the name.  A process should never end up in
     this state.

AUTHOR
     William LeFebvre, EECS Department, Northwestern University

ENVIRONMENT
     TOP            user-configurable defaults for options.
     TOPCOLOURS       user-configurable   settings   for   colour
     display.

FILES
     /dev/kmem      kernel memory
     /dev/mem       physical memory
     /etc/passwd         used to map uid numbers to user names
     /vmunix        system image

BUGS
     Don't shoot me, but the default  for  -I  has  changed  once
     again.   So  many  people were confused by the fact that top
     wasn't showing them all the processes that I have decided to
     make  the default behavior show idle processes, just like it
     did in version 2.  But to appease folks who can't stand that
     behavior,  I have added the ability to set "default" options
     in the environment variable TOP (see the  OPTIONS  section).
     Those  who  want the behavior that version 3.0 had need only
     set the environment variable TOP to "-I".

     The command name for swapped  processes  should  be  tracked
     down, but this would make the program run slower.

     As with ps(1), things can change  while  top  is  collecting
     information  for  an update.  The picture it gives is only a
     close approximation to reality.

SEE ALSO
     kill(1), ps(1), stty(1), mem(4), renice(8)

SUNOS 57 NOTES
     CPU percentage is calculated as a fraction of  total  avail-
     able computing resources.  Hence on a multiprocessor machine
     a single threaded process can  never  consume  cpu  time  in
     excess  of 1 divided by the number of processors.  For exam-
     ple, on a 4 processor machine,  a  single  threaded  process
     will  never  show a cpu percentage higher than 25%.  The CPU
     percentage  column  will  always  total  approximately  100,
     regardless of the number of processors.

     The memory summary line displays the  following:  "real"  is
     the  amount of physical memory that can be allocated for use
     by processes (it does not include memory  reserved  for  the
     kernel's  use), "free" is the amount of unallocated physical
     memory, "swap in use" is the amount of swap  that  has  been
     reserved  for use, "swap free" is the amount of swap area on
     disk that is still available.  The swap figures will  differ
     from  the  summary  output  of  swap(1M)  since  the  latter
     includes physical memory as well.   The  figures  shown  for
     "free",  "swap in use", and "swap free" are actually average
     figures for usage between  screen  updates,  rather  than  a
     snapshot.

     The column "TH" indicates the number of execution threads in
     the process.

     The column "FLTS" is the number of  major  page  faults  the
     process has caused since the last update.

     Valid colour values for TOPCOLOURS are  1min,  5min,  15min,
     cpu, size, res, time, flts.

     This     version      written      by      Chris      Hughes
     <chris@spang.uk.eu.org>, building on the SunOS 5 port origi-
     nally  written  by   Torsten   Kasch   <torsten@techfak.uni-
     bielefeld.de>.