HCoop / hcoop / debian / openafs.git / blame
| Commit | Line | Data |
|---|---|---|
| 805e021f CE |
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.example.org>, the mapping of C<.ir> to C<.ir.example.org> 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 | prod.example.com prod | |
| 36 | test.example.org testcell | |
| 37 | ||
| 38 | results in the following symbolic links: | |
| 39 | ||
| 40 | /afs/.prod -> /afs/.prod.example.com | |
| 41 | /afs/prod -> /afs/prod.example.com | |
| 42 | /afs/.testcell -> /afs/.testcell.example.org | |
| 43 | /afs/testcell -> /afs/testcell.example.org | |
| 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. |