radwho(1)

NAME
radwho - display who is logged on by the Radius

SYNOPSIS
radwho [-A, --all] [-c, --calling-id] [-d,--directory DIR] [-D,--date-format {short|abbr|full}] [-e,--empty STRING] [-f,--file FILE] [-F,--finger] [-h,--help] [-H,--no-header] [-i,--session-id] [-I,--ip-format {smart|ip|nodomain}] [-o,--format FORMAT] [-s,--secure]

NOTE
The information in this manpage may be obsolete or incomplete. Please refer to texinfo documentation for full information about GNU Radius tools.

DESCRIPTION
Radwho displays the list of users currently logged in by the Radius server.

Default output information is made compatible with that of the standard unix finger(1) utility. For each user the following information is displayed: login name, name, connection protocol, NAS port, login date, NAS name, assigned IP address or corresponding network name.

When used with -l option, the long output format is used. In this format the following information is output:

Login
    Login name of the user

SessionID
    Unique session ID assigned by the terminal server.

Proto
    Connection prototype.

Port
    Port number

When
    Login date and time

From
    The name of NAS that accepted the connection.

Location
    Framed IP address or the corresponding network name.

Caller
    Caller station ID ad reported by the NAS.

Duration
    Duration of the session.

OPTIONS

-A, --all
    Display the information about logged-out users as well. The logged-out users are shown with Proto field set to HUP.

-c, --calling-id
    Display the calling station ID in the second column.

-d, --directory NAME
    Set the radius configuration directory name.

-D, --date-formap {short|abbr|full}
    Set the date representation. By default dates are output as DOW HH:MM, where DOW means the day of week abbreviation, HH and MM mean hours and minutes respectively. This corresponds to option -D short. Other available formats are: abbr for abbreviated date: MM/DD HH:MM, where MM is a two-digit month number, DD --- a two-digit day of month, and fullfor full data output, like this: Mon Dec 18 12:29:38 EET 2000.

-e, --empty STRING
    Display any empty field as STRING. This is useful when the output of radwho is fed to some analyzing program, as it helps to keep the same number of columns on each line of output.

-F, --finger
    Start in fingerd mode. In this mode radwho emulates the behaviour of fingerd(8) utility. Use this option if starting radwho from the /etc/inetd.conf line like this:

    finger stream tcp nowait nobody /usr/sbin/radwho radwho -fL

    This mode is also enabled by default if radwho notices that its name (argv[0]) is fingerd or in.fingerd.

-H, --no-header
    Don't display header line.

-i, --session-id
    Display session ID instead of GECOS in the second column.

-I, --ip-format
    Change IP address representation.

-L, --local-also
    Display information about local users from the system utmp file. May prove useful when running radwho as a finger daemon.

-n, --no-resolve
    Do not resolve IP addresses. It is a synonim for -I ip.

-o, --format FORMAT
    Select customized output format. This can also be changed by setting the value of environment variable RADWHO_FORMAT. See FORMAT STRING section below.

-s, --secure
    Run in secure mode. Queries without a user name are rejected.

FORMAT STRING

The format string is a comma-separated list of format specifications in one of the following forms:

field
    Output field with its default width, heading and alignment. The field names and corresponding default values are discussed in detail below.

field:width
    Output field, use column width width. If width starts with a plus sign, the field will be right-aligned, if it starts with a minus sign, the field will be left-aligned. Otherwise the default alignment will be used

field:width:heading
    The same as above, but also supplies the heading for the column

The field names are:

login
    Login name

orig
    Original login name as supplied with the request.

port
    NAS port number

sid The Session ID

nas The NAS name or IP address.

ip  Framed IP address assigned to the user, if it is provided framed service.

proto
    Connection protocol. Its possible values are:

date
    Date/time when the session started

delay
    Delay time.

type
    Entry type in decimal.

ptype
    Port type. This is one of the following letters:

time
    Total time of the session duration.

clid
    The calling station ID.

uname
    The GECOS field from local /etc/passwd, corresponding to the login name. If the user does not have a local account, his login name is output.

FILES

/etc/raddb/naslist

/usr/adm/radutmp

AUTHORS
Sergey Poznyakoff, gray@farlep.net

SEE ALSO
radiusd(8rad), radgrep(1rad), radping(8rad), naslist(5rad)