src/man/kas_listtickets.1

   1 kas listtickets            AFS Commands         kas listtickets
   2
   3
   4 NAME
   5
   6    kas listtickets -- list all tickets (tokens) for issuer.
   7
   8
   9    kas listtickets  [-name <name of server>]  [-long]  [-help]
  10
  11 ACCEPTABLE ABBREVIATIONS/ALIASES
  12
  13    kas listt  [-n <name of server>]  [-l]  [-h]
  14
  15 DESCRIPTION
  16
  17    Lists  all  the  tickets  (tokens)  for  the  issuer,  if no
  18    arguments are provided.  If  name  of  server  is  provided,
  19    lists only the ticket good for that server process ("afs" is
  20    the most common server).  If the -long switch  is  provided,
  21    the  output shows octal strings representing the session key
  22    and ticket itself.
  23
  24 ARGUMENTS
  25
  26    -name specifies the  server  name  for  which  to  list  the
  27          ticket.
  28
  29    -long specifies  that  the  output  should display the octal
  30          number  strings  constituting  the  session  key   and
  31          ticket,  along  with other information (see the OUTPUT
  32          section).  The session  key  is  the  one  also  found
  33          within the ticket.
  34
  35    -help prints  the  online  help  for  this  command.  Do not
  36          provide any other arguments or flags  with  this  one.
  37          See  section  4.3  in  the  Reference  Manual for more
  38          details.
  39
  40 OUTPUT
  41
  42    The output reports for whom the  ticket  is  valid  and  the
  43    ticket's expiration date.  If no cell specification appears,
  44    then the ticket is valid in the local cell.
  45
  46    If the -long flag is used, the  output  displays  the  octal
  47    numbers making up the session key and ticket, along with the
  48    key version number and the number of  bytes  in  the  ticket
  49    (this should always be 56).  If a "[>> POSTDATED <<]" marker
  50    appears where the expiration date normally does, the  ticket
  51    does  not  become  valid  until  the  indicated  time. (Only
  52    internal calls can create a postdated ticket;  there  is  no
  53    standard interface that allows users to do this.)
  54
  55
  56
  57 EXAMPLES
  58
  59    The  following two examples are for a user with AFS UID 1020
  60    in  the  transarc.com  cell  and   AFS   UID   35   in   the
  61    test.transarc.com  cell.   He is working on a machine in the
  62    former cell and is authenticated in both cells.
  63
  64    % kas listtickets
  65
  66        User's (AFS ID 1020) tokens for afs [Expires Wed Jan
  67        User's (AFS ID 35@test.transarc.com) tokens for afs@
  68             [Expires Wed Jan 3 13:54:26 1990]
  69
  70    % kas listtickets afs -l
  71
  72        User's (AFS ID 1020) tokens for afs [Expires Wed Jan
  73        SessionKey: \375\205\351\227\032\310\263\013
  74        Ticket: (kvno = 0, len = 56): \033\005\221S\203d\312
  75
  76 PRIVILEGE REQUIRED
  77
  78    None. A password is not prompted for.
  79
  80 MORE INFORMATION