1RADWHO(1) FreeRADIUS Daemon RADWHO(1)
2
3
4
6 radwho - show online users
7
9 radwho [-c] [-d raddb_directory] [-F radutmp_file] [-i] [-n] [-N
10 nas_ip_address] [-p] [-P nas_port] [-r] [-R] [-s] [-S] [-u user] [-U
11 user] [-Z]
12
14 The FreeRADIUS server can be configured to maintain an active session
15 database in a file called radutmp. This utility shows the content of
16 that session database.
17
19 -c Shows caller ID (if available) instead of the full name.
20
21 -d raddb_directory
22 The directory that contains the RADIUS configuration files.
23 Defaults to /etc/raddb.
24
25 -F radutmp_file
26 The file that contains the radutmp file. If this is specified,
27 -d is not necessary.
28
29 -i Shows the session ID instead of the full name.
30
31 -n Normally radwho looks up the username in the systems password
32 file, and shows the full username as well. The -n flags prevents
33 this.
34
35 -N nas_ip_address
36 Show only those entries which match the given NAS IP address.
37
38 -p Adds an extra column for the port type - I for ISDN, A for Ana‐
39 log.
40
41 -P nas_port
42 Show only those entries which match the given NAS port.
43
44 -r Outputs all data in raw format - no headers, no formatting,
45 fields are comma-separated.
46
47 -R Output all data in RADIUS attribute format. All fields are
48 printed.
49
50 -s Show full name.
51
52 -S Hide shell users. Doesn't show the entries for users that do not
53 have a SLIP or PPP session.
54
55 -u user
56 Show only those entries which match the given username (case
57 insensitive).
58
59 -U user
60 Show only those entries which match the given username (case
61 sensitive).
62
63 -Z When combined with -R, prints out the contents of an Accounting-
64 Request packet which can be passed to radclient, in order to
65 "zap" that users session from radutmp.
66
67 For example,
68
69 $ radwho -ZRN 10.0.0.1 | radclient -f - radius.example.net acct testing123
70
71 will result in all an Accounting-Request packet being sent to the
72 RADIUS server, which tells the server that the NAS rebooted. i.e. It
73 "zaps" all of the users on that NAS.
74
75 To "zap" one user, specify NAS, username, and NAS port:
76
77 $ radwho -ZRN 10.0.0.1 -u user -P 10 | radclient -f - radius.example.net acct testing123
78
79 Other combinations are also possible.
80
81
83 radiusd(8), radclient(1), radiusd.conf(5).
84
86 Miquel van Smoorenburg, miquels@cistron.nl.
87
88
89
90 17 Feb 2013 RADWHO(1)