TOKENS(1)

NAME
tokens - A program to list your AFS tokens

SYNOPSIS
tokens [-athena] [-verbose, -v]

DESCRIPTION
The tokens command lists all AFS tokens in your current PAG. It can produce two different styles of output, AFS-style (default) or Kerberos4-style (optional). The default output mimics the tokens command from the official AFS. It looks something like this: Tokens held by Arla: User's (AFS ID 4881) tokens for afs@umich.edu [Expires Jul 8 09:21]
User's (AFS ID 4881) tokens for afs@engin.umich.edu [>>> Expired <<<]
--End of list-- If you don't have any AFS tokens, you still get the banner: Tokens held by Arla: --End of list-- When the -athena option is specified on the command line, the output of tokens looks like this: Tokens held by Arla: Issued Expires Principal
Jul 7 23:40:22 Jul 8 00:40:21 User's (AFS ID 4881) tokens for umich.edu
Jul 7 23:27:51 >>> Expired <<< User's (AFS ID 4881) tokens for engin.umich.edu
--End of list-- If you don't have any AFS tokens, tokens just prints You have no AFS tokens. to the standard output. The following flags are supported:

-athena
    Generate output in a format similar to that of Kerberos 4's 'klist' program

-verbose,-v
    Generate slightly more verbose output (not particularly useful except for debugging purposes)

EXIT STATUS
tokens returns with exit status 0 (true) if the current PAG has at least 1 valid AFS token. Otherwise, the exit status of tokens is 1. Thus, you can call this program from a script to determine whether or not AFS tokens are present. (e.g. in a login script)

NOTES
The AFS ID printed out may be arbitrary; it can be chosen at the time the token is set and does not necessarily correspond to the actual AFS ID on the kaserver. If you have AFS tokens, but they are all expired, the exit status of tokens will be 1, not 0.

SEE ALSO
klog(1), klist(1), unlog(1)

BUGS
None known.