1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
|
.\" Copyright (c) 2000 - 2003 Kungliga Tekniska Hgskolan
.\" (Royal Institute of Technology, Stockholm, Sweden).
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\"
.\" 1. Redistributions of source code must retain the above copyright
.\" notice, this list of conditions and the following disclaimer.
.\"
.\" 2. Redistributions in binary form must reproduce the above copyright
.\" notice, this list of conditions and the following disclaimer in the
.\" documentation and/or other materials provided with the distribution.
.\"
.\" 3. Neither the name of the Institute nor the names of its contributors
.\" may be used to endorse or promote products derived from this software
.\" without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" $Id: CellServDB.5,v 1.12 2003/09/30 10:46:37 lha Exp $
.\" $OpenBSD: CellServDB.5,v 1.1 2000/04/27 22:49:05 hin Exp $
.\"
.Dd September 30, 2003
.Dt CELLSERVDB 5
.Os "The Arla Project"
.Sh NAME
.Nm CellServDB
.Nd AFS cells and database servers
.Sh DESCRIPTION
The file
.Nm
lists AFS cells known to the local AFS cache manager.
Each entry describes the name of an AFS cell and specifies the
servers for that cell.
.Pp
Here is an example of the format of an entry in the file:
.Bd -literal
>cellname # Freetext comment describing the cell
ip-address #first.server.for.cell
ip-address #second.server.for.cell
ip-address #third.server.for.cell
.Ed
.Pp
.Nm
is read when
.Nm arlad
is started, normally when the system boots.
.Pp
The text after the # is
.Em not
a comment, it the hostname of the
db-server, and it's used to lookup the address.
The address is only used when the hostname is not found in DNS.
.Pp
Entires in the file are searched and expanded by many programs.
.Pp
In most cases it is better to distribute the information in
.Nm
with the AFSDB DNS resource records. This avoids having out of date
information in
.Nm Ns .
.Pp
When using AFSDB DNS resource records, entries entries should still
be listed, but without any hosts. This is needed for dynroot to work.
.Sh FILES
.Pa CellServDB
.Sh SEE ALSO
.Xr fs 1 ,
.Xr AliasDB 5 ,
.Xr DynRootDB 5 ,
.Xr ThisCell 5 ,
.Xr arla.conf 5 ,
.Xr arlad 8
|