third_party/heimdal/doc/apps.texi

   1 @c $Id$
   2
   3 @node Applications, Things in search for a better place, Setting up a realm, Top
   4
   5 @chapter Applications
   6
   7 @menu
   8 * AFS::
   9 @end menu
  10
  11 @node AFS, , Applications, Applications
  12 @section AFS
  13
  14 @cindex AFS
  15 AFS is a distributed filesystem that uses Kerberos for authentication.
  16
  17 @cindex OpenAFS
  18 @cindex Arla
  19 For more information about AFS see OpenAFS
  20 @url{http://www.openafs.org/} and Arla
  21 @url{http://www.stacken.kth.se/projekt/arla/}.
  22
  23 @subsection kafs and afslog
  24 @cindex afslog
  25
  26 @manpage{afslog,1} will obtains AFS tokens for a number of cells. What cells to get
  27 tokens for can either be specified as an explicit list, as file paths to
  28 get tokens for, or be left unspecified, in which case will use whatever
  29 magic @manpage{kafs,3} decides upon.
  30
  31 If not told what cell to get credentials for, @manpage{kafs,3} will
  32 search for the files ThisCell and TheseCells in the locations
  33 specified in @manpage{kafs,3} and try to get tokens for these cells
  34 and the cells specified in $HOME/.TheseCells.
  35
  36 More usefully it will look at and ~/.TheseCells in your home directory
  37 and for each line which is a cell get afs token for these cells.
  38
  39 The TheseCells file defines the the cells to which applications on the
  40 local client machine should try to aquire tokens for. It must reside in
  41 the directories searched by @manpage{kafs,3} on every AFS client machine.
  42
  43 The file is in ASCII format and contains one character string, the cell
  44 name, per line. Cell names are case sensitive, but most cell names
  45 are lower case.
  46
  47 See manpage for @manpage{kafs,3} for search locations of ThisCell and TheseCells.
  48
  49 @subsection How to get a KeyFile
  50
  51 @file{ktutil -k AFSKEYFILE:KeyFile get afs@@MY.REALM}
  52
  53 or you can extract it with kadmin
  54
  55 @example
  56 kadmin> ext -k AFSKEYFILE:/usr/afs/etc/KeyFile afs@@My.CELL.NAME
  57 @end example
  58
  59 You have to make sure you have a @code{des-cbc-md5} encryption type since that
  60 is the enctype that will be converted.
  61
  62 @subsection How to convert a srvtab to a KeyFile
  63
  64 You need a @file{/usr/vice/etc/ThisCell} containing the cellname of your
  65 AFS-cell.
  66
  67 @file{ktutil copy krb4:/root/afs-srvtab AFSKEYFILE:/usr/afs/etc/KeyFile}.
  68
  69 If keyfile already exists, this will add the new key in afs-srvtab to
  70 KeyFile.
  71