crypto/kerberosIV/man/afslog.1

   1 .\" $Id: afslog.1,v 1.3 1998/06/30 15:28:48 assar Exp $
   2 .\"
   3 .Dd April 27, 1996
   4 .Dt AFSLOG 1
   5 .Os KTH-KRB
   6 .Sh NAME
   7 .Nm afslog
   8 .Nd "obtains AFS tokens for specified cells"
   9 .Sh SYNOPSIS
  10 .Nm
  11 .Op Fl d
  12 .Op Fl c Ar cell
  13 .Op Fl k Ar realm
  14 .Op Fl p Pa path
  15 .Op Fl unlog
  16 .Op Fl createuser
  17 .Op Ar args
  18 .Sh DESCRIPTION
  19 The
  20 .Nm
  21 command obtains AFS tokens,
  22 .Ar args
  23 are either a name of a cell or a pathnames of a file in the cell to
  24 get tokens for. If an argument is
  25 .Li .
  26 or
  27 .Li ..
  28 or contains a slash it is assumed to be a pathname. Otherwise it is
  29 assumed to be a name of a cell or a prefix thereof.
  30 .Pp
  31 The
  32 .Fl c
  33 and
  34 .Fl p
  35 flags can be used to resolve ambiguities.
  36 .Pp
  37 .Nm
  38 might fail to guess the Kerberos realm to get tickets for (for
  39 instance if the volume location servers of the cell does not reside in
  40 the kerberos realm that holds the AFS service key, and the correct
  41 realm isn't the same as the cell name or the local realm (I didn't say
  42 this was a common problem)). Anyway, the
  43 .Fl k
  44 can be used to give a hint. It should not be used unless there is a
  45 problem, since all tickets will be taken from the specified realm and
  46 this is not (usually) what you want.
  47 .Pp
  48 .Fl createuser
  49 means that
  50 .Nm
  51 should try to run
  52 .Nm pts
  53 to create a remote user principal in another cell.
  54 .Fl d
  55 can be used for debugging.
  56 .Pp
  57 If the
  58 .Fl unlog
  59 flag is given any tokens are removed and all other arguments are ignored.
  60 .Sh SEE ALSO
  61 .Xr kauth 1 ,
  62 .Xr kafs 3
  63 .Sh BUGS
  64 It should be able to handle the MIT Athena
  65 .Nm aklog
  66 flags
  67 .Fl hosts ,
  68 .Fl zsubs ,
  69 and
  70 .Fl noprdb ,
  71 but does not.