add-afs-man-pages-20010716
[openafs.git] / src / man / kas_forgetticket.1
1 kas forgetticket           AFS Commands        kas forgetticket
2
3
4 NAME
5
6    kas forgetticket -- discard all tickets for the issuer.
7
8
9    kas forgetticket [-name <name of server>]  [-all]  [-help]
10
11 ACCEPTABLE ABBREVIATIONS/ALIASES
12
13    kas f [-h]
14
15 DESCRIPTION
16
17    Discards  all  tickets  that  the  Authentication Server has
18    registered for the issuer.  This  includes  the  AFS  server
19    ticket  from  each cell in which the user has authenticated,
20    and any tickets that the user may have acquired during  this
21    kas  session  (either  by  virtue of entering the session or
22    using kas getticket).
23
24 ARGUMENTS
25
26    -name specifies which ticket should be discarded.    Provide
27          this argument OR the -all flag.
28
29          Note:This  argument  is not currently implemented: all
30          tickets are discarded no  matter  which  ticket  which
31          ticket name is specified here.
32
33    -all  indicates   that  all  tickets  should  be  discarded.
34          Provide this flag OR  the  -name  argument.    In  the
35          current  implementation,  this  flag  is more sensible
36          because it matches what  actually  happens  no  matter
37          which option the issuer chooses.
38
39    -help prints  the  online  help  for  this  command.  Do not
40          provide any other arguments or flags  with  this  one.
41          See  section  4.3  in  the  Reference  Manual for more
42          details.
43
44 EXAMPLES
45
46    Both of the following discard all tickets for the issuer.
47
48    % kas forgetticket -all  % kas f
49
50 PRIVILEGE REQUIRED
51
52    None.  There is no prompt for a  password,  and  the  issuer
53    does  not  have  to  have  the  ADMIN flag set in his or her
54    Database entry.  The deletion can  affect  only  the  issuer
55    anyway.
56
57 MORE INFORMATION