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 -54 $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) |
---|