1WHOWATCH(1)                 General Commands Manual                WHOWATCH(1)
2
3
4

NAME

6       whowatch - console, interactive, process and users monitoring tool.
7

DESCRIPTION

9       Whowatch  is an console, interactive users and process monitoring tool.
10       It displays information about the users  currently  logged  on  to  the
11       machine,  in real-time.  Besides standard information (login name, tty,
12       host, user's process), the type of the connection (ie. telnet  or  ssh)
13       is  shown.   Display  of  users  command line can be switch to tty idle
14       time.  Certain user can be selected  and  his  processes  tree  may  be
15       viewed  as  well as tree of all system processes. Tree may be displayed
16       with additional column that  shows  owner  of  each  process.   In  the
17       process  tree  mode  SIGINT, SIGHUP, SIGTERM and SIGKILL signals can be
18       sent to the selected process. Killing processes is just as  simple  and
19       fun as deleting lines on the screen.
20
21       Whowatch  has  no  command  line  options  or  configuration file.  All
22       actions are performed in real time by pressing following keys:
23
24       Users list mode:
25
26       'up' 'down'
27              cursor movement
28
29       'i'    toggle between user command line and idle time
30
31       'c'    full command line on/off. Disabling full command line  can  save
32              CPU  time.   It  can  give  you also some additional information
33              about process executable.
34
35       'enter'
36              view selected user's processes tree.
37
38       't'    all system processes (init tree)
39
40       Tree mode:
41
42       'up' 'down'
43              cursor movement
44
45       'enter'
46              go back to users list
47
48       'o'    show processes owners
49
50       'c'    full command line on/off. Disabling full command line  can  save
51              CPU  time.   It  can  give  you also some additional information
52              about process executable.
53
54       'Ctrl-I'
55              send INT signal to selected process
56
57       'Ctrl-K'
58              send KILL signal to selected process
59
60       'Ctrl-U'
61              send HUP signal to selected process
62
63       'Ctrl-T'
64              send TERM signal to selected process
65
66

PLUGINS

68       Whowatch has ability to load plugin during program run.  Plugin  prints
69       information  inside details window.  Plugins gives flexibility: if some
70       specific information about process,  user  or  system  is  needed  then
71       separate  program  could  be written to obtain such information.  Since
72       there are three kinds of deatils  window  (process,  user  and  system)
73       maximum  three  plugins can be loaded.  Whowatch has very simple API to
74       write plugins.
75
76
77
78

FILES

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

SEE ALSO

86       finger(1) ps(1), pstree(1), top(1), w(1), lsof(8), kill(1) killall(1)
87
88

BUGS

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

AUTHOR

98       Michal Suszycki <mike@wizard.ae.krakow.pl>,
99       http://wizard.ae.krakow.pl/~mike
100       Tree functions written by Jan Bobrowski <jb@wizard.ae.krakow.pl>,
101       http://wizard.ae.krakow.pl/~jb
102
103
104
105                                  27 Feb 2000                      WHOWATCH(1)