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

NAME

6       radwho - show online users
7

SYNOPSIS

9       radwho  [-c]  [-d  raddb_directory]  [-f] [-i] [-n] [-N nas_ip_address]
10       [-p] [-P nas_port] [-r] [-R] [-s] [-S] [-u user] [-U user] [-Z]
11

DESCRIPTION

13       The FreeRADIUS server can be configured to maintain an  active  session
14       database  in  a  file called radutmp. This utility shows the content of
15       that session database.
16

OPTIONS

18       -c     Shows caller ID (if available) instead of the full name.
19
20       -d raddb_directory
21              The directory that  contains  the  RADIUS  configuration  files.
22              Defaults to /etc/raddb.
23
24       -f     Behave  as  the  'fingerd' daemon - waits for one line of input,
25              then prints the output with lines \r\n terminated.
26
27       -i     Shows the session ID instead of the full name.
28
29       -n     Normally radwho looks up the username in  the  systems  password
30              file, and shows the full username as well. The -n flags prevents
31              this.
32
33       -N nas_ip_address
34              Show only those entries which match the given NAS IP address.
35
36       -p     Adds an extra column for the port type - I for ISDN, A for  Ana‐
37              log.
38
39       -P nas_port
40              Show only those entries which match the given NAS port.
41
42       -r     Outputs  all  data  in  raw  format - no headers, no formatting,
43              fields are comma-separated.
44
45       -R     Output all data in RADIUS  attribute  format.   All  fields  are
46              printed.
47
48       -s     Show full name.
49
50       -S     Hide shell users. Doesn't show the entries for users that do not
51              have a SLIP or PPP session.
52
53       -u user
54              Show only those entries which match  the  given  username  (case
55              insensitive).
56
57       -U user
58              Show  only  those  entries  which match the given username (case
59              sensitive).
60
61       -Z     When combined with -R, prints out the contents of an Accounting-
62              Request  packet  which  can  be passed to radclient, in order to
63              "zap" that users session from radutmp.
64
65       For example,
66
67              $ radwho -ZRN 10.0.0.1 | radclient -f - radius.example.net acct testing123
68
69       will result in all an  Accounting-Request  packet  being  sent  to  the
70       RADIUS  server,  which tells the server that the NAS rebooted.  i.e. It
71       "zaps" all of the users on that NAS.
72
73       To "zap" one user, specifiy NAS, username, and NAS port:
74
75              $ radwho -ZRN 10.0.0.1 -u user -P 10 | radclient -f - radius.example.net acct testing123
76
77       Other combinations are also possible.
78
79

SEE ALSO

81       radiusd(8), radclient(1), radiusd.conf(5).
82

AUTHOR

84       Miquel van Smoorenburg, miquels@cistron.nl.
85
86
87
88                                 7 April 2005                        RADWHO(1)