sourCEntral - mobile manpages

pdf

RADLIST

NAME

radlist − lists current on-line users and per user stats

SYNOPSIS

radlist [ −bhnstx ] [ −D|M|Y ] [ −F format_string ] [ −d day ] [ −m month ] [ −y year ] [ −u user ] [ −y year ]

DESCRIPTION

This program gives detailed statistics for current users on line (which is the default) or any user you like. Its statistics are on a per-day/month/year base and can be used to produced useful reports. It shows on-line time and traffic, along with numbers of logins and current port usage. Its output can be largerly customized as you prefer with a suitable format string. See FORMATS section below.

OPTIONS

−b

Uses a brief output format.

−t

Uses a ‘traditional’ tabular output format.

−n

Skips the header when ‘-t’ option is used.

−h

Prints out usage of the command.

−F −Hformat_string

Define customized formats for output rows and the header. See FORMATS section below.

−m month

Reports statistics for month month where month is in the range 1-12.

−y year

Reports statistics for year year that is a four digits number.

−x

Shows extedend information (port information).

− u user

Gets a single username database entry, i.e. select a specific username to report statistics for that user only.

−M −D −Y

Reports statistics on a dayly/monthly/yearly basis. They should be used along with d,m,y options. If not specified current date and −M is considered.

FORMATS

radlist does allow the user to have a customized output format with the ‘-F’ command line option (see above). The program accepts and outputs any character in a format string and parse it to find some %-prefixed one-letter tokens. Those ‘a la’ printf tokens are substituted with corresponding entry values. Normal C substitution are performed for \\,\t,\n,\r and \%. The list of legal % tokens follows, any oher combination is parsed and ignored.

img

No alignment decimal values are allowed in this version of format strings.

FILES

/usr/logs/YEAR/user-stats

These are files which constitutes the yearly radlist database. They are in binary GDBM format and collect statistics on a per user base, day by day.

/usr/logs/NAS/YEAR/detail-XX

These text files stores accounting information for every access server (NAS) listed in the clients file. Each user session is identified by a unique session-id and these accounting files store start/stop records for every single authenticated session. Information stored in those records, but for a group of standard ones, strictly depend on the NAS model and operating system.

BUGS

The -x option apparently is not working.

SEE ALSO

radiusd(8), radlast(1) builddbm(8), radtest(1), radwatch(1), radius_attributes(5)

AUTHOR

Francesco Paolo Lovergine <francesco AT yardradius DOT org>.

A complete list of contributors is contained in CREDITS file. You should get that file among other ones within your distribution and possibly installed under /usr/docs directory

COPYRIGHT

Copyright (C) 1997 Cristian Gafton. All rights reserved.

Copyright (C) 1999-2004 Francesco Paolo Lovergine. All rights reserved.

See the LICENSE file enclosed within this software for conditions of use and distribution. This is a pure ISO BSD Open Source License .

pdf