HCoop / hcoop / debian / openafs.git / blame
| Commit | Line | Data |
|---|---|---|
| 805e021f CE |
1 | =head1 NAME |
| 2 | ||
| 3 | kas_listtickets - Displays all of the issuer's tickets (tokens) | |
| 4 | ||
| 5 | =head1 SYNOPSIS | |
| 6 | ||
| 7 | =for html | |
| 8 | <div class="synopsis"> | |
| 9 | ||
| 10 | B<kas listtickets> S<<< [B<-name> <I<name of server>>] >>> [B<-long>] [B<-help>] | |
| 11 | ||
| 12 | B<kas listt> S<<< [B<-n> <I<name of server>>] >>> [B<-l>] [B<-h>] | |
| 13 | ||
| 14 | =for html | |
| 15 | </div> | |
| 16 | ||
| 17 | =head1 DESCRIPTION | |
| 18 | ||
| 19 | The B<kas listtickets> command displays the associated user ID (AFS UID), | |
| 20 | cell name, and expiration date of some or all of the issuer's tickets | |
| 21 | (tokens), depending on which options are provided: | |
| 22 | ||
| 23 | =over 4 | |
| 24 | ||
| 25 | =item * | |
| 26 | ||
| 27 | To display all tokens, provide neither the B<-name> argument nor B<-long> | |
| 28 | flag. The output is similar to that of the B<tokens> command. | |
| 29 | ||
| 30 | =item * | |
| 31 | ||
| 32 | To display a single token, provide the B<-name> argument to specify name | |
| 33 | of the Authentication Database entry for the entity that accepts the | |
| 34 | token. All AFS server processes accept tokens sealed with the key from the | |
| 35 | C<afs> entry. | |
| 36 | ||
| 37 | =item * | |
| 38 | ||
| 39 | To display in addition the octal numbers that constitute the token and | |
| 40 | session key, provide the B<-long> flag. | |
| 41 | ||
| 42 | =back | |
| 43 | ||
| 44 | =head1 OPTIONS | |
| 45 | ||
| 46 | =over 4 | |
| 47 | ||
| 48 | =item B<-name> <I<name of server>> | |
| 49 | ||
| 50 | Names the Authentication Database entry of the entity (usually a server | |
| 51 | process) that accepts the token to display. | |
| 52 | ||
| 53 | =item B<-long> | |
| 54 | ||
| 55 | Displays the octal numbers that constitute the session key and ticket. | |
| 56 | ||
| 57 | =item B<-help> | |
| 58 | ||
| 59 | Prints the online help for this command. All other valid options are | |
| 60 | ignored. | |
| 61 | ||
| 62 | =back | |
| 63 | ||
| 64 | =head1 OUTPUT | |
| 65 | ||
| 66 | The output reports the AFS UID of the user who owns the token, the service | |
| 67 | (usually, C<afs>) and cell for which it is valid, and its expiration date, | |
| 68 | using the following format. If the message does not specify a cell, the | |
| 69 | ticket is for the local cell. | |
| 70 | ||
| 71 | User's (AFS ID <AFS UID>) tokens for <service>[@<cellname>] \ | |
| 72 | [Expires <date>] | |
| 73 | ||
| 74 | If the B<-long> flag is provided, the output also includes the octal | |
| 75 | numbers making up the session key and token, along with the key version | |
| 76 | number and the number of bytes in the token (if the number of bytes is not | |
| 77 | 56, there is an error). | |
| 78 | ||
| 79 | If the marker C<<< [>> POSTDATED <] >>> appears instead of an expiration | |
| 80 | date, the ticket does not become valid until the indicated time. (Only | |
| 81 | internal calls can create a postdated ticket; there is no standard | |
| 82 | interface that allows users to do this.) | |
| 83 | ||
| 84 | =head1 EXAMPLES | |
| 85 | ||
| 86 | The following two examples are for a user with AFS UID 1020 in the | |
| 87 | C<example.com> cell and AFS UID 35 in the C<test.example.com> cell. He is working | |
| 88 | on a machine in the first cell and is authenticated in both cells. | |
| 89 | ||
| 90 | % kas listtickets | |
| 91 | User's (AFS ID 1020) tokens for afs [Expires Wed Mar 31 9:30:54 1999] | |
| 92 | User's (AFS ID 35@test.example.com) tokens for afs@test.example.com \ | |
| 93 | [Expires Wed Mar 31 13:54:26 1999] | |
| 94 | ||
| 95 | % kas listtickets -name afs -long | |
| 96 | User's (AFS ID 1020) tokens for afs [Expires Wed Mar 31 9:30:54 1999] | |
| 97 | SessionKey: \375\205\351\227\032\310\263\013 | |
| 98 | Ticket: (kvno = 0, len = 56): \033\005\221\156\203\278\312\058\016\133... | |
| 99 | ||
| 100 | =head1 PRIVILEGE REQUIRED | |
| 101 | ||
| 102 | None, and no password is required. | |
| 103 | ||
| 104 | =head1 SEE ALSO | |
| 105 | ||
| 106 | L<kas(8)>, | |
| 107 | L<tokens(1)> | |
| 108 | ||
| 109 | =head1 COPYRIGHT | |
| 110 | ||
| 111 | IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved. | |
| 112 | ||
| 113 | This documentation is covered by the IBM Public License Version 1.0. It was | |
| 114 | converted from HTML to POD by software written by Chas Williams and Russ | |
| 115 | Allbery, based on work by Alf Wachsmann and Elizabeth Cassell. |