777efb3f3d
git-svn-id: svn://svn.h5l.se/heimdal/trunk/heimdal@11545 ec53bebd-3082-4978-b11e-865c3cabbd6b
97 lines
1.9 KiB
Groff
97 lines
1.9 KiB
Groff
.\" $Id$
|
|
.\"
|
|
.Dd November 26, 2002
|
|
.Dt AFSLOG 1
|
|
.Os HEIMDAL
|
|
.Sh NAME
|
|
.Nm afslog
|
|
.Nd
|
|
obtain AFS tokens
|
|
.Sh SYNOPSIS
|
|
.Nm
|
|
.Oo Fl c Ar cell \*(Ba Xo
|
|
.Fl -cell= Ns Ar cell
|
|
.Xc
|
|
.Oc
|
|
.Oo Fl p Ar path \*(Ba Xo
|
|
.Fl -file= Ns Ar path
|
|
.Xc
|
|
.Oc
|
|
.Oo Fl k Ar realm \*(Ba Xo
|
|
.Fl -realm= Ns Ar realm
|
|
.Xc
|
|
.Oc
|
|
.Op Fl u | Fl -unlog
|
|
.Op Fl v | Fl -verbose
|
|
.Op Fl -version
|
|
.Op Fl h | Fl -help
|
|
.Op Ar cell | path ...
|
|
.Sh DESCRIPTION
|
|
.Nm
|
|
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
|
|
.Nm
|
|
will use whatever magic
|
|
.Xr krb_afslog 3
|
|
decides upon.
|
|
.Pp
|
|
Supported options:
|
|
.Bl -tag -width Ds
|
|
.It Xo
|
|
.Fl c Ar cell,
|
|
.Fl -cell= Ns Ar cell
|
|
.Xc
|
|
This specified one or more cell names to get tokens for.
|
|
.It Xo
|
|
.Fl p Ar path ,
|
|
.Fl -file= Ns Ar path
|
|
.Xc
|
|
This specified one or more file paths for which tokens should be
|
|
obtained.
|
|
.It Xo
|
|
.Fl k Ar realm ,
|
|
.Fl -realm= Ns Ar realm
|
|
.Xc
|
|
This is the Kerberos realm the AFS servers live in, this should
|
|
normally not be specified.
|
|
.It Xo
|
|
.Fl u ,
|
|
.Fl -unlog
|
|
.Xc
|
|
Destroy tokens instead of obtaining new. If this is specified, all
|
|
other options are ignored (except for
|
|
.Fl -help
|
|
and
|
|
.Fl -version ) .
|
|
.It Xo
|
|
.Fl v ,
|
|
.Fl -verbose
|
|
.Xc
|
|
Adds more verbosity for what is actually going on.
|
|
.El
|
|
Instead of using
|
|
.Fl c
|
|
and
|
|
.Fl p ,
|
|
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
|
|
.Do . Dc
|
|
or
|
|
.Dq ..
|
|
or they contain a slash, or if there exists a file by that name.
|
|
.Sh EXAMPLES
|
|
Assuming that there is no file called
|
|
.Dq openafs.org
|
|
in the current directory, and that
|
|
.Pa /afs/openafs.org
|
|
points to that cell, the follwing should be identical:
|
|
.Bd -literal -offset indent
|
|
$ afslog -c openafs.org
|
|
$ afslog openafs.org
|
|
$ afslog /afs/openafs.org/some/file
|
|
.Ed
|
|
.Sh SEE ALSO
|
|
.Xr krb_afslog 3
|