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.

       Token   Value
       ─────────────────────────────────────────────────────────
       %l      Username
       %s      Number of current sessions
       %n      Total number of sessions in the period specified
       %t      Total online time in secs
       %T      Total online time in HH:MM:SS format

       %i      Total input traffic in bytes
       %I      Total input traffic in KBytes
       %o      Total output traffic in bytes
       %O      Total output traffic in KBytes
       %m      Total traffic in bytes
       %M      Total traffic in KBytes
       %k      Mean online time per session in secs
       %K      Mean online time per session in HH:MM:SS format
       %g      Mean traffic per session in bytes
       %G      Mean traffic per session in KBytes
       %%      literal '%'

       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@yardradius.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 .