File: whowatch.1

package info (click to toggle)
whowatch 1.8.6-1
  • links: PTS
  • area: main
  • in suites: bullseye, buster, sid
  • size: 668 kB
  • sloc: ansic: 3,383; sh: 1,232; makefile: 36
file content (110 lines) | stat: -rw-r--r-- 3,180 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
.TH WHOWATCH 1 "27 Feb 2000"
.SH NAME
whowatch \- console, interactive, process and users monitoring tool.
.SH DESCRIPTION
\fBWhowatch\fR 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.
.PP
.nh
\fBWhowatch\fR has no command line options or configuration file.
All actions are performed in real time by pressing following keys:
.PP
Users list mode:
.PP
.TP
.B 'up' 'down'
cursor movement
.TP
.B 'i'
toggle between user command line and idle time
.TP
.B '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.
.TP
.B 'enter'
view selected user's processes tree.
.TP
.B 't'
all system processes (init tree)
.PP
Tree mode:
.TP
.B 'up' 'down'
cursor movement
.TP
.B 'enter'
go back to users list
.TP
.B 'o'
show processes owners
.TP
.B '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.
.TP
.B 'Ctrl-I'
send INT signal to selected process
.TP
.B 'Ctrl-K'
send KILL signal to selected process
.TP
.B 'Ctrl-U'
send HUP signal to selected process
.TP
.B 'Ctrl-T'
send TERM signal to selected process

.SH PLUGINS
Whowatch has ability to load plugin during program run.
Plugin prints information inside details window.
Plugins gives flexibility: if some specific 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.



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

.PD
.SH "SEE ALSO"
.BR finger (1)
.BR ps (1),
.BR pstree (1),
.BR top (1),
.BR w (1),
.BR lsof (8),
.BR kill (1)
.BR killall (1)

.SH "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 incorrect results ie. there will be incorrect processes
tree associated with user's session.

.SH "AUTHOR"
.nf
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
.fi