2 * Copyright 2000, International Business Machines Corporation and others.
5 * This software has been released under the terms of the IBM Public
6 * License. For details, see the LICENSE file in the top-level source
7 * directory or online at http://www.openafs.org/dl/license10.html
13 Interface to the routines used by the FileServer to manipulate the cell/server database
14 for the Cellular Andrew system, along with an operation to determine the name of the
15 local cell. Included are a string variable used to hold the local cell name, definitions for
16 the database file format and routines for:
17 1) Acquiring the local cell name.
18 2) Reading in the cell/server database from disk.
19 3) Reporting the set of servers associated with a given cell name.
20 4) Printing out the contents of the cell/server database.
21 5) Reclaiming the space used by an in-memory database.
26 --------------------------------------------------------------------------------------------------------------*/
28 #ifndef __CELLCONFIG_AFS_INCL_
29 #define __CELLCONFIG_AFS_INCL_ 1
36 #include <sys/types.h>
37 #include <netinet/in.h>
40 #include <rx/rx_opaque.h>
41 #include <opr/queue.h>
43 #define MAXCELLCHARS 64
44 #define MAXHOSTCHARS 64
45 #define MAXHOSTSPERCELL 8
50 #define AFSCONF_SUCCESS 0 /* worked */
53 * Complete server info for one cell.
56 char name[MAXCELLCHARS]; /*Cell name */
57 short numServers; /*Num active servers for the cell */
58 short flags; /* useful flags */
59 struct sockaddr_in hostAddr[MAXHOSTSPERCELL]; /*IP addresses for cell's servers */
60 char hostName[MAXHOSTSPERCELL][MAXHOSTCHARS]; /*Names for cell's servers */
61 char *linkedCell; /* Linked cell name, if any */
62 int timeout; /* Data timeout, if non-zero */
65 #define AFSCONF_CELL_FLAG_DNS_QUERIED 1
67 struct afsconf_cellalias {
68 char aliasName[MAXCELLCHARS];
69 char realName[MAXCELLCHARS];
72 struct afsconf_entry {
73 struct afsconf_entry *next; /* next guy in afsconf_dir */
74 struct afsconf_cell cellInfo; /* info for this cell */
77 struct afsconf_aliasentry {
78 struct afsconf_aliasentry *next;
79 struct afsconf_cellalias aliasInfo;
83 * A set of bit flags to control the selection of a security object
85 #define AFSCONF_SECOPTS_NOAUTH 0x1
86 #define AFSCONF_SECOPTS_LOCALAUTH 0x2
87 #define AFSCONF_SECOPTS_ALWAYSENCRYPT 0x4
88 #define AFSCONF_SECOPTS_FALLBACK_NULL 0x8
89 typedef afs_uint32 afsconf_secflags;
92 char *name; /* pointer to dir prefix */
93 char *cellName; /* cell name, if any, we're in */
94 struct afsconf_entry *entries; /* list of cell entries */
95 struct opr_queue keyList; /* list of keys */
96 afs_int32 timeRead; /* time stamp of file last read */
97 struct afsconf_aliasentry *alias_entries; /* cell aliases */
98 afsconf_secflags securityFlags;
101 extern afs_int32 afsconf_FindService(const char *aname);
102 extern const char *afsconf_FindIANAName(const char *aname);
103 extern struct afsconf_dir *afsconf_Open(const char *adir);
104 extern int afsconf_CellApply(struct afsconf_dir *adir,
105 int (*aproc) (struct afsconf_cell * cell,
107 struct afsconf_dir * dir),
109 extern int afsconf_CellAliasApply(struct afsconf_dir *adir,
110 int (*aproc) (struct afsconf_cellalias *
112 struct afsconf_dir * dir),
114 extern int afsconf_GetExtendedCellInfo(struct afsconf_dir *adir,
115 char *acellName, char *aservice,
116 struct afsconf_cell *acellInfo,
118 extern int afsconf_GetAfsdbInfo(char *acellName, char *aservice,
119 struct afsconf_cell *acellInfo);
120 extern int afsconf_GetCellInfo(struct afsconf_dir *adir, char *acellName,
122 struct afsconf_cell *acellInfo);
123 extern int afsconf_GetLocalCell(struct afsconf_dir *adir,
124 char *aname, afs_int32 alen);
125 extern int afsconf_Close(struct afsconf_dir *adir);
126 extern int afsconf_UpToDate(void *rock);
129 extern int afsconf_GetKeys(struct afsconf_dir *adir,
130 struct afsconf_keys *astr);
132 struct ktc_encryptionKey;
133 extern afs_int32 afsconf_GetLatestKey(struct afsconf_dir *adir,
135 struct ktc_encryptionKey *akey);
136 extern int afsconf_GetKey(void *rock, int avno,
137 struct ktc_encryptionKey *akey);
138 extern int afsconf_AddKey(struct afsconf_dir *adir, afs_int32 akvno,
139 char akey[8], afs_int32 overwrite);
140 extern int afsconf_DeleteKey(struct afsconf_dir *adir, afs_int32 akvno);
142 struct afsconf_typedKey;
143 struct afsconf_typedKeyList {
145 struct afsconf_typedKey **keys;
153 extern struct afsconf_typedKey *
154 afsconf_typedKey_get(struct afsconf_typedKey *);
155 extern void afsconf_typedKey_put(struct afsconf_typedKey **);
156 extern struct afsconf_typedKey *
157 afsconf_typedKey_new(afsconf_keyType type, int kvno,
158 int subType, struct rx_opaque *key);
159 extern void afsconf_typedKey_free(struct afsconf_typedKey **);
161 extern void afsconf_typedKey_values(struct afsconf_typedKey *key,
162 afsconf_keyType *type,
165 struct rx_opaque **keyMaterial);
167 extern int afsconf_GetAllKeys(struct afsconf_dir *,
168 struct afsconf_typedKeyList **);
169 extern int afsconf_GetKeysByType(struct afsconf_dir *dir,
170 afsconf_keyType type, int kvno,
171 struct afsconf_typedKeyList **);
172 extern int afsconf_GetKeyByTypes(struct afsconf_dir *dir,
173 afsconf_keyType type, int kvno, int subType,
174 struct afsconf_typedKey **);
175 extern int afsconf_GetLatestKeysByType(struct afsconf_dir *dir,
176 afsconf_keyType type,
177 struct afsconf_typedKeyList **);
178 extern int afsconf_GetLatestKeyByTypes(struct afsconf_dir *dir,
179 afsconf_keyType type, int subType,
180 struct afsconf_typedKey **);
181 extern void afsconf_PutTypedKeyList(struct afsconf_typedKeyList **keys);
182 extern int afsconf_AddTypedKey(struct afsconf_dir *dir,
183 struct afsconf_typedKey *key,
185 extern int afsconf_DeleteKeyByType(struct afsconf_dir *dir,
186 afsconf_keyType type, int kvno);
187 extern int afsconf_DeleteKeyBySubType(struct afsconf_dir *dir,
188 afsconf_keyType type, int kvno,
192 struct rx_securityClass;
193 extern afs_int32 afsconf_ServerAuth(void *arock,
194 struct rx_securityClass **,
196 extern afs_int32 afsconf_ClientAuth(void *arock,
197 struct rx_securityClass **astr,
199 extern afs_int32 afsconf_ClientAuthSecure(void *arock,
200 struct rx_securityClass **astr,
204 extern afs_int32 afsconf_ClientAuthToken(struct afsconf_cell *info,
205 afsconf_secflags flags,
206 struct rx_securityClass **sc,
211 extern afs_int32 afsconf_PickClientSecObj(struct afsconf_dir *dir,
212 afsconf_secflags flags,
213 struct afsconf_cell *info,
215 struct rx_securityClass **sc,
219 extern void afsconf_SetSecurityFlags(struct afsconf_dir *dir,
220 afsconf_secflags flags);
222 extern void afsconf_BuildServerSecurityObjects(void *,
223 struct rx_securityClass ***,
227 int afsconf_SetExtendedCellInfo(struct afsconf_dir *adir, const char *apath,
228 struct afsconf_cell *acellInfo, char clones[]);
229 int afsconf_SetCellInfo(struct afsconf_dir *adir, const char *apath,
230 struct afsconf_cell *acellInfo);
237 extern int afsconf_CheckAuth(void *arock, struct rx_call *acall);
238 extern int afsconf_GetNoAuthFlag(struct afsconf_dir *adir);
239 extern void afsconf_SetNoAuthFlag(struct afsconf_dir *adir, int aflag);
240 extern int afsconf_DeleteUser(struct afsconf_dir *adir, char *auser);
241 extern int afsconf_DeleteIdentity(struct afsconf_dir *, struct rx_identity *);
242 extern int afsconf_GetNthUser(struct afsconf_dir *adir, afs_int32 an,
243 char *abuffer, afs_int32 abufferLen);
244 extern int afsconf_GetNthIdentity(struct afsconf_dir *, int,
245 struct rx_identity **);
246 extern int afsconf_AddUser(struct afsconf_dir *adir, char *aname);
247 extern int afsconf_AddIdentity(struct afsconf_dir *adir, struct rx_identity *);
248 extern int afsconf_SuperUser(struct afsconf_dir *adir, struct rx_call *acall,
250 extern int afsconf_SuperIdentity(struct afsconf_dir *, struct rx_call *,
251 struct rx_identity **);
252 extern int afsconf_IsSuperIdentity(struct afsconf_dir *, struct rx_identity *);
254 /* some well-known ports and their names; new additions to table in cellconfig.c, too */
255 #define AFSCONF_FILESERVICE "afs"
256 #define AFSCONF_FILEPORT 7000
257 #define AFSCONF_CALLBACKSERVICE "afscb"
258 #define AFSCONF_CALLBACKPORT 7001
259 #define AFSCONF_PROTSERVICE "afsprot"
260 #define AFSCONF_PROTPORT 7002
261 #define AFSCONF_VLDBSERVICE "afsvldb"
262 #define AFSCONF_VLDBPORT 7003
263 #define AFSCONF_KAUTHSERVICE "afskauth"
264 #define AFSCONF_KAUTHPORT 7004
265 #define AFSCONF_VOLUMESERVICE "afsvol"
266 #define AFSCONF_VOLUMEPORT 7005
267 #define AFSCONF_ERRORSERVICE "afserror"
268 #define AFSCONF_ERRORPORT 7006
269 #define AFSCONF_NANNYSERVICE "afsnanny"
270 #define AFSCONF_NANNYPORT 7007
271 #define AFSCONF_UPDATESERVICE "afsupdate"
272 #define AFSCONF_UPDATEPORT 7008
273 #define AFSCONF_RMTSYSSERVICE "afsrmtsys"
274 #define AFSCONF_RMTSYSPORT 7009
275 #define AFSCONF_RSDBSERVICE "afsres"
276 #define AFSCONF_RESPORT 7010
277 #define AFSCONF_REMIODBSERVICE "afsremio"
278 #define AFSCONF_REMIOPORT 7011
280 #endif /* __CELLCONFIG_AFS_INCL_ */