aboutsummaryrefslogtreecommitdiffstats
path: root/appl/afsutil/afslog.cat1
blob: 5716faeda2548361e092d07dd655905ec9cf2a75 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69

AFSLOG(1)                 BSD General Commands Manual                AFSLOG(1)

NNAAMMEE
     aaffsslloogg -- obtain AFS tokens

SSYYNNOOPPSSIISS
     aaffsslloogg [--hh | ----hheellpp] [----nnoo--vv44] [----nnoo--vv55] [--uu | ----uunnlloogg] [--vv | ----vveerrbboossee]
            [----vveerrssiioonn] [--cc _c_e_l_l | ----cceellll==_c_e_l_l] [--kk _r_e_a_l_m | ----rreeaallmm==_r_e_a_l_m] [--PP
            _p_r_i_n_c_i_p_a_l | ----pprriinncciippaall==_p_r_i_n_c_i_p_a_l] [--pp _p_a_t_h | ----ffiillee==_p_a_t_h]
            [_c_e_l_l | _p_a_t_h _._._.]

DDEESSCCRRIIPPTTIIOONN
     aaffsslloogg obtains AFS tokens for a number of cells. What cells to get tokens
     for can either be specified as an explicit list, as file paths to get
     tokens for, or be left unspecified, in which case aaffsslloogg will use what-
     ever magic krb_afslog(3) decides upon.

     Supported options:

     ----nnoo--vv44
             This makes aaffsslloogg not try using Kerberos 4.

     ----nnoo--vv55
             This makes aaffsslloogg not try using Kerberos 5.

     --PP _p_r_i_n_c_i_p_a_l, ----pprriinncciippaall _p_r_i_n_c_i_p_a_l
             select what Kerberos 5 principal to use.

     ----ccaacchhee _c_a_c_h_e
             select what Kerberos 5 credential cache to use.  ----pprriinncciippaall
             overrides this option.

     --uu, ----uunnlloogg
             Destroy tokens instead of obtaining new. If this is specified,
             all other options are ignored (except for ----hheellpp and ----vveerrssiioonn).

     --vv, ----vveerrbboossee
             Adds more verbosity for what is actually going on.

     --cc _c_e_l_l_, ----cceellll==_c_e_l_l
             This specified one or more cell names to get tokens for.

     --kk _r_e_a_l_m, ----rreeaallmm==_r_e_a_l_m
             This is the Kerberos realm the AFS servers live in, this should
             normally not be specified.

     --pp _p_a_t_h, ----ffiillee==_p_a_t_h
             This specified one or more file paths for which tokens should be
             obtained.

     Instead of using --cc and --pp, you may also pass a list of cells and file
     paths after any other options. These arguments are considered files if
     they are either the strings ``.''  or ``..'' or they contain a slash, or
     if there exists a file by that name.

EEXXAAMMPPLLEESS
     Assuming that there is no file called ``openafs.org'' in the current
     directory, and that _/_a_f_s_/_o_p_e_n_a_f_s_._o_r_g points to that cell, the follwing
     should be identical:

           $ afslog -c openafs.org
           $ afslog openafs.org
           $ afslog /afs/openafs.org/some/file

SSEEEE AALLSSOO
     krb_afslog(3)

HEIMDAL                        November 26, 2002                       HEIMDAL