src/man/kas_statistics.1

   1 kas statistics             AFS Commands          kas statistics
   2
   3
   4 NAME
   5
   6    kas     statistics -- display     statistics    from    one
   7
   8                        Authentication Server process.
   9
  10
  11    kas statistics
  12    [-admin_username <admin principal to use for
  13    authentication>]
  14    [-password_for_admin <admin password>]  [-cell <cell name>]
  15              [-servers <explicit list of authentication
  16            +
  17    servers> ]
  18    [-noauth]  [-help]
  19
  20 ACCEPTABLE ABBREVIATIONS/ALIASES
  21
  22    kas sta  [-a <admin principal to use for authentication>]
  23    [-p <admin password>]  [-c <cell name>]
  24                                                 +
  25    [-s <explicit list of authentication servers> ]  [-n]  [-h]
  26
  27 DESCRIPTION
  28
  29    Displays statistics from one of the cell's  database  server
  30    machines.  It is recommended that the issuer use -servers to
  31    specify  one  machine  name.      Otherwise,   the   command
  32    interpreter  displays  statistics  for  a  machine chosen at
  33    random from all the database server machines with  which  it
  34    has established connections.
  35
  36 WARNING
  37
  38    If  this  command  is  issued in interactive mode, it is not
  39    possible to  specify  a  file  server  machine  because  the
  40    -servers   argument  is  inoperative.    If  the  issuer  is
  41    interested in a particular file server machine, it  is  best
  42    to leave interactive mode.
  43
  44 ARGUMENTS
  45
  46    -admin_username specifies  the  user  name  under  which the
  47                    issuer wishes to perform the  command.    If
  48                    the  issuer does not provide it, the current
  49                    identity is used.  See section  4.3  in  the
  50                    Reference    Manual    for   more   details.
  51                    -password_for_admin
  52                    specifies  the issuer's password.  Note that
  53                    provided here the password is visible on the
  54                    screen.   If the issuer does not provide it,
  55                    it will be prompted for and not  be  visible
  56                    on  the  screen.    See  section  4.3 in the
  57                    Reference Manual for more details.  -cell
  58                    specifies  the  cell  in  which  to  run the
  59                    command, if not the local cell.  See section
  60                    4.3   in   the  Reference  Manual  for  more
  61                    details.  -servers
  62                    specifies  the  database  server  machine(s)
  63                    with which to establish a connection.  It is
  64                    recommended   that   the   issuer  use  this
  65
  66
  67
  68                    argument and specify a single machine.
  69
  70    -noauth         establishes  an  unauthenticated  connection
  71                    between   the   Authentication  Servers  and
  72                    issuer, whom they  assign  the  unprivileged
  73                    identity  anonymous  rather  than attempting
  74                    mutual authentication.  See section  4.3  in
  75                    the   Reference  Manual  for  more  details.
  76                    -help
  77                    prints the online help for this command.  Do
  78                    not provide any  other  arguments  or  flags
  79                    with  this  one.    See  section  4.3 in the
  80                    Reference Manual for more details.
  81
  82 OUTPUT
  83
  84    The information includes:
  85
  86       - server's network address number and  last  startup
  87         date
  88
  89       - number   of  requests  and  aborted  requests  for
  90         various   services:      authentication,    ticket
  91         granting, password setting, entry listing, etc
  92
  93       - number of entries with ADMIN flag
  94
  95 EXAMPLE
  96
  97    The  following show the output when someone authenticated as
  98    the  privileged  user  admin  issues  this   command   about
  99    fs1.transarc.com.
 100
 101        % kas stat -s fs1.transarc.com
 102        56 allocs, 46 frees, 0 password changes
 103        Hash table utilization = 0.100000%
 104        From host c037cf05 started at Tue Mar 20 12:42:02 19
 105          of 88 requests for Authenticate, 18 were aborted.
 106          of 14 requests for GetTicket, 0 were aborted.
 107          of 4 requests for CreateUser, 1 were aborted.
 108          of 12 requests for SetFields, 4 were aborted.
 109          of 3 requests for DeleteUser, 0 were aborted.
 110          of 23 requests for GetEntry, 4 were aborted.
 111          of 18 requests for ListEntry, 0 were aborted.
 112          of 2 requests for GetStats, 1 were aborted.
 113          of 2 requests for GetRandomKey, 0 were aborted.
 114        Used 6.015 seconds of CPU time.
 115        1 admin accounts
 116
 117 PRIVILEGE REQUIRED
 118
 119    Issuer   must  have  the  ADMIN  flag  set  in  his  or  her
 120    Authentication Database entry.
 121
 122 MORE INFORMATION
 123
 124    kas debuginfo