RADWHO(1)		       FreeRADIUS Daemon		     RADWHO(1)



NAME
       radwho - show online users

SYNOPSIS
       radwho  [-c]  [-d  raddb_directory]  [-F  radutmp_file]	[-i]  [-n] [-N
       nas_ip_address] [-p] [-P nas_port] [-r] [-R] [-s] [-S]  [-u  user]  [-U
       user] [-Z]

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

OPTIONS
       -c     Shows caller ID (if available) instead of the full name.

       -d raddb_directory
	      The  directory that contains the RADIUS configuration files. De-
	      faults to /etc/raddb.

       -F radutmp_file
	      The file that contains the radutmp file.	If this is  specified,
	      -d is not necessary.

       -i     Shows the session ID instead of the full name.

       -n     Normally	radwho	looks  up the username in the systems password
	      file, and shows the full username as well. The -n flags prevents
	      this.

       -N nas_ip_address
	      Show only those entries which match the given NAS IP address.

       -p     Adds  an extra column for the port type - I for ISDN, A for Ana-
	      log.

       -P nas_port
	      Show only those entries which match the given NAS port.

       -r     Outputs all data in raw format  -  no  headers,  no  formatting,
	      fields are comma-separated.

       -R     Output  all  data  in  RADIUS  attribute format.	All fields are
	      printed.

       -s     Show full name.

       -S     Hide shell users. Doesn't show the entries for users that do not
	      have a SLIP or PPP session.

       -u user
	      Show only those entries which match the given username (case in-
	      sensitive).

       -U user
	      Show only those entries which match  the	given  username  (case
	      sensitive).

       -Z     When combined with -R, prints out the contents of an Accounting-
	      Request packet which can be passed to  radclient,  in  order  to
	      "zap" that users session from radutmp.

       For example,

	      $ radwho -ZRN 10.0.0.1 | radclient -f - radius.example.net acct testing123

       will  result  in all an Accounting-Request packet being sent to the RA-
       DIUS server, which tells the server that the  NAS  rebooted.   i.e.  It
       "zaps" all of the users on that NAS.

       To "zap" one user, specify NAS, username, and NAS port:

	      $ radwho -ZRN 10.0.0.1 -u user -P 10 | radclient -f - radius.example.net acct testing123

       Other combinations are also possible.


SEE ALSO
       radiusd(8), radclient(1), radiusd.conf(5).

AUTHOR
       Miquel van Smoorenburg, miquels@cistron.nl.



				  17 Feb 2013			     RADWHO(1)