doc/man-pages/pod5/CellAlias.pod

   1 =head1 NAME
   2
   3 CellAlias - Maps cell names to aliases in /afs
   4
   5 =head1 DESCRIPTION
   6
   7 The F<CellAlias> file is used by the Unix cache manager when it is using
   8 Dynamic Root (B<-dynroot>) mode. It creates symbolic links in the dynamic
   9 root (/afs) that link an alias for a cell (usually a short name) to the
  10 full name for the cell.
  11
  12 The most common use of this configuration file is to allow short names for
  13 frequently used cell names. Traditionally, such short names would be
  14 created by the local AFS administrator by creating symbolic links in the
  15 C<root.afs> volume. Such symlinks do not appear when Dynamic Root is
  16 enabled because, with Dynamic Root, the Cache Manager does not mount or
  17 look at the C<root.afs> volume. F<CellAlias> is a replacement that allows
  18 such short names to be created under the client control.
  19
  20 If you configure a short name mapping such as C<ir> for
  21 C<ir.stanford.edu>, the mapping of C<.ir> to C<.ir.stanford.edu> for the
  22 read/write version of the C<root.cell> volume for that cell will be
  23 created automatically. There is no need to list that alias
  24 separately. B<afsd> will report an error on startup if the dotted entry is
  25 listed separately.
  26
  27 The contents of the F<CellAlias> file should consist of one line of two
  28 whitespace-separated columns per alias. The first column is the real name
  29 of the cell, and the second column is the alias that should be created.
  30
  31 =head1 EXAMPLES
  32
  33 The following F<CellAlias> file:
  34
  35    openafs.org openafs
  36    uncc.edu uncc
  37
  38 results in the following symbolic links:
  39
  40    /afs/.openafs  ->  /afs/.openafs.org
  41    /afs/openafs   ->  /afs/openafs.org
  42    /afs/.uncc     ->  /afs/.uncc.edu
  43    /afs/uncc      ->  /afs/uncc.edu
  44
  45 =head1 SEE ALSO
  46
  47 L<fs_newalias(1)>,
  48 L<fs_listaliases(1)>,
  49 L<afsd(8)>
  50
  51 =head1 COPYRIGHT
  52
  53 Copyright 2007 Jason Edgecombe <jason@rampaginggeek.com>
  54
  55 This documentation is covered by the BSD License as written in the
  56 doc/LICENSE file. This man page was written by Jason Edgecombe for
  57 OpenAFS.