Index for Section 8

Alphabetical listing for R

Bottom of page

RADCHECK(8)
NAME
  radcheck - determines whether a Interlink AAA Server is operational.

SYNOPSIS
  radcheck [ -ddirectory ] [ -pport ] [ -rretries ]
       [ -ttimeout ] [ -ghuntgroup_name ] [ -ssubgroup_name ]
       [ -x ] [ -v ] [ -n ] servername

DESCRIPTION
  The radcheck command determines whether a given Interlink AAA Server is
  operational.	The servername is required on the command line.	 This is the
  DNS name of a machine running a Interlink AAA Server.	 See authfile(5) for
  more information.  The radcheck command may be executed on any host, not
  just one registered in the clients file, however, in those cases, all lines
  but the last line of the radcheck output (the "servername (port-number)
  ..." line, see below) are omitted.

  If the server is found to be operational, radcheck displays

       auth queue: a/b(a/b), acct queue: c/d(c/d), maxtime: t (date)

       authfile: x, clients: y, users: z, fsmid: f, date

       cleanup_delay: u, avg-delay v, (of w)

       Version	version	 config codes

       UNIX-PW: 0, 0, 1-980709.102736, 0-?, 0-?

       "servername (port-number)" is responding

  on standard output.  If the number of retries is greater than zero,
  radcheck will additionally display

       (n retries)

  otherwise, radcheck displays

       "servername (port-number)" some message

  where some message may be one of the following (amongst others):

       No reply from RADIUS server "<hostname>(port)"

       Received non-matching id in server response

       Received invalid reply digest from server

       No such server: "<hostname>"

  Following the "Version" line above may be one or more lines decribing each
  "forking type" AATV currently found in the queried server.  The numbers
  following the AATV name and the colon (":") character describe the
  following items:

  ·    the configured number of maximum child processes allowed, a comma

  ·    a number showing the current number of child processes, a comma

  ·    the high-water mark for child processes, a hyphen and the time when it
       occurred, a comma

  ·    the high-water mark for queued child processes, a hyphen and the time
       when it occurred, a comma

  ·    the current number of child processes in the queue, a hyphen and the
       last queued time

       where a trailing question mark ("?") for any of the last three "time"
       values indicates that such time value has not occurred.

  For the Advanced Interlink AAA Server the above output is preceded by the
  following information:

       Status: g authen, h unconfirmed, i connected, j suspended, k unknown

       Status: l disconn, m reject, n no-token, o cancel, p collision

  and if any token pools are configured there will be one line for each such
  pool and the total number of pools displayed in the following manner:

       some-pool-name: q/r/s-date/t-timestamp

       number of pools: n

  where q is the total number of tokens configured in some-pool-name, r is
  the current number of tokens in use, s is the token high-water-mark
  recorded at date and t is the high-water-mark recorded at timestamp, some
  time since the previous midnight.

  The above discussion of tokens and token pools does not apply to the
  Advanced Interlink AAA Server per se, but are features of the Interlink AAA
  Server as operated within MichNet.

OPTIONS
  -d directory
       allows the user to specify an alternate directory which is different
       from the default choices ../raddb or /usr/private/etc/raddb.

  -p port
       allows the user to specify an alternate port number instead of the
       default port 1812.

  -r retries
       allows the user to specify a number of retries different from the
       default 10.

  -t timeout
       allows the user to specify a maximum timeout different from the
       default 3 seconds.

  -x   allows the user to turn on debugging output.

  -v   prints the version of the Interlink AAA Server distribution when the
       program was compiled.

  -n   specifies that the RADIUS packet type Status-Server should be used.

EXIT STATUS
  Normal successful completion returns zero to the system.  If the response
  from the Interlink AAA Server had errors, radcheck returns -2, local errors
  return -1, and timeout errors return one as status.

SEE ALSO
  authfile(5), clients(5), dictionary(5), users(5), radpwtst(8), radiusd(8)

AUTHOR
  Allan C. Rubens, Interlink Network, Incorporated.

Index for Section 8

Alphabetical listing for R

Top of page