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
10 #include <afsconfig.h>
11 #include <afs/param.h>
25 #ifdef AFS_PTHREAD_ENV
27 static pthread_once_t dirInit_once = PTHREAD_ONCE_INIT;
31 #include <WINNT\afssw.h>
35 /* static storage for path strings */
36 static char dirPathArray[AFSDIR_PATHSTRING_MAX][AFSDIR_PATH_MAX];
38 /* indicate if and how the dirpath module initialized. */
39 static int initFlag = 0;
40 static unsigned int initStatus = 0;
43 /* storage for dynamically-determined install dir (NT only; long and short) */
45 static char ntServerInstallDirLong[AFSDIR_PATH_MAX];
46 static char ntServerInstallDirShort[AFSDIR_PATH_MAX];
47 static char ntClientConfigDirLong[AFSDIR_PATH_MAX];
48 static char ntClientConfigDirShort[AFSDIR_PATH_MAX];
51 /* storage for local afs server/client paths (top-level) */
52 static char afsSrvDirPath[AFSDIR_PATH_MAX];
53 static char afsClntDirPath[AFSDIR_PATH_MAX];
55 /* internal array init function */
56 static void initDirPathArray(void);
58 /* Additional macros for ease of use */
59 /* buf is expected to be atleast AFS_PATH_MAX bytes long */
60 #define AFSDIR_SERVER_DIRPATH(buf, dir) \
61 (void) strcompose(buf, AFSDIR_PATH_MAX, serverPrefix, dir, (char *)NULL)
63 #define AFSDIR_SERVER_FILEPATH(buf, dir, file) \
64 (void) strcompose(buf, AFSDIR_PATH_MAX, serverPrefix, dir, "/", file, (char *)NULL)
66 #define AFSDIR_CLIENT_DIRPATH(buf, dir) \
67 (void) strcompose(buf, AFSDIR_PATH_MAX, clientPrefix, dir, (char *)NULL)
69 #define AFSDIR_CLIENT_FILEPATH(buf, dir, file) \
70 (void) strcompose(buf, AFSDIR_PATH_MAX, clientPrefix, dir, "/", file, (char *)NULL)
73 /* initAFSDirPath() -- External users call this function to initialize
74 * the dirpath module and/or to determine the initialization status.
79 if (initFlag == 0) { /* not yet init'ed, so initialize */
80 #ifdef AFS_PTHREAD_ENV
81 pthread_once(&dirInit_once, initDirPathArray);
90 /* initDirPathArray() -- Initializes the afs dir paths for the
91 * server and client installations.
93 * For NT these are determined dynamically; for Unix they are static.
95 * NT NOTE: If a particular component (client/server) is not installed
96 * then we may not be able to initialize the paths to anything
97 * meaningful. In this case the paths are set to the local
98 * temp directory to avoid later reference to an uninitialized
99 * variable. The initStatus flag is set to indicate which
100 * paths (client/server) initialized properly for callers of
101 * initAFSDirPath() who would like to know this information.
104 initDirPathArray(void)
106 char *pathp, *clntEtcDir;
107 const char *clientPrefix = "";
108 const char *serverPrefix = "";
114 /* get the afs server software installation dir from the registry */
115 if (afssw_GetServerInstallDir(&buf)) {
116 /* failed; server not installed; use temp directory */
117 strcpy(ntServerInstallDirLong, gettmpdir());
119 strcpy(ntServerInstallDirLong, buf);
121 initStatus |= AFSDIR_SERVER_PATHS_OK;
123 FilepathNormalize(ntServerInstallDirLong);
125 GetShortPathName(ntServerInstallDirLong, ntServerInstallDirShort,
127 if (status == 0 || status > AFSDIR_PATH_MAX) {
128 /* can't convert path to short version; just use long version */
129 strcpy(ntServerInstallDirShort, ntServerInstallDirLong);
131 FilepathNormalize(ntServerInstallDirShort);
133 /* get the afs client configuration directory (/usr/vice/etc equivalent) */
134 if (afssw_GetClientCellServDBDir(&buf)) {
136 status = GetWindowsDirectory(ntClientConfigDirLong, AFSDIR_PATH_MAX);
137 if (status == 0 || status > AFSDIR_PATH_MAX) {
138 /* failed to get canonical Windows directory; use temp directory */
139 strcpy(ntClientConfigDirLong, gettmpdir());
141 initStatus |= AFSDIR_CLIENT_PATHS_OK;
144 strcpy(ntClientConfigDirLong, buf);
146 initStatus |= AFSDIR_CLIENT_PATHS_OK;
148 FilepathNormalize(ntClientConfigDirLong);
151 GetShortPathName(ntClientConfigDirLong, ntClientConfigDirShort,
153 if (status == 0 || status > AFSDIR_PATH_MAX) {
154 /* can't convert path to short version; just use long version */
155 strcpy(ntClientConfigDirShort, ntClientConfigDirLong);
157 FilepathNormalize(ntClientConfigDirShort);
158 clientPrefix = ntClientConfigDirShort;
160 /* setup the root server directory path (/usr/afs equivalent) */
161 strcpy(afsSrvDirPath, ntServerInstallDirShort);
162 strcat(afsSrvDirPath, AFSDIR_CANONICAL_SERVER_AFS_DIRPATH);
164 /* there is no root client directory path (/usr/vice equivalent) */
165 afsClntDirPath[0] = '\0';
167 /* setup top level dirpath (/usr equivalent); valid for server ONLY */
168 strcpy(dirPathArray[AFSDIR_USR_DIRPATH_ID], ntServerInstallDirShort);
169 serverPrefix = ntServerInstallDirShort;
170 strcat(dirPathArray[AFSDIR_USR_DIRPATH_ID], AFSDIR_CANONICAL_USR_DIRPATH);
172 #else /* AFS_NT40_ENV */
173 /* setup the root server directory path */
174 strcpy(afsSrvDirPath, AFSDIR_CANONICAL_SERVER_AFS_DIRPATH);
176 /* setup the root client directory path */
177 #ifdef AFS_DARWIN_ENV
178 if (access(AFSDIR_ALTERNATE_CLIENT_VICE_DIRPATH, F_OK) == 0)
179 strcpy(afsClntDirPath, AFSDIR_ALTERNATE_CLIENT_VICE_DIRPATH);
182 strcpy(afsClntDirPath, AFSDIR_CANONICAL_CLIENT_VICE_DIRPATH);
184 /* setup top level dirpath; valid for both server and client */
185 strcpy(dirPathArray[AFSDIR_USR_DIRPATH_ID], AFSDIR_CANONICAL_USR_DIRPATH);
187 initStatus |= (AFSDIR_CLIENT_PATHS_OK | AFSDIR_SERVER_PATHS_OK);
188 #endif /* AFS_NT40_ENV */
190 /* now initialize various dir and file paths exported by dirpath module */
192 /* server dir paths */
193 strcpy(dirPathArray[AFSDIR_SERVER_AFS_DIRPATH_ID], afsSrvDirPath);
195 pathp = dirPathArray[AFSDIR_SERVER_ETC_DIRPATH_ID];
196 AFSDIR_SERVER_DIRPATH(pathp, AFSDIR_SERVER_ETC_DIR);
198 pathp = dirPathArray[AFSDIR_SERVER_BIN_DIRPATH_ID];
199 AFSDIR_SERVER_DIRPATH(pathp, AFSDIR_SERVER_BIN_DIR);
201 pathp = dirPathArray[AFSDIR_SERVER_CORES_DIRPATH_ID];
202 AFSDIR_SERVER_DIRPATH(pathp, AFSDIR_CORES_DIR);
204 pathp = dirPathArray[AFSDIR_SERVER_DB_DIRPATH_ID];
205 AFSDIR_SERVER_DIRPATH(pathp, AFSDIR_DB_DIR);
207 pathp = dirPathArray[AFSDIR_SERVER_LOGS_DIRPATH_ID];
208 AFSDIR_SERVER_DIRPATH(pathp, AFSDIR_LOGS_DIR);
210 pathp = dirPathArray[AFSDIR_SERVER_LOCAL_DIRPATH_ID];
211 AFSDIR_SERVER_DIRPATH(pathp, AFSDIR_LOCAL_DIR);
213 pathp = dirPathArray[AFSDIR_SERVER_BACKUP_DIRPATH_ID];
214 AFSDIR_SERVER_DIRPATH(pathp, AFSDIR_BACKUP_DIR);
216 pathp = dirPathArray[AFSDIR_SERVER_MIGRATE_DIRPATH_ID];
217 AFSDIR_SERVER_DIRPATH(pathp, AFSDIR_MIGR_DIR);
219 pathp = dirPathArray[AFSDIR_SERVER_BIN_FILE_DIRPATH_ID];
220 AFSDIR_SERVER_DIRPATH(pathp, AFSDIR_BIN_FILE_DIR);
222 /* client dir path */
224 strcpy(dirPathArray[AFSDIR_CLIENT_VICE_DIRPATH_ID],
225 "/NoUsrViceDirectoryOnWindows");
226 strcpy(dirPathArray[AFSDIR_CLIENT_ETC_DIRPATH_ID],
227 ntClientConfigDirShort);
229 clntEtcDir = pathp = dirPathArray[AFSDIR_CLIENT_ETC_DIRPATH_ID];
231 strcpy(dirPathArray[AFSDIR_CLIENT_VICE_DIRPATH_ID], afsClntDirPath);
233 clntEtcDir = pathp = dirPathArray[AFSDIR_CLIENT_ETC_DIRPATH_ID];
234 #ifdef AFS_DARWIN_ENV
235 if (access(AFSDIR_ALTERNATE_CLIENT_ETC_DIR, F_OK) == 0)
236 AFSDIR_CLIENT_DIRPATH(pathp, AFSDIR_ALTERNATE_CLIENT_ETC_DIR);
239 AFSDIR_CLIENT_DIRPATH(pathp, AFSDIR_CLIENT_ETC_DIR);
240 #endif /* AFS_NT40_ENV */
243 pathp = dirPathArray[AFSDIR_CLIENT_DATA_DIRPATH_ID];
244 #ifdef AFS_DARWIN_ENV
245 if (access(AFSDIR_ALTERNATE_CLIENT_DATA_DIR, F_OK) == 0)
246 AFSDIR_CLIENT_DIRPATH(pathp, AFSDIR_ALTERNATE_CLIENT_DATA_DIR);
249 AFSDIR_CLIENT_DIRPATH(pathp, AFSDIR_DATA_DIR);
252 /* server file paths */
253 pathp = dirPathArray[AFSDIR_SERVER_THISCELL_FILEPATH_ID];
254 AFSDIR_SERVER_FILEPATH(pathp, AFSDIR_SERVER_ETC_DIR,
255 AFSDIR_THISCELL_FILE);
257 pathp = dirPathArray[AFSDIR_SERVER_CELLSERVDB_FILEPATH_ID];
258 AFSDIR_SERVER_FILEPATH(pathp, AFSDIR_SERVER_ETC_DIR,
259 AFSDIR_CELLSERVDB_FILE);
261 pathp = dirPathArray[AFSDIR_SERVER_NOAUTH_FILEPATH_ID];
262 AFSDIR_SERVER_FILEPATH(pathp, AFSDIR_LOCAL_DIR, AFSDIR_NOAUTH_FILE);
264 pathp = dirPathArray[AFSDIR_SERVER_BUDBLOG_FILEPATH_ID];
265 AFSDIR_SERVER_FILEPATH(pathp, AFSDIR_LOGS_DIR, AFSDIR_BUDBLOG_FILE);
267 pathp = dirPathArray[AFSDIR_SERVER_TAPECONFIG_FILEPATH_ID];
268 AFSDIR_SERVER_FILEPATH(pathp, AFSDIR_BACKUP_DIR, AFSDIR_TAPECONFIG_FILE);
270 pathp = dirPathArray[AFSDIR_SERVER_KALOGDB_FILEPATH_ID];
271 AFSDIR_SERVER_FILEPATH(pathp, AFSDIR_LOGS_DIR, AFSDIR_KALOGDB_FILE);
273 pathp = dirPathArray[AFSDIR_SERVER_KALOG_FILEPATH_ID];
274 AFSDIR_SERVER_FILEPATH(pathp, AFSDIR_LOGS_DIR, AFSDIR_KALOG_FILE);
276 pathp = dirPathArray[AFSDIR_SERVER_KADB_FILEPATH_ID];
277 AFSDIR_SERVER_FILEPATH(pathp, AFSDIR_DB_DIR, AFSDIR_KADB_FILE);
279 pathp = dirPathArray[AFSDIR_SERVER_NTPD_FILEPATH_ID];
280 AFSDIR_SERVER_FILEPATH(pathp, AFSDIR_SERVER_BIN_DIR, AFSDIR_NTPD_FILE);
282 pathp = dirPathArray[AFSDIR_SERVER_PRDB_FILEPATH_ID];
283 AFSDIR_SERVER_FILEPATH(pathp, AFSDIR_DB_DIR, AFSDIR_PRDB_FILE);
285 pathp = dirPathArray[AFSDIR_SERVER_PTLOG_FILEPATH_ID];
286 AFSDIR_SERVER_FILEPATH(pathp, AFSDIR_LOGS_DIR, AFSDIR_PTLOG_FILE);
288 pathp = dirPathArray[AFSDIR_SERVER_KCONF_FILEPATH_ID];
289 AFSDIR_SERVER_FILEPATH(pathp, AFSDIR_SERVER_ETC_DIR, AFSDIR_KCONF_FILE);
291 pathp = dirPathArray[AFSDIR_SERVER_VLDB_FILEPATH_ID];
292 AFSDIR_SERVER_FILEPATH(pathp, AFSDIR_DB_DIR, AFSDIR_VLDB_FILE);
294 pathp = dirPathArray[AFSDIR_SERVER_VLOG_FILEPATH_ID];
295 AFSDIR_SERVER_FILEPATH(pathp, AFSDIR_LOGS_DIR, AFSDIR_VLOG_FILE);
297 pathp = dirPathArray[AFSDIR_SERVER_CORELOG_FILEPATH_ID];
298 AFSDIR_SERVER_FILEPATH(pathp, AFSDIR_LOGS_DIR, AFSDIR_CORE_FILE);
300 pathp = dirPathArray[AFSDIR_SERVER_SLVGLOG_FILEPATH_ID];
301 AFSDIR_SERVER_FILEPATH(pathp, AFSDIR_LOGS_DIR, AFSDIR_SLVGLOG_FILE);
303 pathp = dirPathArray[AFSDIR_SERVER_SALSRVLOG_FILEPATH_ID];
304 AFSDIR_SERVER_FILEPATH(pathp, AFSDIR_LOGS_DIR, AFSDIR_SALSRVLOG_FILE);
306 pathp = dirPathArray[AFSDIR_SERVER_SALVAGER_FILEPATH_ID];
307 AFSDIR_SERVER_FILEPATH(pathp, AFSDIR_SERVER_BIN_DIR,
308 AFSDIR_SALVAGER_FILE);
310 pathp = dirPathArray[AFSDIR_SERVER_SALSRV_FILEPATH_ID];
311 AFSDIR_SERVER_FILEPATH(pathp, AFSDIR_SERVER_BIN_DIR,
314 pathp = dirPathArray[AFSDIR_SERVER_SLVGLOCK_FILEPATH_ID];
315 AFSDIR_SERVER_FILEPATH(pathp, AFSDIR_LOCAL_DIR, AFSDIR_SLVGLOCK_FILE);
317 pathp = dirPathArray[AFSDIR_SERVER_KEY_FILEPATH_ID];
318 AFSDIR_SERVER_FILEPATH(pathp, AFSDIR_SERVER_ETC_DIR, AFSDIR_KEY_FILE);
320 pathp = dirPathArray[AFSDIR_SERVER_ULIST_FILEPATH_ID];
321 AFSDIR_SERVER_FILEPATH(pathp, AFSDIR_SERVER_ETC_DIR, AFSDIR_ULIST_FILE);
323 pathp = dirPathArray[AFSDIR_SERVER_BOZCONF_FILEPATH_ID];
324 AFSDIR_SERVER_FILEPATH(pathp, AFSDIR_BOSCONFIG_DIR, AFSDIR_BOZCONF_FILE);
326 pathp = dirPathArray[AFSDIR_SERVER_BOZCONFNEW_FILEPATH_ID];
327 AFSDIR_SERVER_FILEPATH(pathp, AFSDIR_BOSCONFIG_DIR,
328 AFSDIR_BOZCONFNEW_FILE);
330 pathp = dirPathArray[AFSDIR_SERVER_BOZLOG_FILEPATH_ID];
331 AFSDIR_SERVER_FILEPATH(pathp, AFSDIR_LOGS_DIR, AFSDIR_BOZLOG_FILE);
333 pathp = dirPathArray[AFSDIR_SERVER_BOZINIT_FILEPATH_ID];
334 AFSDIR_SERVER_FILEPATH(pathp, AFSDIR_BOSCONFIG_DIR, AFSDIR_BOZINIT_FILE);
336 pathp = dirPathArray[AFSDIR_SERVER_BOZRXBIND_FILEPATH_ID];
337 AFSDIR_SERVER_FILEPATH(pathp, AFSDIR_BOSCONFIG_DIR, AFSDIR_BOZRXBIND_FILE);
339 pathp = dirPathArray[AFSDIR_SERVER_BOSVR_FILEPATH_ID];
340 AFSDIR_SERVER_FILEPATH(pathp, AFSDIR_BOSSERVER_DIR, AFSDIR_BOSVR_FILE);
342 pathp = dirPathArray[AFSDIR_SERVER_VOLSERLOG_FILEPATH_ID];
343 AFSDIR_SERVER_FILEPATH(pathp, AFSDIR_LOGS_DIR, AFSDIR_VOLSERLOG_FILE);
345 pathp = dirPathArray[AFSDIR_SERVER_ROOTVOL_FILEPATH_ID];
346 AFSDIR_SERVER_FILEPATH(pathp, AFSDIR_SERVER_ETC_DIR, AFSDIR_ROOTVOL_FILE);
348 pathp = dirPathArray[AFSDIR_SERVER_HOSTDUMP_FILEPATH_ID];
349 AFSDIR_SERVER_FILEPATH(pathp, AFSDIR_LOCAL_DIR, AFSDIR_HOSTDUMP_FILE);
351 pathp = dirPathArray[AFSDIR_SERVER_CLNTDUMP_FILEPATH_ID];
352 AFSDIR_SERVER_FILEPATH(pathp, AFSDIR_LOCAL_DIR, AFSDIR_CLNTDUMP_FILE);
354 pathp = dirPathArray[AFSDIR_SERVER_CBKDUMP_FILEPATH_ID];
355 AFSDIR_SERVER_FILEPATH(pathp, AFSDIR_LOCAL_DIR, AFSDIR_CBKDUMP_FILE);
357 pathp = dirPathArray[AFSDIR_SERVER_OLDSYSID_FILEPATH_ID];
358 AFSDIR_SERVER_FILEPATH(pathp, AFSDIR_LOCAL_DIR, AFSDIR_OLDSYSID_FILE);
360 pathp = dirPathArray[AFSDIR_SERVER_SYSID_FILEPATH_ID];
361 AFSDIR_SERVER_FILEPATH(pathp, AFSDIR_LOCAL_DIR, AFSDIR_SYSID_FILE);
363 pathp = dirPathArray[AFSDIR_SERVER_FILELOG_FILEPATH_ID];
364 AFSDIR_SERVER_FILEPATH(pathp, AFSDIR_LOGS_DIR, AFSDIR_FILELOG_FILE);
366 pathp = dirPathArray[AFSDIR_SERVER_AUDIT_FILEPATH_ID];
367 AFSDIR_SERVER_FILEPATH(pathp, AFSDIR_LOCAL_DIR, AFSDIR_AUDIT_FILE);
369 pathp = dirPathArray[AFSDIR_SERVER_CONFIG_FILE_FILEPATH_ID];
370 AFSDIR_CLIENT_FILEPATH(pathp, AFSDIR_SERVER_ETC_DIR,
371 AFSDIR_SERVER_CONFIG_FILE);
373 pathp = dirPathArray[AFSDIR_SERVER_NETINFO_FILEPATH_ID];
374 AFSDIR_SERVER_FILEPATH(pathp, AFSDIR_LOCAL_DIR, AFSDIR_NETINFO_FILE);
376 pathp = dirPathArray[AFSDIR_SERVER_NETRESTRICT_FILEPATH_ID];
377 AFSDIR_SERVER_FILEPATH(pathp, AFSDIR_LOCAL_DIR, AFSDIR_NETRESTRICT_FILE);
379 pathp = dirPathArray[AFSDIR_SERVER_WEIGHTING_CONSTANTS_FILEPATH_ID];
380 AFSDIR_SERVER_FILEPATH(pathp, AFSDIR_MIGR_DIR,
381 AFSDIR_WEIGHTINGCONST_FILE);
383 pathp = dirPathArray[AFSDIR_SERVER_THRESHOLD_CONSTANTS_FILEPATH_ID];
384 AFSDIR_SERVER_FILEPATH(pathp, AFSDIR_MIGR_DIR,
385 AFSDIR_THRESHOLDCONST_FILE);
387 pathp = dirPathArray[AFSDIR_SERVER_MIGRATELOG_FILEPATH_ID];
388 AFSDIR_SERVER_FILEPATH(pathp, AFSDIR_MIGR_DIR, AFSDIR_MIGRATE_LOGNAME);
390 pathp = dirPathArray[AFSDIR_SERVER_KRB_EXCL_FILEPATH_ID];
391 AFSDIR_SERVER_FILEPATH(pathp, AFSDIR_SERVER_ETC_DIR, AFSDIR_KRB_EXCL_FILE);
393 pathp = dirPathArray[AFSDIR_SERVER_FSSTATE_FILEPATH_ID];
394 AFSDIR_SERVER_FILEPATH(pathp, AFSDIR_LOCAL_DIR, AFSDIR_FSSTATE_FILE);
396 pathp = dirPathArray[AFSDIR_SERVER_RXKAD_KEYTAB_FILEPATH_ID];
397 AFSDIR_SERVER_FILEPATH(pathp, AFSDIR_SERVER_ETC_DIR, AFSDIR_RXKAD_KEYTAB_FILE);
399 /* client file paths */
401 strcpy(dirPathArray[AFSDIR_CLIENT_THISCELL_FILEPATH_ID],
402 "/NoUsrViceEtcThisCellFileOnWindows");
403 sprintf(dirPathArray[AFSDIR_CLIENT_CELLSERVDB_FILEPATH_ID], "%s/%s",
404 ntClientConfigDirShort, AFSDIR_CELLSERVDB_FILE_NTCLIENT);
405 strcpy(dirPathArray[AFSDIR_CLIENT_CELLALIAS_FILEPATH_ID],
406 "/NoCellAliasOnWindows");
408 pathp = dirPathArray[AFSDIR_CLIENT_THISCELL_FILEPATH_ID];
409 AFSDIR_CLIENT_FILEPATH(pathp, clntEtcDir, AFSDIR_THISCELL_FILE);
411 pathp = dirPathArray[AFSDIR_CLIENT_CELLSERVDB_FILEPATH_ID];
412 AFSDIR_CLIENT_FILEPATH(pathp, clntEtcDir, AFSDIR_CELLSERVDB_FILE);
414 pathp = dirPathArray[AFSDIR_CLIENT_CELLALIAS_FILEPATH_ID];
415 AFSDIR_CLIENT_FILEPATH(pathp, clntEtcDir, AFSDIR_CELLALIAS_FILE);
416 #endif /* AFS_NT40_ENV */
418 pathp = dirPathArray[AFSDIR_CLIENT_CONFIG_FILE_FILEPATH_ID];
419 AFSDIR_CLIENT_FILEPATH(pathp, clntEtcDir, AFSDIR_CLIENT_CONFIG_FILE);
421 pathp = dirPathArray[AFSDIR_CLIENT_NETINFO_FILEPATH_ID];
422 AFSDIR_CLIENT_FILEPATH(pathp, clntEtcDir, AFSDIR_NETINFO_FILE);
424 pathp = dirPathArray[AFSDIR_CLIENT_NETRESTRICT_FILEPATH_ID];
425 AFSDIR_CLIENT_FILEPATH(pathp, clntEtcDir, AFSDIR_NETRESTRICT_FILE);
427 initFlag = 1; /* finished dirpath initialization */
431 /* afs_getDirPath - returns a const char pointer to the requested string
432 * from the internal path array.
433 * string_id - index into the path array
436 afs_getDirPath(afsdir_id_t string_id)
438 /* check if the array has been initialized */
439 if (initFlag == 0) { /* no it's not, so initialize */
440 #ifdef AFS_PTHREAD_ENV
441 pthread_once(&dirInit_once, initDirPathArray);
446 return (const char *)dirPathArray[string_id];
450 /* getDirPath - present for ABI compatibility on Windows systems;
451 * Unix systems should not use it. */
453 getDirPath(afsdir_id_t string_id)
455 return afs_getDirPath(string_id);
460 * LocalizePathHead() -- Make path relative to local part
462 * ConstructLocalPath takes a path and a directory that path should
463 * be considered relative to. There are two possible cases:
465 * The path is an absolute path. In this case, the relative path
466 * is ignored. We check the path for a prefix that represents a
467 * canonical path, and if one is found, we adjust the path to remove
468 * the prefix and adjust the directory to which it should be
469 * considered relative to be the local version of that canonical path.
471 * The path is a relative path. In this case, we check to see if the
472 * directory to which it is relative represents a canonical path, and
473 * if so, we adjust that directory to be the local version of that
474 * canonical path. The relative path itself is left unchanged.
477 /* The following array maps cannonical parts to local parts. It
478 * might seem reasonable to simply construct an array in parallel to
479 * dirpatharray but it turns out you don't want translations for all
483 struct canonmapping {
484 const char *canonical;
487 static struct canonmapping CanonicalTranslations[] = {
488 {AFSDIR_CANONICAL_SERVER_ETC_DIRPATH, AFSDIR_SERVER_ETC_DIR},
489 {AFSDIR_CANONICAL_SERVER_LOGS_DIRPATH, AFSDIR_LOGS_DIR},
490 {AFSDIR_CANONICAL_SERVER_LOCAL_DIRPATH, AFSDIR_LOCAL_DIR},
491 {AFSDIR_CANONICAL_SERVER_BIN_DIRPATH, AFSDIR_SERVER_BIN_DIR},
496 LocalizePathHead(const char **path, const char **relativeTo)
498 struct canonmapping *map;
501 for (map = CanonicalTranslations; map->local != NULL; map++) {
502 int canonlength = strlen(map->canonical);
503 if (strncmp(*path, map->canonical, canonlength) == 0) {
504 (*path) += canonlength;
507 *relativeTo = map->local;
512 for (map = CanonicalTranslations; map->local != NULL; map++) {
513 if (strcmp(*relativeTo, map->canonical) == 0) {
514 *relativeTo = map->local;
523 /* NT version of ConstructLocalPath() */
526 * ConstructLocalPath() -- Convert a canonical (wire-format) path to a fully
527 * specified local path. Upon successful completion, *fullPathBufp is
528 * set to an allocated buffer containing the fully specified local path
529 * constructed from the cpath argument.
531 * On NT, path construction proceeds as follows:
532 * 1) If cpath is fully qualified (i.e., starts with 'X:/') then the
533 * path returned is equivalent to cpath.
534 * 2) If cpath begins with a drive letter but is not fully qualified,
535 * i.e., it is drive relative, then the function fails with EINVAL.
536 * 3) If cpath begins with '/' (or '\') then the path returned is the
537 * concatenation AFS-server-install-dir + cpath after translating for localization.
538 * 4) Otherwise the path returned is the concatenation
539 * AFS-server-install-dir + relativeTo + cpath.
541 * Leading whitespace in cpath is ignored; the constructed path is
542 * normalized (FilepathNormalize()).
544 * RETURN CODES: 0 if successful; errno code otherwise.
547 ConstructLocalPath(const char *cpath, const char *relativeTo,
551 char *newPath = NULL;
553 if (initFlag == 0) { /* dirpath module not yet initialized */
554 #ifdef AFS_PTHREAD_ENV
555 pthread_once(&dirInit_once, initDirPathArray);
561 *fullPathBufp = NULL;
566 while (isspace(*cpath)) {
570 LocalizePathHead(&cpath, &relativeTo);
571 if ((((*cpath >= 'a') && (*cpath <= 'z'))
572 || ((*cpath >= 'A') && (*cpath <= 'Z'))) && (*(cpath + 1) == ':')) {
574 /* cpath has a leading drive letter */
575 if ((*(cpath + 2) != '/') && (*(cpath + 2) != '\\')) {
576 /* drive letter relative path; this is not allowed */
579 /* fully qualified path; just make a copy */
580 newPath = strdup(cpath);
586 /* cpath has NO leading drive letter; make relative to install dir */
587 size_t pathSize = strlen(ntServerInstallDirShort) + 2;
589 if ((*cpath == '/') || (*cpath == '\\')) {
590 /* construct path relative to install directory only */
591 pathSize += strlen(cpath);
593 newPath = malloc(pathSize);
597 sprintf(newPath, "%s/%s", ntServerInstallDirShort, cpath);
600 /* construct path relative to 'relativeTo' (and install dir) */
601 pathSize += strlen(relativeTo) + 1 + strlen(cpath);
603 newPath = malloc(pathSize);
607 sprintf(newPath, "%s/%s/%s", ntServerInstallDirShort,
614 FilepathNormalize(newPath);
616 /* return buffer containing fully specified path */
617 *fullPathBufp = newPath;
624 /* Unix version of ConstructLocalPath() */
627 * ConstructLocalPath() -- Convert a canonical (wire-format) path to a fully
628 * specified local path. Upon successful completion, *fullPathBufp is
629 * set to an allocated buffer containing the fully specified local path
630 * constructed from the cpath argument.
632 * On Unix, path construction proceeds as follows:
633 * 1) If cpath begins with '/' then the path returned is equivalent
635 * 2) Otherwise the path returned is the concatenation
636 * relativeTo + cpath.
638 * Leading whitespace in cpath is ignored; the constructed path is
639 * normalized (FilepathNormalize()).
641 * RETURN CODES: 0 if successful; errno code otherwise.
644 ConstructLocalPath(const char *cpath, const char *relativeTo,
648 char *newPath = NULL;
650 if (initFlag == 0) { /* dirpath module not yet initialized */
651 #ifdef AFS_PTHREAD_ENV
652 pthread_once(&dirInit_once, initDirPathArray);
658 *fullPathBufp = NULL;
663 while (isspace(*cpath)) {
667 LocalizePathHead(&cpath, &relativeTo);
669 newPath = strdup(cpath);
671 if (asprintf(&newPath, "%s/%s", relativeTo, cpath) < 0)
678 FilepathNormalize(newPath);
680 /* return buffer containing fully specified path */
681 *fullPathBufp = newPath;
686 #endif /* AFS_NT40_ENV */
690 * ConstructLocalBinPath() -- A convenience wrapper for ConstructLocalPath()
691 * that specifies the canonical AFS server binary directory as the relative
695 ConstructLocalBinPath(const char *cpath, char **fullPathBufp)
697 return ConstructLocalPath(cpath, AFSDIR_SERVER_BIN_DIRPATH,
703 * ConstructLocalLogPath() -- A convenience wrapper for ConstructLocalPath()
704 * that specifies the canonical AFS server logs directory as the relative
708 ConstructLocalLogPath(const char *cpath, char **fullPathBufp)
710 return ConstructLocalPath(cpath, AFSDIR_SERVER_LOGS_DIRPATH,