[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
radwho
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 or corresponding network name.
When used with ‘-l’ option, the long output format is used. In this format the following information is output:
Login name of the user
Unique session ID assigned by the terminal server.
Connection prototype.
Port number
Login date and time
Name of the NAS that accepted the connection.
Framed IP or the corresponding network name.
Caller station ID ad reported by the NAS.
Duration of the session.
11.1.1 radwho Command Line Options | Command line options. | |
11.1.2 radwho Format Strings | ||
11.1.3 radwho Predefined Formats |
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
radwho
Command Line Options The following command line options can be used to modify the behavior of the program:
Display the information about logged-out users as well. The logged-out users are shown with ‘Proto’ field set to HUP.
Display the calling station ID in the second column. Equivalent to ‘--format clid’.
Set the Radius configuration directory name.
Set the date representation. Th fmt is usual strftime(3)
format string. It defaults to %a %H:%M
, i.e. the abbreviated weekday
name according to the current locale, and the hour and the minutes as two-digit
decimal numbers.
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.
Start in fingerd
mode. In this mode radwho
emulates the
behavior of the fingerd(8)
utility. Use this option if starting
radwho
from the ‘/etc/inetd.conf’ line like this (5):
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’.
Don't display header line.
Display session ID instead of GECOS in the second column. Equivalent to ‘--format sid’.
Display hostnames without domain part.
Display information about local users from the system ‘utmp’ file.
May prove useful when running radwho
as a finger daemon.
Do not resolve IP.
Select customized output format. This can also be changed by setting
the value of environment variable RADWHO_FORMAT
. The format
is either a symbolic name of one of the predefined formats or a format
specification (see next subsection).
Run in secure mode. Queries without a user name are rejected.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
radwho
Format Strings A format string controls the output of every record from ‘radutmp’. It contains two types of objects: ordinary characters, which are simply copied to the output, and format specifications, each of which causes output of a particular piece of information from the ‘radutmp’ record.
Each format specification starts with an opening brace and ends with a closing brace. The first word after the brace is the name of the format specification. The rest of words are positional arguments followed by keyword arguments. Both are optional. The keyword arguments begin with a colon and must follow the positional arguments.
The full list of format specifications follows.
Causes the newline character to be output. If the optional count is supplied, that many newlines will be printed
Advance to the next tabstop in the output stream. If optional num is present, then skip num tabstops. Each tabstop is eight characters long.
The following specifications output particular fields of a ‘radutmp’ record. They all take two positional arguments: width and title.
The first argument, width sets the maximum output
length for this specification. If the number of characters actually output
is less than the width, they will be padded with whitespace either to
the left or to the right, depending on the presence of the :right
keyword argument. If the number of characters is greater than width, they
will be truncated to fit. If width is
not given, the exact data are output as is.
The second argument, title, gives the title of this column for the heading line. By default no title is output.
Every field specification accepts at least two keyword arguments.
The keyword :right
may be used to request alignment to the right
for the data. This keyword is ignored if width is not given.
The keyword :empty
followed by a string causes radwho
to output that string if the resulting value for this specification
would otherwise be empty.
Print the user login name.
Print original login name as supplied with the request.
The GECOS field from the local ‘/etc/passwd’ corresponding to the login name. If the user does not have a local account, his login name is output.
NAS port number
The session ID.
The NAS name or IP.
The :nodomain
keyword suppresses the output of the domain part of
the name, i.e., the hostname is displayed only up to the first dot.
Framed IP assigned to the user, if any.
The :nodomain
keyword suppresses the output of the domain part of
the name, i.e. the hostname is displayed only up to the first dot.
Connection protocol as reported by Framed-Protocol
attribute.
If the symbolic value is found in the dictionary file, it will be
displayed. Otherwise, the numeric value will be displayed as is.
Date and time when the session started.
The :format
keyword introduces the strftime
format string
to be used when converting the date for printing. The default value is
%a %H:%M
.
Total time of the session duration.
Delay time (see section Acct-Delay-Time
).
Port type as reported by the value of the NAS-Port-Type
attribute.
If the symbolic value is found in the dictionary file, it will be
displayed. Otherwise, the numeric value will be displayed as is.
The calling station ID.
If the request was forwarded to a realm server, print the symbolic name
of the realm from the ‘raddb/realms’ file. If no symbolic name
is found, print the remote server IP or hostname. In the latter case,
the :nodomain
keyword may be used to suppress the output of the
domain part of the name, i.e. to display the hostname only up to the
first dot.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
radwho
Predefined Formats The predefined formats are:
Default output format. Each record occupies one line. The fields output are: login name, GECOS name, connection protocol, port number, time when the connection was initiated, NAS IP, and assigned framed IP. This corresponds to the following format specification (split in several lines for readability:
(login 10 Login) (gecos 17 Name) \ (protocol 5 Proto) (nas-port 5 TTY) \ (time 9 When) (nas-address 9 From) \ (framed-address 16 Location) |
The same as ‘default’, except that the session ID is output in the second column.
The same as ‘default’, except that the calling station ID is output in the second column.
Outputs all information from each ‘radutmp’ record. It is equivalent to specifying the following format string:
(login 32 Login) (session-id 32 SID) \ (protocol 5 Proto) (nas-port 5 Port) \ (time 27 Date) (nas-address 32 NAS) \ (clid 17 CLID) (duration 7 Duration) \ (framed-address 16 Location) (realm 16 Realm) |
Each ‘radutmp’ record is represented as a table. It is equivalent to specifying the following format string:
User: (login)(newline)\ In real life: (gecos)(newline)\ Logged in: (time)(newline)\ NAS: (nas-address)(newline)\ Port: (nas-port)(newline)\ CLID: (clid)(newline)\ Protocol: (protocol)(newline)\ Session ID: (session-id)(newline)\ Uptime: (duration)(newline)\ Assigned IP: (framed-address)(newline)\ Realm: (realm)(newline)" |
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] |
This document was generated by Sergey Poznyakoff on December, 6 2008 using texi2html 1.78.