| 1 | .TH RENEW 1 "15 August 1991" |
|---|
| 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 |
|---|
| 11 | filesystems attached, and re-authenticating yourself to the zephyr |
|---|
| 12 | servers easier. |
|---|
| 13 | |
|---|
| 14 | Typing "alias renew" will reveal that renew simply executes the series |
|---|
| 15 | of commands: |
|---|
| 16 | |
|---|
| 17 | .ti 12 |
|---|
| 18 | kinit $USER && fsid -a && zctl load /dev/null |
|---|
| 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. |
|---|
| 31 | Valid authentication is necessary to receive authentic zephyrgrams; |
|---|
| 32 | otherwise, any zephyrgrams you receive will be marked "forged". |
|---|
| 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) |
|---|
