jimzah/openafs
1
0
Fork 0
mirror of https://git.openafs.org/openafs.git synced 2025-01-19 15:30:14 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
58be19d792
openafs/doc/man-pages/pod5/CellAlias.pod

58 lines
2.0 KiB
Plaintext
Raw Normal View History

man-page-afsd-crypt-alias-20070805 Complete the documentation of the afsd flags and update a few things like -settime and -nosettime. Add man pages for fs setcrypt, fs getcrypt, and CellAlias. Based on work by Jason Edgecombe and then extensively edited, so any errors I probably introduced.
2007-08-05 23:01:42 +01:00
=head1 NAME
CellAlias - Maps cell names to aliases in /afs
=head1 DESCRIPTION
Some minor rewording and grammatical tweaks of the CellAlias man page Added some text that the CellAlias file is only used on Unix. LICENSE BSD Change-Id: I913d6a0774240ffc16cf92cfa92c4b2d06f41fd6 Reviewed-on: http://gerrit.openafs.org/1307 Tested-by: Jason Edgecombe <jason@rampaginggeek.com> Reviewed-by: Jeffrey Altman <jaltman@openafs.org> Reviewed-by: Derrick Brashear <shadow@dementia.org> Tested-by: Derrick Brashear <shadow@dementia.org>
2010-02-13 14:16:22 +00:00
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.
man-page-afsd-crypt-alias-20070805 Complete the documentation of the afsd flags and update a few things like -settime and -nosettime. Add man pages for fs setcrypt, fs getcrypt, and CellAlias. Based on work by Jason Edgecombe and then extensively edited, so any errors I probably introduced.
2007-08-05 23:01:42 +01:00
The most common use of this configuration file is to allow short names for
frequently used cell names. Traditionally, such short names would be
created by the local AFS administrator by creating symbolic links in the
C<root.afs> volume. Such symlinks do not appear when Dynamic Root is
enabled because, with Dynamic Root, the Cache Manager does not mount or
man-page-fs-newalias-20070805 Add a new fs newalias man page. Add -help to the synopsis and options of the other new man pages. Add additional missing links in the fs man page. Fix some wording in the CellAlias man page.
2007-08-05 23:38:10 +01:00
look at the C<root.afs> volume. F<CellAlias> is a replacement that allows
man-page-afsd-crypt-alias-20070805 Complete the documentation of the afsd flags and update a few things like -settime and -nosettime. Add man pages for fs setcrypt, fs getcrypt, and CellAlias. Based on work by Jason Edgecombe and then extensively edited, so any errors I probably introduced.
2007-08-05 23:01:42 +01:00
such short names to be created under the client control.
If you configure a short name mapping such as C<ir> for
doc: replace hostnames with IETF example hostnames There were several different real and made-up hostnames and company names used throughout our documentation examples. The IETF has reserved "example.com" and other "example" TLDs for use in examples (RFC 2606). Replace almost all references to ABC Corporation, DEF Corporation, and State University, as well as "abc.com", "bigcell.com", "def.com", "def.gov", "ghi.com", "ghi.gov", "jkl.com", "mit.edu", "stanford.edu", "state.edu", "stateu.edu", "uncc.edu", and "xyz.com". Standardize on "Example Corporation", "Example Network", "Example Organization" (example.com, example.net, and example.org). The Scout documentation in the Admin Guide contains PNG images that contain the old cell names, so I left those references until the images can be replaced. Change-Id: I4e44815b2d2ffe204810b7fd850842248f67c367 Reviewed-on: http://gerrit.openafs.org/6697 Reviewed-by: Jeffrey Altman <jaltman@secure-endpoints.com> Tested-by: Jeffrey Altman <jaltman@secure-endpoints.com>
2012-02-11 16:43:30 +00:00
C<ir.example.org>, the mapping of C<.ir> to C<.ir.example.org> for the
man-page-fs-newalias-20070805 Add a new fs newalias man page. Add -help to the synopsis and options of the other new man pages. Add additional missing links in the fs man page. Fix some wording in the CellAlias man page.
2007-08-05 23:38:10 +01:00
read/write version of the C<root.cell> volume for that cell will be
Some minor rewording and grammatical tweaks of the CellAlias man page Added some text that the CellAlias file is only used on Unix. LICENSE BSD Change-Id: I913d6a0774240ffc16cf92cfa92c4b2d06f41fd6 Reviewed-on: http://gerrit.openafs.org/1307 Tested-by: Jason Edgecombe <jason@rampaginggeek.com> Reviewed-by: Jeffrey Altman <jaltman@openafs.org> Reviewed-by: Derrick Brashear <shadow@dementia.org> Tested-by: Derrick Brashear <shadow@dementia.org>
2010-02-13 14:16:22 +00:00
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.
man-page-afsd-crypt-alias-20070805 Complete the documentation of the afsd flags and update a few things like -settime and -nosettime. Add man pages for fs setcrypt, fs getcrypt, and CellAlias. Based on work by Jason Edgecombe and then extensively edited, so any errors I probably introduced.
2007-08-05 23:01:42 +01:00
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
of the cell, and the second column is the alias that should be created.
=head1 EXAMPLES
The following F<CellAlias> file:
doc: replace hostnames with IETF example hostnames There were several different real and made-up hostnames and company names used throughout our documentation examples. The IETF has reserved "example.com" and other "example" TLDs for use in examples (RFC 2606). Replace almost all references to ABC Corporation, DEF Corporation, and State University, as well as "abc.com", "bigcell.com", "def.com", "def.gov", "ghi.com", "ghi.gov", "jkl.com", "mit.edu", "stanford.edu", "state.edu", "stateu.edu", "uncc.edu", and "xyz.com". Standardize on "Example Corporation", "Example Network", "Example Organization" (example.com, example.net, and example.org). The Scout documentation in the Admin Guide contains PNG images that contain the old cell names, so I left those references until the images can be replaced. Change-Id: I4e44815b2d2ffe204810b7fd850842248f67c367 Reviewed-on: http://gerrit.openafs.org/6697 Reviewed-by: Jeffrey Altman <jaltman@secure-endpoints.com> Tested-by: Jeffrey Altman <jaltman@secure-endpoints.com>
2012-02-11 16:43:30 +00:00
prod.example.com prod
test.example.org testcell
man-page-afsd-crypt-alias-20070805 Complete the documentation of the afsd flags and update a few things like -settime and -nosettime. Add man pages for fs setcrypt, fs getcrypt, and CellAlias. Based on work by Jason Edgecombe and then extensively edited, so any errors I probably introduced.
2007-08-05 23:01:42 +01:00
results in the following symbolic links:
doc: replace hostnames with IETF example hostnames There were several different real and made-up hostnames and company names used throughout our documentation examples. The IETF has reserved "example.com" and other "example" TLDs for use in examples (RFC 2606). Replace almost all references to ABC Corporation, DEF Corporation, and State University, as well as "abc.com", "bigcell.com", "def.com", "def.gov", "ghi.com", "ghi.gov", "jkl.com", "mit.edu", "stanford.edu", "state.edu", "stateu.edu", "uncc.edu", and "xyz.com". Standardize on "Example Corporation", "Example Network", "Example Organization" (example.com, example.net, and example.org). The Scout documentation in the Admin Guide contains PNG images that contain the old cell names, so I left those references until the images can be replaced. Change-Id: I4e44815b2d2ffe204810b7fd850842248f67c367 Reviewed-on: http://gerrit.openafs.org/6697 Reviewed-by: Jeffrey Altman <jaltman@secure-endpoints.com> Tested-by: Jeffrey Altman <jaltman@secure-endpoints.com>
2012-02-11 16:43:30 +00:00
/afs/.prod -> /afs/.prod.example.com
/afs/prod -> /afs/prod.example.com
/afs/.testcell -> /afs/.testcell.example.org
/afs/testcell -> /afs/testcell.example.org
man-page-afsd-crypt-alias-20070805 Complete the documentation of the afsd flags and update a few things like -settime and -nosettime. Add man pages for fs setcrypt, fs getcrypt, and CellAlias. Based on work by Jason Edgecombe and then extensively edited, so any errors I probably introduced.
2007-08-05 23:01:42 +01:00
=head1 SEE ALSO
L<fs_newalias(1)>,
L<fs_listaliases(1)>,
L<afsd(8)>
=head1 COPYRIGHT
Copyright 2007 Jason Edgecombe <jason@rampaginggeek.com>
man-page-license-change-20071225 LICENSE BSD Update man pages submitted by Jason Edgecombe to the BSD license.
2007-12-25 22:22:22 +00:00
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.
Reference in New Issue Copy Permalink