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

NAME

6       radwho - show online users
7

SYNOPSIS

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

SEE ALSO

86       radiusd(8), radclient(1), radiusd.conf(5).
87

AUTHOR

89       Miquel van Smoorenburg, miquels@cistron.nl.
90
91
92
93                                  26 Dec 2011                        RADWHO(1)
Impressum