Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
WHOWATCH(1)		     General Commands Manual		     WHOWATCH(1)

NAME
     whowatch - console, interactive, process and users monitoring tool.

DESCRIPTION
     Whowatch  is an console, interactive users and process monitoring tool.  It
     displays information about the users currently logged on to the machine, in
     real-time.  Besides standard information (login  name,  tty,  host,  user's
     process), the type of the connection (ie. telnet or ssh) is shown.  Display
     of  users command line can be switch to tty idle time.  Certain user can be
     selected and his processes tree may be viewed as well as tree of all system
     processes. Tree may be displayed with additional column that shows owner of
     each process.  In the process tree mode SIGINT, SIGHUP, SIGTERM and SIGKILL
     signals can be sent to the selected process. Killing processes is	just  as
     simple and fun as deleting lines on the screen.

     Whowatch  has  no	command line options or configuration file.  All actions
     are performed in real time by pressing following keys:

     Users list mode:

     'up' 'down'
	    cursor movement

     'i'    toggle between user command line and idle time

     'c'    full command line on/off. Disabling full command line can  save  CPU
	    time.   It	can  give  you	also  some  additional information about
	    process executable.

     'enter'
	    view selected user's processes tree.

     't'    all system processes (init tree)

     Tree mode:

     'up' 'down'
	    cursor movement

     'enter'
	    go back to users list

     'o'    show processes owners

     'c'    full command line on/off. Disabling full command line can  save  CPU
	    time.   It	can  give  you	also  some  additional information about
	    process executable.

     'Ctrl-I'
	    send INT signal to selected process

     'Ctrl-K'
	    send KILL signal to selected process

     'Ctrl-U'
	    send HUP signal to selected process

     'Ctrl-T'
	    send TERM signal to selected process

PLUGINS
     Whowatch has ability to load plugin during program run.  Plugin prints  in-
     formation	inside	details window.  Plugins gives flexibility: if some spe-
     cific information about process, user or system  is  needed  then	separate
     program could be written to obtain such information.  Since there are three
     kinds  of	deatils  window (process, user and system) maximum three plugins
     can be loaded.  Whowatch has very simple API to write plugins.

FILES
     Program reads /var/log/wtmp, /var/run/utmp. Under Linux program also  reads
     files  from  /proc  directory.  Without read access to these files whowatch
     funcionality will be limited or program will not even start.

SEE ALSO
     finger(1) ps(1), pstree(1), top(1), w(1), lsof(8), kill(1) killall(1)

BUGS
     Because lack of ut_pid in utmp and wtmp structures in *BSD systems, program
     tries to obtain pid of a login shell  by  analyzing  processes  controlling
     terminal  and  processes names. Under some conditions it may lead to incor-
     rect results ie. there will be incorrect  processes  tree	associated  with
     user's session.

AUTHOR
     Michal Suszycki <mike@wizard.ae.krakow.pl>,
     http://wizard.ae.krakow.pl/~mike/
     Tree functions written by Jan Bobrowski <jb@wizard.ae.krakow.pl>,
     http://wizard.ae.krakow.pl/~jb/

				   27 Feb 2000			     WHOWATCH(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=whowatch&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help