If realloc() == NULL we lost the pointer to old memory
[openafs.git] / doc / man-pages / pod5 / CellAlias.pod
index 5fb3eb0..c1af772 100644 (file)
@@ -4,10 +4,10 @@ CellAlias - Maps cell names to aliases in /afs
 
 =head1 DESCRIPTION
 
-The F<CellAlias> file is used when the AFS Cache Manager is Dynamic Root
-(B<-dynroot>) mode. It creates symbolic links in the dynamic root that
-link an alias for a cell (usually a short name) to the full name for the
-cell.
+The F<CellAlias> file is used by the Unix cache manager when it is using
+Dynamic Root (B<-dynroot>) mode. It creates symbolic links in the dynamic
+root (/afs) that link an alias for a cell (usually a short name) to the
+full name for the cell.
 
 The most common use of this configuration file is to allow short names for
 frequently used cell names. Traditionally, such short names would be
@@ -18,10 +18,11 @@ look at the C<root.afs> volume. F<CellAlias> is a replacement that allows
 such short names to be created under the client control.
 
 If you configure a short name mapping such as C<ir> for
-C<ir.stanford.edu>, the mapping of C<.ir> to C<.ir.stanford.edu> for the
+C<ir.example.org>, the mapping of C<.ir> to C<.ir.example.org> for the
 read/write version of the C<root.cell> volume for that cell will be
-created automatically. There is no need to list that alias separately (and
-it is listed separately, B<afsd> will report an error on startup).
+created automatically. There is no need to list that alias
+separately. B<afsd> will report an error on startup if the dotted entry is
+listed separately.
 
 The contents of the F<CellAlias> file should consist of one line of two
 whitespace-separated columns per alias. The first column is the real name
@@ -31,15 +32,15 @@ of the cell, and the second column is the alias that should be created.
 
 The following F<CellAlias> file:
 
-   openafs.org openafs
-   uncc.edu uncc
+   prod.example.com prod
+   test.example.org testcell
 
 results in the following symbolic links:
 
-   /afs/.openafs  ->  /afs/.openafs.org
-   /afs/openafs   ->  /afs/openafs.org
-   /afs/.uncc     ->  /afs/.uncc.edu
-   /afs/uncc      ->  /afs/uncc.edu
+   /afs/.prod      ->  /afs/.prod.example.com
+   /afs/prod       ->  /afs/prod.example.com
+   /afs/.testcell  ->  /afs/.testcell.example.org
+   /afs/testcell   ->  /afs/testcell.example.org
 
 =head1 SEE ALSO
 
@@ -51,5 +52,6 @@ L<afsd(8)>
 
 Copyright 2007 Jason Edgecombe <jason@rampaginggeek.com>
 
-This documentation is covered by the IBM Public License Version 1.0. This
-man page was written by Jason Edgecombe for OpenAFS.
+This documentation is covered by the BSD License as written in the
+doc/LICENSE file. This man page was written by Jason Edgecombe for
+OpenAFS.