2
''' $RCSfile$$Revision$$Date$
20
.ie \\n(.$>=3 .ne \\$3
36
''' Set up \*(-- to give an unbreakable dash;
37
''' string Tr holds user defined translation string.
38
''' Bell System Logo is used as a dummy character.
44
.if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
45
.if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
48
''' \*(M", \*(S", \*(N" and \*(T" are the equivalent of
49
''' \*(L" and \*(R", except that they are used on ".xx" lines,
50
''' such as .IP and .SH, which do another additional levels of
51
''' double-quote interpretation
80
.\" If the F register is turned on, we'll generate
81
.\" index entries out stderr for the following things:
86
.\" X<> Xref (embedded
87
.\" Of course, you have to process the output yourself
88
.\" in some meaninful fashion.
91
.tm Index:\\$1\t\\n%\t"\\$2"
96
.TH CellAlias 5 "OpenAFS" "25/Dec/2007" "AFS File Reference"
100
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
101
.de CQ \" put $1 in typewriter font
107
\\&\\$2 \\$3 \\$4 \\$5 \\$6 \\$7
110
.\" @(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2
111
. \" AM - accent mark definitions
113
. \" fudge factors for nroff and troff
122
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
128
. \" simple accents for nroff and troff
141
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
142
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
143
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
144
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
145
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
146
. ds ? \s-2c\h'-\w'c'u*7/10'\u\h'\*(#H'\zi\d\s+2\h'\w'c'u*8/10'
147
. ds ! \s-2\(or\s+2\h'-\w'\(or'u'\v'-.8m'.\v'.8m'
148
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
149
. ds q o\h'-\w'o'u*8/10'\s-4\v'.4m'\z\(*i\v'-.4m'\s+4\h'\w'o'u*8/10'
151
. \" troff and (daisy-wheel) nroff accents
152
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
153
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
154
.ds v \\k:\h'-(\\n(.wu*9/10-\*(#H)'\v'-\*(#V'\*(#[\s-4v\s0\v'\*(#V'\h'|\\n:u'\*(#]
155
.ds _ \\k:\h'-(\\n(.wu*9/10-\*(#H+(\*(#F*2/3))'\v'-.4m'\z\(hy\v'.4m'\h'|\\n:u'
156
.ds . \\k:\h'-(\\n(.wu*8/10)'\v'\*(#V*4/10'\z.\v'-\*(#V*4/10'\h'|\\n:u'
157
.ds 3 \*(#[\v'.2m'\s-2\&3\s0\v'-.2m'\*(#]
158
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
159
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
160
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
161
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
162
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
163
.ds ae a\h'-(\w'a'u*4/10)'e
164
.ds Ae A\h'-(\w'A'u*4/10)'E
165
.ds oe o\h'-(\w'o'u*4/10)'e
166
.ds Oe O\h'-(\w'O'u*4/10)'E
167
. \" corrections for vroff
168
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
169
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
170
. \" for low resolution devices (crt and lpr)
171
.if \n(.H>23 .if \n(.V>19 \
175
. ds v \h'-1'\o'\(aa\(ga'
191
CellAlias \- Maps cell names to aliases in /afs
193
The \fICellAlias\fR file is used when the AFS Cache Manager is Dynamic Root
194
(\fB\-dynroot\fR) mode. It creates symbolic links in the dynamic root that
195
link an alias for a cell (usually a short name) to the full name for the
198
The most common use of this configuration file is to allow short names for
199
frequently used cell names. Traditionally, such short names would be
200
created by the local AFS administrator by creating symbolic links in the
201
\f(CWroot.afs\fR volume. Such symlinks do not appear when Dynamic Root is
202
enabled because, with Dynamic Root, the Cache Manager does not mount or
203
look at the \f(CWroot.afs\fR volume. \fICellAlias\fR is a replacement that allows
204
such short names to be created under the client control.
206
If you configure a short name mapping such as \f(CWir\fR for
207
\f(CWir.stanford.edu\fR, the mapping of \f(CW.ir\fR to \f(CW.ir.stanford.edu\fR for the
208
read/write version of the \f(CWroot.cell\fR volume for that cell will be
209
created automatically. There is no need to list that alias separately (and
210
it is listed separately, \fBafsd\fR will report an error on startup).
212
The contents of the \fICellAlias\fR file should consist of one line of two
213
whitespace-separated columns per alias. The first column is the real name
214
of the cell, and the second column is the alias that should be created.
216
The following \fICellAlias\fR file:
219
\& openafs.org openafs
222
results in the following symbolic links:
225
\& /afs/.openafs -> /afs/.openafs.org
226
\& /afs/openafs -> /afs/openafs.org
227
\& /afs/.uncc -> /afs/.uncc.edu
228
\& /afs/uncc -> /afs/uncc.edu
231
the \fIfs_newalias(1)\fR manpage,
232
the \fIfs_listaliases(1)\fR manpage,
233
the \fIafsd(8)\fR manpage
235
Copyright 2007 Jason Edgecombe <jason@rampaginggeek.com>
237
This documentation is covered by the BSD License as written in the
238
doc/LICENSE file. This man page was written by Jason Edgecombe for
242
.IX Title "CellAlias 5"
243
.IX Name "CellAlias - Maps cell names to aliases in /afs"
247
.IX Header "DESCRIPTION"
249
.IX Header "EXAMPLES"
251
.IX Header "SEE ALSO"
253
.IX Header "COPYRIGHT"