[5476] | 1 | .TH RENEW 1 "15 August 1991" |
---|
[5475] | 2 | .ds ]W MIT Project Athena |
---|
| 3 | .SH NAME |
---|
| 4 | renew - get kerberos tickets, tokens, mappings, zephyr authentication |
---|
| 5 | .SH SYNOPSIS |
---|
| 6 | renew |
---|
| 7 | .SH DESCRIPTION |
---|
| 8 | \fIrenew\fR is an alias provided by the standard Athena dotfiles. It is |
---|
| 9 | intended to make the process of getting new kerberos tickets, |
---|
| 10 | re-authenticating yourself to any fileservers from which you may have |
---|
[5476] | 11 | filesystems attached, and re-authenticating yourself to the zephyr |
---|
| 12 | servers easier. |
---|
[5475] | 13 | |
---|
| 14 | Typing "alias renew" will reveal that renew simply executes the series |
---|
| 15 | of commands: |
---|
| 16 | |
---|
| 17 | .ti 12 |
---|
[22913] | 18 | kinit -54 $USER && fsid -a && zctl load /dev/null |
---|
[5475] | 19 | |
---|
| 20 | "USER" is an environment variable that is set to your username. |
---|
| 21 | \fIkinit\fR prompts you for your password and gets you a new kerberos |
---|
| 22 | ticket-granting ticket. Kerberos tickets automatically expire after 10 |
---|
| 23 | hours. |
---|
| 24 | |
---|
| 25 | \fIfsid -a\fR establishes new NFS mappings and gets new AFS tokens for |
---|
| 26 | any filesystems you have attached. Valid mappings or tokens are |
---|
| 27 | required to write (and sometimes read) files from remote filesystems. |
---|
| 28 | Mappings and tokens automatically expire after 10 hours. |
---|
| 29 | |
---|
| 30 | \fIzctl load /dev/null\fR reauthenticates you to the zephyr servers. |
---|
[5476] | 31 | Valid authentication is necessary to receive authentic zephyrgrams; |
---|
| 32 | otherwise, any zephyrgrams you receive will be marked "forged". |
---|
[5475] | 33 | |
---|
| 34 | The "&&" between the commands means that the command is only executed if |
---|
| 35 | the previous command was successful. This eliminates error messages |
---|
| 36 | that would occur if something failed; for example, if you mis-type your |
---|
| 37 | password, it will not attempt to get mappings and tokens with no |
---|
| 38 | kerberos tickets, which would print many errors. |
---|
| 39 | .SH FILES |
---|
| 40 | .PP |
---|
| 41 | /usr/athena/lib/init/cshrc global Athena cshrc file |
---|
| 42 | .br |
---|
| 43 | ~/.cshrc users's cshrc file |
---|
| 44 | .SH "SEE ALSO" |
---|
| 45 | kinit(1), fsid(1), zctl(1), csh(1) |
---|