1RADWHO(1)                      FreeRADIUS Daemon                     RADWHO(1)
2
3
4

NAME

6       radwho - show online users
7

SYNOPSIS

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

DESCRIPTION

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

OPTIONS

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

SEE ALSO

83       radiusd(8), radclient(1), radiusd.conf(5).
84

AUTHOR

86       Miquel van Smoorenburg, miquels@cistron.nl.
87
88
89
90                                  17 Feb 2013                        RADWHO(1)