X-Git-Url: http://git.openafs.org/?p=openafs.git;a=blobdiff_plain;f=doc%2Fman-pages%2Fpod5%2FCellAlias.pod;h=c1af7725133c3e75bdf4e063a99a94cbdba579af;hp=d75ad4a900ff1b55fe583676bb1308555eacc8e5;hb=HEAD;hpb=7dc4925cd35036e7f7b448d15a291791cd025e86 diff --git a/doc/man-pages/pod5/CellAlias.pod b/doc/man-pages/pod5/CellAlias.pod index d75ad4a..c1af772 100644 --- a/doc/man-pages/pod5/CellAlias.pod +++ b/doc/man-pages/pod5/CellAlias.pod @@ -4,10 +4,10 @@ CellAlias - Maps cell names to aliases in /afs =head1 DESCRIPTION -The F 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 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 volume. F 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 for -C, the mapping of C<.ir> to C<.ir.stanford.edu> for the +C, the mapping of C<.ir> to C<.ir.example.org> for the read/write version of the C volume for that cell will be -created automatically. There is no need to list that alias separately (and -it is listed separately, B will report an error on startup). +created automatically. There is no need to list that alias +separately. B will report an error on startup if the dotted entry is +listed separately. The contents of the F 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 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