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
11 * Information Technology Center
15 * The Andrew File System startup process. It is responsible for
16 * reading and parsing the various configuration files, starting up
17 * the kernel processes required by AFS and feeding the configuration
18 * information to the kernel.
20 * Recognized flags are:
21 * -blocks The number of blocks available in the workstation cache.
22 * -files The target number of files in the workstation cache (Default:
24 * -rootvol The name of the root volume to use.
25 * -stat The number of stat cache entries.
26 * -hosts List of servers to check for volume location info FOR THE
28 * -memcache Use an in-memory cache rather than disk.
29 * -cachedir The base directory for the workstation cache.
30 * -mountdir The directory on which the AFS is to be mounted.
31 * -confdir The configuration directory .
32 * -nosettime Don't keep checking the time to avoid drift (default).
33 * -settime Keep checking the time to avoid drift.
34 * -rxmaxmtu Set the max mtu to help with VPN issues.
36 * -disable-dynamic-vcaches Disable the use of -stat value as the starting size of
37 * the size of the vcache/stat cache pool,
38 * but increase that pool dynamically as needed.
39 * -debug Print out additional debugging info.
40 * -kerndev [OBSOLETE] The kernel device for AFS.
41 * -dontfork [OBSOLETE] Don't fork off as a new process.
42 * -daemons The number of background daemons to start (Default: 2).
43 * -rmtsys Also fires up an afs remote sys call (e.g. pioctl, setpag)
45 * -chunksize [n] 2^n is the chunksize to be used. 0 is default.
46 * -dcache The number of data cache entries.
47 * -biods Number of bkg I/O daemons (AIX3.1 only)
48 * -prealloc Number of preallocated "small" memory blocks
49 * -logfile [OBSOLETE] Place where to put the logfile (default in
51 * -waitclose make close calls always synchronous (slows em down, tho)
52 * -files_per_subdir [n] number of files per cache subdir. (def=2048)
53 * -shutdown Shutdown afs daemons
54 *---------------------------------------------------------------------------*/
56 #include <afsconfig.h>
57 #include <afs/param.h>
59 #ifdef IGNORE_SOME_GCC_WARNINGS
60 # pragma GCC diagnostic warning "-Wdeprecated-declarations"
71 #include <afs/afs_assert.h>
72 #include <afs/afsutil.h>
79 #include <sys/types.h>
86 /* darwin dirent.h doesn't give us the prototypes we want if KERNEL is
88 #if defined(UKERNEL) && defined(AFS_USR_DARWIN_ENV)
97 #ifdef HAVE_SYS_PARAM_H
98 #include <sys/param.h>
101 #ifdef HAVE_SYS_FS_TYPES_H
102 #include <sys/fs_types.h>
105 #if defined(HAVE_SYS_MOUNT_H) && !defined(AFS_ARM_DARWIN_ENV)
106 #include <sys/mount.h>
109 #ifdef HAVE_SYS_FCNTL_H
110 #include <sys/fcntl.h>
113 #ifdef HAVE_SYS_MNTTAB_H
114 #include <sys/mnttab.h>
117 #ifdef HAVE_SYS_MNTENT_H
118 #include <sys/mntent.h>
125 #ifdef HAVE_SYS_VFS_H
129 #ifdef HAVE_SYS_FSTYP_H
130 #include <sys/fstyp.h>
141 #include <netinet/in.h>
142 #include <afs/afs_args.h>
143 #include <afs/cellconfig.h>
145 #include <afs/afssyscalls.h>
146 #include <afs/afsutil.h>
147 #include <afs/sys_prototypes.h>
153 #include <libdwarf.h>
154 void set_staticaddrs(void);
155 #endif /* AFS_SGI61_ENV */
156 #if defined(AFS_SGI62_ENV) && !defined(AFS_SGI65_ENV)
158 #include <symconst.h>
164 #ifdef AFS_DARWIN_ENV
165 #ifdef AFS_DARWIN80_ENV
166 #include <sys/ioctl.h>
167 #include <sys/xattr.h>
169 #include <CoreFoundation/CoreFoundation.h>
171 #include <SystemConfiguration/SystemConfiguration.h>
172 #include <SystemConfiguration/SCDynamicStore.h>
174 #ifndef AFS_ARM_DARWIN_ENV
175 #include <IOKit/pwr_mgt/IOPMLib.h>
176 #include <IOKit/IOMessage.h>
178 static io_connect_t root_port;
179 static IONotificationPortRef notify;
180 static io_object_t iterator;
183 static CFRunLoopSourceRef source;
185 static int event_pid;
187 #endif /* AFS_DARWIN_ENV */
189 #if AFS_HAVE_STATVFS || defined(HAVE_SYS_STATVFS_H)
190 #include <sys/statvfs.h>
192 #if defined(AFS_SUN_ENV)
195 #ifdef HAVE_SYS_STATFS_H
196 #include <sys/statfs.h>
205 #define CACHEINFOFILE "cacheinfo"
206 #define DCACHEFILE "CacheItems"
207 #define VOLINFOFILE "VolumeItems"
208 #define CELLINFOFILE "CellItems"
210 #define MAXIPADDRS 1024
212 char LclCellName[64];
214 #define MAX_CACHE_LOOPS 4
218 * Internet address (old style... should be updated). This was pulled out of the old 4.2
219 * version of <netinet/in.h>, since it's still useful.
224 u_char s_b1, s_b2, s_b3, s_b4;
233 #define mPrintIPAddr(ipaddr) printf("[%d.%d.%d.%d] ", \
234 ((struct in_addr_42 *) &(ipaddr))->S_un.S_un_b.s_b1, \
235 ((struct in_addr_42 *) &(ipaddr))->S_un.S_un_b.s_b2, \
236 ((struct in_addr_42 *) &(ipaddr))->S_un.S_un_b.s_b3, \
237 ((struct in_addr_42 *) &(ipaddr))->S_un.S_un_b.s_b4)
240 * Global configuration variables.
242 static afs_int32 enable_rxbind = 0;
243 static afs_int32 afs_shutdown = 0;
244 static afs_int32 cacheBlocks; /*Num blocks in the cache */
245 static afs_int32 cacheFiles; /*Optimal # of files in workstation cache */
246 static afs_int32 rwpct = 0;
247 static afs_int32 ropct = 0;
248 static afs_int32 cacheStatEntries; /*Number of stat cache entries */
249 static char cacheBaseDir[1024]; /*Where the workstation AFS cache lives */
250 static char confDir[1024]; /*Where the workstation AFS configuration lives */
251 static char fullpn_DCacheFile[1024]; /*Full pathname of DCACHEFILE */
252 static char fullpn_VolInfoFile[1024]; /*Full pathname of VOLINFOFILE */
253 static char fullpn_CellInfoFile[1024]; /*Full pathanem of CELLINFOFILE */
254 static char fullpn_CacheInfo[1024]; /*Full pathname of CACHEINFO */
255 static char fullpn_VFile[1024]; /*Full pathname of data cache files */
256 static char *vFilePtr; /*Ptr to the number part of above pathname */
257 static int sawCacheMountDir = 0; /* from cmd line */
258 static int sawCacheBaseDir = 0;
259 static int sawCacheBlocks = 0;
260 static int sawDCacheSize = 0;
262 static int sawBiod = 0;
264 static int sawCacheStatEntries = 0;
265 char afsd_cacheMountDir[1024]; /*Mount directory for AFS */
266 static char rootVolume[64] = "root.afs"; /*AFS root volume name */
267 static afs_int32 cacheSetTime = 0; /*Keep checking time to avoid drift? */
269 static int createAndTrunc = O_RDWR | O_CREAT | O_TRUNC; /*Create & truncate on open */
271 static int createAndTrunc = O_CREAT | O_TRUNC; /*Create & truncate on open */
273 static int ownerRWmode = 0600; /*Read/write OK by owner */
274 static int filesSet = 0; /*True if number of files explicitly set */
275 static int nFilesPerDir = 2048; /* # files per cache dir */
276 #if defined(AFS_CACHE_BYPASS)
277 #define AFSD_NDAEMONS 4
279 #define AFSD_NDAEMONS 2
281 static int nDaemons = AFSD_NDAEMONS; /* Number of background daemons */
282 static int chunkSize = 0; /* 2^chunkSize bytes per chunk */
283 static int dCacheSize; /* # of dcache entries */
284 static int vCacheSize = 200; /* # of volume cache entries */
285 static int rootVolSet = 0; /*True if root volume name explicitly set */
286 int addrNum; /*Cell server address index being printed */
287 static int cacheFlags = 0; /*Flags to cache manager */
289 static int nBiods = 5; /* AIX3.1 only */
291 static int preallocs = 400; /* Def # of allocated memory blocks */
292 static int enable_peer_stats = 0; /* enable rx stats */
293 static int enable_process_stats = 0; /* enable rx stats */
294 static int enable_afsdb = 0; /* enable AFSDB support */
295 static int enable_dynroot = 0; /* enable dynroot support */
296 static int enable_fakestat = 0; /* enable fakestat support */
297 static int enable_backuptree = 0; /* enable backup tree support */
298 static int enable_nomount = 0; /* do not mount */
299 static int enable_splitcache = 0;
300 static int afsd_dynamic_vcaches = 0; /* Enable dynamic-vcache support */
301 int afsd_verbose = 0; /*Are we being chatty? */
302 int afsd_debug = 0; /*Are we printing debugging info? */
303 static int afsd_CloseSynch = 0; /*Are closes synchronous or not? */
304 static int rxmaxmtu = 0; /* Are we forcing a limit on the mtu? */
307 #define AFSD_INO_T ino64_t
309 #define AFSD_INO_T afs_uint32
311 struct afsd_file_list {
313 struct afsd_file_list *next;
315 struct afsd_file_list **cache_dir_filelist = NULL;
316 int *cache_dir_list = NULL; /* Array of cache subdirs */
317 int *dir_for_V = NULL; /* Array: dir of each cache file.
318 * -1: file does not exist
319 * -2: file exists in top-level
320 * >=0: file exists in Dxxx
322 #if !defined(AFS_CACHE_VNODE_PATH) && !defined(AFS_LINUX26_ENV)
323 AFSD_INO_T *inode_for_V; /* Array of inodes for desired
326 int missing_DCacheFile = 1; /*Is the DCACHEFILE missing? */
327 int missing_VolInfoFile = 1; /*Is the VOLINFOFILE missing? */
328 int missing_CellInfoFile = 1; /*Is the CELLINFOFILE missing? */
329 int afsd_rmtsys = 0; /* Default: don't support rmtsys */
330 struct afs_cacheParams cparams; /* params passed to cache manager */
332 int PartSizeOverflow(char *path, int cs);
334 #if defined(AFS_SUN510_ENV) && defined(RXK_LISTENER_ENV)
335 static void fork_rx_syscall_wait();
337 #if defined(AFS_SUN510_ENV) || defined(RXK_LISTENER_ENV)
338 static void fork_rx_syscall();
340 static void fork_syscall();
342 #if defined(AFS_DARWIN_ENV) && !defined(AFS_ARM_DARWIN_ENV)
344 afsd_sleep_callback(void * refCon, io_service_t service,
345 natural_t messageType, void * messageArgument )
347 switch (messageType) {
348 case kIOMessageCanSystemSleep:
349 /* Idle sleep is about to kick in; can
350 prevent sleep by calling IOCancelPowerChange, otherwise
351 if we don't ack in 30s the system sleeps anyway */
354 IOAllowPowerChange(root_port, (long)messageArgument);
357 case kIOMessageSystemWillSleep:
358 /* The system WILL go to sleep. Ack or suffer delay */
360 IOAllowPowerChange(root_port, (long)messageArgument);
363 case kIOMessageSystemWillRestart:
364 /* The system WILL restart. Ack or suffer delay */
366 IOAllowPowerChange(root_port, (long)messageArgument);
369 case kIOMessageSystemWillPowerOn:
370 case kIOMessageSystemHasPoweredOn:
371 /* coming back from sleep */
373 IOAllowPowerChange(root_port, (long)messageArgument);
377 IOAllowPowerChange(root_port, (long)messageArgument);
383 afsd_update_addresses(CFRunLoopTimerRef timer, void *info)
385 /* parse multihomed address files */
386 afs_uint32 addrbuf[MAXIPADDRS], maskbuf[MAXIPADDRS],
392 parseNetFiles(addrbuf, maskbuf, mtubuf, MAXIPADDRS, reason,
393 AFSDIR_CLIENT_NETINFO_FILEPATH,
394 AFSDIR_CLIENT_NETRESTRICT_FILEPATH);
397 /* Note we're refreshing */
398 code = code | 0x40000000;
399 afsd_call_syscall(AFSOP_ADVISEADDR, code, addrbuf, maskbuf, mtubuf);
401 printf("ADVISEADDR: Error in specifying interface addresses:%s\n",
404 /* Since it's likely this means our DNS server changed, reinit now */
409 /* This function is called when the system's ip addresses may have changed. */
411 afsd_ipaddr_callback (SCDynamicStoreRef store, CFArrayRef changed_keys, void *info)
413 CFRunLoopTimerRef timer;
415 timer = CFRunLoopTimerCreate (NULL, CFAbsoluteTimeGetCurrent () + 1.0,
416 0.0, 0, 0, afsd_update_addresses, NULL);
417 CFRunLoopAddTimer (CFRunLoopGetCurrent (), timer,
418 kCFRunLoopDefaultMode);
423 afsd_event_cleanup(int signo) {
425 CFRunLoopRemoveSource(CFRunLoopGetCurrent(), source, kCFRunLoopDefaultMode);
427 #ifndef AFS_ARM_DARWIN_ENV
428 IODeregisterForSystemPower(&iterator);
429 IOServiceClose(root_port);
430 IONotificationPortDestroy(notify);
435 /* Adapted from "Living in a Dynamic TCP/IP Environment" technote. */
437 afsd_install_events(void)
439 SCDynamicStoreContext ctx = {0};
440 SCDynamicStoreRef store;
442 #ifndef AFS_ARM_DARWIN_ENV
443 root_port = IORegisterForSystemPower(0,¬ify,afsd_sleep_callback,&iterator);
446 CFRunLoopAddSource(CFRunLoopGetCurrent(),
447 IONotificationPortGetRunLoopSource(notify),
448 kCFRunLoopDefaultMode);
452 store = SCDynamicStoreCreate (NULL,
453 CFSTR ("AddIPAddressListChangeCallbackSCF"),
454 afsd_ipaddr_callback, &ctx);
459 /* Request IPV4 address change notification */
460 keys[0] = (SCDynamicStoreKeyCreateNetworkServiceEntity
461 (NULL, kSCDynamicStoreDomainState,
462 kSCCompAnyRegex, kSCEntNetIPv4));
465 /* This should tell us when the hostname(s) change. do we care? */
466 keys[N] = SCDynamicStoreKeyCreateHostNames (NULL);
469 if (keys[0] != NULL) {
470 CFArrayRef pattern_array;
472 pattern_array = CFArrayCreate (NULL, keys, 1,
473 &kCFTypeArrayCallBacks);
475 if (pattern_array != NULL)
477 SCDynamicStoreSetNotificationKeys (store, NULL, pattern_array);
478 source = SCDynamicStoreCreateRunLoopSource (NULL, store, 0);
480 CFRelease (pattern_array);
491 if (source != NULL) {
492 CFRunLoopAddSource (CFRunLoopGetCurrent(),
493 source, kCFRunLoopDefaultMode);
496 signal(SIGTERM, afsd_event_cleanup);
502 /* ParseArgs is now obsolete, being handled by cmd */
504 /*------------------------------------------------------------------------------
508 * Open the file containing the description of the workstation's AFS cache
509 * and pull out its contents. The format of this file is as follows:
511 * cacheMountDir:cacheBaseDir:cacheBlocks
517 * 0 if everything went well,
521 * Nothing interesting.
525 *---------------------------------------------------------------------------*/
528 ParseCacheInfoFile(void)
530 static char rn[] = "ParseCacheInfoFile"; /*This routine's name */
531 FILE *cachefd; /*Descriptor for cache info file */
532 int parseResult; /*Result of our fscanf() */
533 afs_int32 tCacheBlocks;
534 char tCacheBaseDir[1024], *tbd, tCacheMountDir[1024], *tmd;
537 printf("%s: Opening cache info file '%s'...\n", rn, fullpn_CacheInfo);
539 cachefd = fopen(fullpn_CacheInfo, "r");
541 printf("%s: Can't read cache info file '%s'\n", rn, fullpn_CacheInfo);
546 * Parse the contents of the cache info file. All chars up to the first
547 * colon are the AFS mount directory, all chars to the next colon are the
548 * full path name of the workstation cache directory and all remaining chars
549 * represent the number of blocks in the cache.
551 tCacheMountDir[0] = tCacheBaseDir[0] = '\0';
553 fscanf(cachefd, "%1024[^:]:%1024[^:]:%d", tCacheMountDir,
554 tCacheBaseDir, &tCacheBlocks);
557 * Regardless of how the parse went, we close the cache info file.
561 if (parseResult == EOF || parseResult < 3) {
562 printf("%s: Format error in cache info file!\n", rn);
563 if (parseResult == EOF)
564 printf("\tEOF encountered before any field parsed.\n");
566 printf("\t%d out of 3 fields successfully parsed.\n",
572 for (tmd = tCacheMountDir; *tmd == '\n' || *tmd == ' ' || *tmd == '\t';
574 for (tbd = tCacheBaseDir; *tbd == '\n' || *tbd == ' ' || *tbd == '\t';
576 /* now copy in the fields not explicitly overridden by cmd args */
577 if (!sawCacheMountDir)
578 strcpy(afsd_cacheMountDir, tmd);
579 if (!sawCacheBaseDir)
580 strcpy(cacheBaseDir, tbd);
582 cacheBlocks = tCacheBlocks;
585 printf("%s: Cache info file successfully parsed:\n", rn);
587 ("\tcacheMountDir: '%s'\n\tcacheBaseDir: '%s'\n\tcacheBlocks: %d\n",
588 tmd, tbd, tCacheBlocks);
590 if (!(cacheFlags & AFSCALL_INIT_MEMCACHE)) {
591 return (PartSizeOverflow(tbd, cacheBlocks));
598 * All failures to open the partition are ignored. Also if the cache dir
599 * isn't a mounted partition it's also ignored since we can't guarantee
600 * what will be stored afterwards. Too many if's. This is now purely
601 * advisory. ODS with over 2G partition also gives warning message.
604 * 0 if everything went well,
608 PartSizeOverflow(char *path, int cs)
611 afs_int64 totalblks, mint;
612 #if AFS_HAVE_STATVFS || defined(HAVE_SYS_STATVFS_H)
613 struct statvfs statbuf;
615 if (statvfs(path, &statbuf) != 0) {
618 ("statvfs failed on %s; skip checking for adequate partition space\n",
622 totalblks = statbuf.f_blocks;
623 bsize = statbuf.f_frsize;
625 if (strcmp(statbuf.f_basetype, "jfs")) {
626 fprintf(stderr, "Cache filesystem '%s' must be jfs (now %s)\n",
627 path, statbuf.f_basetype);
630 #endif /* AFS_AIX51_ENV */
632 #else /* AFS_HAVE_STATVFS */
633 struct statfs statbuf;
635 if (statfs(path, &statbuf) < 0) {
638 ("statfs failed on %s; skip checking for adequate partition space\n",
642 totalblks = statbuf.f_blocks;
643 bsize = statbuf.f_bsize;
646 return 0; /* success */
648 /* now free and totalblks are in fragment units, but we want them in 1K units */
650 totalblks *= (bsize / 1024);
652 totalblks /= (1024 / bsize);
655 mint = totalblks / 100 * 95;
658 ("Cache size (%d) must be less than 95%% of partition size (which is %lld). Lower cache size\n",
666 /*-----------------------------------------------------------------------------
670 * Given the final component of a filename expected to be a data cache file,
671 * return the integer corresponding to the file. Note: we reject names that
672 * are not a ``V'' followed by an integer. We also reject those names having
673 * the right format but lying outside the range [0..cacheFiles-1].
676 * fname : Char ptr to the filename to parse.
677 * max : integer for the highest number to accept
680 * >= 0 iff the file is really a data cache file numbered from 0 to cacheFiles-1, or
684 * Nothing interesting.
688 *---------------------------------------------------------------------------*/
691 doGetXFileNumber(char *fname, char filechar, int maxNum)
693 int computedVNumber; /*The computed file number we return */
694 int filenameLen; /*Number of chars in filename */
695 int currDigit; /*Current digit being processed */
698 * The filename must have at least two characters, the first of which must be a ``filechar''
699 * and the second of which cannot be a zero unless the file is exactly two chars long.
701 filenameLen = strlen(fname);
704 if (fname[0] != filechar)
706 if ((filenameLen > 2) && (fname[1] == '0'))
710 * Scan through the characters in the given filename, failing immediately if a non-digit
713 for (currDigit = 1; currDigit < filenameLen; currDigit++)
714 if (isdigit(fname[currDigit]) == 0)
718 * All relevant characters are digits. Pull out the decimal number they represent.
719 * Reject it if it's out of range, otherwise return it.
721 computedVNumber = atoi(++fname);
722 if (computedVNumber < cacheFiles)
723 return (computedVNumber);
729 GetVFileNumber(char *fname, int maxFile)
731 return doGetXFileNumber(fname, 'V', maxFile);
735 GetDDirNumber(char *fname, int maxDir)
737 return doGetXFileNumber(fname, 'D', maxDir);
741 /*-----------------------------------------------------------------------------
745 * Given a full pathname for a file we need to create for the workstation AFS
746 * cache, go ahead and create the file.
749 * fname : Full pathname of file to create.
750 * statp : A pointer to a stat buffer which, if NON-NULL, will be
754 * 0 iff the file was created,
758 * The given cache file has been found to be missing.
762 *---------------------------------------------------------------------------*/
765 CreateCacheSubDir(char *basename, int dirNum)
767 static char rn[] = "CreateCacheSubDir"; /* Routine Name */
771 /* Build the new cache subdirectory */
772 sprintf(dir, "%s/D%d", basename, dirNum);
775 printf("%s: Creating cache subdir '%s'\n", rn, dir);
777 if ((ret = mkdir(dir, 0700)) != 0) {
778 printf("%s: Can't create '%s', error return is %d (%d)\n", rn, dir,
784 /* Mark this directory as created */
785 cache_dir_list[dirNum] = 0;
787 /* And return success */
792 SetNoBackupAttr(char *fullpn)
794 #ifdef AFS_DARWIN80_ENV
797 ret = setxattr(fullpn, "com.apple.metadata:com_apple_backup_excludeItem",
798 "com.apple.backupd", strlen("com.apple.backupd"), 0,
803 fprintf(stderr, "afsd: Warning: failed to set attribute to preclude cache backup: %s\n", strerror(errno));
810 MoveCacheFile(char *basename, int fromDir, int toDir, int cacheFile,
813 static char rn[] = "MoveCacheFile";
814 char from[1024], to[1024];
817 if (cache_dir_list[toDir] < 0
818 && (ret = CreateCacheSubDir(basename, toDir))) {
819 printf("%s: Can't create directory '%s/D%d'\n", rn, basename, toDir);
823 /* Build the from,to dir */
825 /* old-style location */
826 snprintf(from, sizeof(from), "%s/V%d", basename, cacheFile);
828 snprintf(from, sizeof(from), "%s/D%d/V%d", basename, fromDir,
832 snprintf(to, sizeof(from), "%s/D%d/V%d", basename, toDir, cacheFile);
835 printf("%s: Moving cacheFile from '%s' to '%s'\n", rn, from, to);
837 if ((ret = rename(from, to)) != 0) {
838 printf("%s: Can't rename '%s' to '%s', error return is %d (%d)\n", rn,
839 from, to, ret, errno);
844 /* Reset directory pointer; fix file counts */
845 dir_for_V[cacheFile] = toDir;
846 cache_dir_list[toDir]++;
847 if (fromDir < maxDir && fromDir >= 0)
848 cache_dir_list[fromDir]--;
854 CreateCacheFile(char *fname, struct stat *statp)
856 static char rn[] = "CreateCacheFile"; /*Routine name */
857 int cfd; /*File descriptor to AFS cache file */
858 int closeResult; /*Result of close() */
861 printf("%s: Creating cache file '%s'\n", rn, fname);
862 cfd = open(fname, createAndTrunc, ownerRWmode);
864 printf("%s: Can't create '%s', error return is %d (%d)\n", rn, fname,
869 closeResult = fstat(cfd, statp);
872 ("%s: Can't stat newly-created AFS cache file '%s' (code %d)\n",
877 closeResult = close(cfd);
880 ("%s: Can't close newly-created AFS cache file '%s' (code %d)\n",
889 CreateFileIfMissing(char *fullpn, int missing)
892 if (CreateCacheFile(fullpn, NULL))
893 printf("CreateFileIfMissing: Can't create '%s'\n", fullpn);
898 UnlinkUnwantedFile(char *rn, char *fullpn_FileToDelete, char *fileToDelete)
900 if (unlink(fullpn_FileToDelete)) {
901 if ((errno == EISDIR || errno == EPERM) && *fileToDelete == 'D') {
902 if (rmdir(fullpn_FileToDelete)) {
903 printf("%s: Can't rmdir '%s', errno is %d\n", rn,
904 fullpn_FileToDelete, errno);
907 printf("%s: Can't unlink '%s', errno is %d\n", rn,
908 fullpn_FileToDelete, errno);
912 /*-----------------------------------------------------------------------------
916 * Sweep through the AFS cache directory, recording the inode number for
917 * each valid data cache file there. Also, delete any file that doesn't belong
918 * in the cache directory during this sweep, and remember which of the other
919 * residents of this directory were seen. After the sweep, we create any data
920 * cache files that were missing.
923 * vFilesFound : Set to the number of data cache files found.
926 * 0 if everything went well,
930 * This routine may be called several times. If the number of data cache files
931 * found is less than the global cacheFiles, then the caller will need to call it
932 * again to record the inodes of the missing zero-length data cache files created
933 * in the previous call.
936 * Fills up the global inode_for_V array, may create and/or delete files as
938 *---------------------------------------------------------------------------*/
942 doSweepAFSCache(int *vFilesFound,
943 char *directory, /* /path/to/cache/directory */
944 int dirNum, /* current directory number */
945 int maxDir) /* maximum directory number */
947 static char rn[] = "doSweepAFSCache"; /* Routine Name */
948 char fullpn_FileToDelete[1024]; /*File to be deleted from cache */
949 char *fileToDelete; /*Ptr to last component of above */
950 DIR *cdirp; /*Ptr to cache directory structure */
952 struct dirent64 *currp; /*Current directory entry */
954 struct dirent *currp; /*Current directory entry */
956 int vFileNum; /*Data cache file's associated number */
957 int thisDir; /* A directory number */
961 printf("%s: Opening cache directory '%s'\n", rn, directory);
963 if (chmod(directory, 0700)) { /* force it to be 700 */
964 printf("%s: Can't 'chmod 0700' the cache dir, '%s'.\n", rn,
968 cdirp = opendir(directory);
969 if (cdirp == (DIR *) 0) {
970 printf("%s: Can't open AFS cache directory, '%s'.\n", rn, directory);
975 * Scan the directory entries, remembering data cache file inodes
976 * and the existance of other important residents. Recurse into
977 * the data subdirectories.
979 * Delete all files and directories that don't belong here.
981 sprintf(fullpn_FileToDelete, "%s/", directory);
982 fileToDelete = fullpn_FileToDelete + strlen(fullpn_FileToDelete);
985 for (currp = readdir64(cdirp); currp; currp = readdir64(cdirp))
987 for (currp = readdir(cdirp); currp; currp = readdir(cdirp))
991 printf("%s: Current directory entry:\n", rn);
992 #if defined(AFS_SGI62_ENV) || defined(AFS_DARWIN90_ENV)
993 printf("\tinode=%" AFS_INT64_FMT ", reclen=%d, name='%s'\n", currp->d_ino,
994 currp->d_reclen, currp->d_name);
995 #elif defined(AFS_DFBSD_ENV) || defined(AFS_USR_DFBSD_ENV)
996 printf("\tinode=%ld, name='%s'\n", (long)currp->d_ino, currp->d_name);
998 printf("\tinode=%ld, reclen=%d, name='%s'\n", (long)currp->d_ino,
999 currp->d_reclen, currp->d_name);
1004 * If dirNum < 0, we are a top-level cache directory and should
1005 * only contain sub-directories and other sundry files. Therefore,
1006 * V-files are valid only if dirNum >= 0, and Directories are only
1007 * valid if dirNum < 0.
1010 if (*(currp->d_name) == 'V'
1011 && ((vFileNum = GetVFileNumber(currp->d_name, cacheFiles)) >=
1014 * Found a valid data cache filename. Remember this
1015 * file's inode, directory, and bump the number of files found
1016 * total and in this directory.
1018 #if !defined(AFS_CACHE_VNODE_PATH) && !defined(AFS_LINUX26_ENV)
1019 inode_for_V[vFileNum] = currp->d_ino;
1021 dir_for_V[vFileNum] = dirNum; /* remember this directory */
1024 /* If we're in a real subdir, mark this file to be moved
1025 * if we've already got too many files in this directory
1027 assert(dirNum >= 0);
1028 cache_dir_list[dirNum]++; /* keep directory's file count */
1029 if (cache_dir_list[dirNum] > nFilesPerDir) {
1030 /* Too many files -- add to filelist */
1031 struct afsd_file_list *tmp = (struct afsd_file_list *)
1032 malloc(sizeof(*tmp));
1035 ("%s: MALLOC FAILED allocating file_list entry\n",
1038 tmp->fileNum = vFileNum;
1039 tmp->next = cache_dir_filelist[dirNum];
1040 cache_dir_filelist[dirNum] = tmp;
1045 } else if (dirNum < 0 && (*(currp->d_name) == 'D')
1046 && GetDDirNumber(currp->d_name, 1 << 30) >= 0) {
1048 if ((vFileNum = GetDDirNumber(currp->d_name, maxDir)) >= 0) {
1049 /* Found a valid cachefile sub-Directory. Remember this number
1050 * and recurse into it. Note that subdirs cannot have subdirs.
1053 } else if ((vFileNum = GetDDirNumber(currp->d_name, 1 << 30)) >=
1055 /* This directory is going away, but figure out if there
1056 * are any cachefiles in here that should be saved by
1057 * moving them to other cache directories. This directory
1058 * will be removed later.
1063 /* Save the highest directory number we've seen */
1064 if (vFileNum > highDir)
1067 /* If this directory is staying, be sure to mark it as 'found' */
1069 cache_dir_list[vFileNum] = 0;
1071 /* Print the dirname for recursion */
1072 sprintf(fileToDelete, "%s", currp->d_name);
1074 /* Note: vFileNum is the directory number */
1076 doSweepAFSCache(vFilesFound, fullpn_FileToDelete, vFileNum,
1077 (retval == 1 ? 0 : -1));
1079 printf("%s: Recursive sweep failed on directory %s\n", rn,
1083 } else if (dirNum < 0 && strcmp(currp->d_name, DCACHEFILE) == 0) {
1085 * Found the file holding the dcache entries.
1087 missing_DCacheFile = 0;
1088 SetNoBackupAttr(fullpn_DCacheFile);
1089 } else if (dirNum < 0 && strcmp(currp->d_name, VOLINFOFILE) == 0) {
1091 * Found the file holding the volume info.
1093 missing_VolInfoFile = 0;
1094 SetNoBackupAttr(fullpn_VolInfoFile);
1095 } else if (dirNum < 0 && strcmp(currp->d_name, CELLINFOFILE) == 0) {
1097 * Found the file holding the cell info.
1099 missing_CellInfoFile = 0;
1100 SetNoBackupAttr(fullpn_CellInfoFile);
1101 } else if ((strcmp(currp->d_name, ".") == 0)
1102 || (strcmp(currp->d_name, "..") == 0) ||
1103 #ifdef AFS_DECOSF_ENV
1104 /* these are magic AdvFS files */
1105 (strcmp(currp->d_name, ".tags") == 0)
1106 || (strcmp(currp->d_name, "quota.user") == 0)
1107 || (strcmp(currp->d_name, "quota.group") == 0) ||
1109 #ifdef AFS_LINUX22_ENV
1110 /* this is the ext3 journal file */
1111 (strcmp(currp->d_name, ".journal") == 0) ||
1113 (strcmp(currp->d_name, "lost+found") == 0)) {
1115 * Don't do anything - this file is legit, and is to be left alone.
1119 * This file/directory doesn't belong in the cache. Nuke it.
1121 sprintf(fileToDelete, "%s", currp->d_name);
1123 printf("%s: Deleting '%s'\n", rn, fullpn_FileToDelete);
1124 UnlinkUnwantedFile(rn, fullpn_FileToDelete, fileToDelete);
1131 * Create all the cache files that are missing.
1133 CreateFileIfMissing(fullpn_DCacheFile, missing_DCacheFile);
1134 CreateFileIfMissing(fullpn_VolInfoFile, missing_VolInfoFile);
1135 CreateFileIfMissing(fullpn_CellInfoFile, missing_CellInfoFile);
1137 /* ADJUST CACHE FILES */
1139 /* First, let's walk through the list of files and figure out
1140 * if there are any leftover files in extra directories or
1141 * missing files. Move the former and create the latter in
1142 * subdirs with extra space.
1145 thisDir = 0; /* Keep track of which subdir has space */
1147 for (vFileNum = 0; vFileNum < cacheFiles; vFileNum++) {
1148 if (dir_for_V[vFileNum] == -1) {
1149 /* This file does not exist. Create it in the first
1150 * subdir that still has extra space.
1152 while (thisDir < maxDir
1153 && cache_dir_list[thisDir] >= nFilesPerDir)
1155 if (thisDir >= maxDir)
1156 printf("%s: can't find directory to create V%d\n", rn,
1160 #if !defined(AFS_CACHE_VNODE_PATH) && !defined(AFS_LINUX26_ENV)
1161 assert(inode_for_V[vFileNum] == (AFSD_INO_T) 0);
1163 sprintf(vFilePtr, "D%d/V%d", thisDir, vFileNum);
1165 printf("%s: Creating '%s'\n", rn, fullpn_VFile);
1166 if (cache_dir_list[thisDir] < 0
1167 && CreateCacheSubDir(directory, thisDir))
1168 printf("%s: Can't create directory for '%s'\n", rn,
1170 if (CreateCacheFile(fullpn_VFile, &statb))
1171 printf("%s: Can't create '%s'\n", rn, fullpn_VFile);
1173 #if !defined(AFS_CACHE_VNODE_PATH) && !defined(AFS_LINUX26_ENV)
1174 inode_for_V[vFileNum] = statb.st_ino;
1176 dir_for_V[vFileNum] = thisDir;
1177 cache_dir_list[thisDir]++;
1180 SetNoBackupAttr(fullpn_VFile);
1183 } else if (dir_for_V[vFileNum] >= maxDir
1184 || dir_for_V[vFileNum] == -2) {
1185 /* This file needs to move; move it to the first subdir
1186 * that has extra space. (-2 means it's in the toplevel)
1188 while (thisDir < maxDir
1189 && cache_dir_list[thisDir] >= nFilesPerDir)
1191 if (thisDir >= maxDir)
1192 printf("%s: can't find directory to move V%d\n", rn,
1196 (directory, dir_for_V[vFileNum], thisDir, vFileNum,
1198 /* Cannot move. Ignore this file??? */
1205 /* At this point, we've moved all of the valid cache files
1206 * into the valid subdirs, and created all the extra
1207 * cachefiles we need to create. Next, rebalance any subdirs
1208 * with too many cache files into the directories with not
1209 * enough cache files. Note that thisDir currently sits at
1210 * the lowest subdir that _may_ have room.
1213 for (dirNum = 0; dirNum < maxDir; dirNum++) {
1214 struct afsd_file_list *thisFile;
1216 for (thisFile = cache_dir_filelist[dirNum];
1217 thisFile && cache_dir_list[dirNum] >= nFilesPerDir;
1218 thisFile = thisFile->next) {
1219 while (thisDir < maxDir
1220 && cache_dir_list[thisDir] >= nFilesPerDir)
1222 if (thisDir >= maxDir)
1223 printf("%s: can't find directory to move V%d\n", rn,
1227 (directory, dirNum, thisDir, thisFile->fileNum,
1229 /* Cannot move. Ignore this file??? */
1233 } /* for each file to move */
1234 } /* for each directory */
1236 /* Remove any directories >= maxDir -- they should be empty */
1237 for (; highDir >= maxDir; highDir--) {
1238 sprintf(fileToDelete, "D%d", highDir);
1239 UnlinkUnwantedFile(rn, fullpn_FileToDelete, fileToDelete);
1245 * Close the directory, return success.
1248 printf("%s: Closing cache directory.\n", rn);
1254 CheckCacheBaseDir(char *dir)
1256 struct stat statbuf;
1259 return "cache base dir not specified";
1261 if (stat(dir, &statbuf) != 0) {
1262 return "unable to stat cache base directory";
1265 /* might want to check here for anything else goofy, like cache pointed at a non-dedicated directory, etc */
1267 #ifdef AFS_LINUX24_ENV
1270 struct statfs statfsbuf;
1272 res = statfs(dir, &statfsbuf);
1274 return "unable to statfs cache base directory";
1276 #if !defined(AFS_LINUX26_ENV)
1277 if (statfsbuf.f_type == 0x52654973) { /* REISERFS_SUPER_MAGIC */
1278 return "cannot use reiserfs as cache partition";
1279 } else if (statfsbuf.f_type == 0x58465342) { /* XFS_SUPER_MAGIC */
1280 return "cannot use xfs as cache partition";
1281 } else if (statfsbuf.f_type == 0x01021994) { /* TMPFS_SUPER_MAGIC */
1282 return "cannot use tmpfs as cache partition";
1283 } else if (statfsbuf.f_type != 0xEF53) {
1284 return "must use ext2 or ext3 for cache partition";
1293 struct statfs statfsbuf;
1296 res = statfs(dir, &statfsbuf);
1298 return "unable to statfs cache base directory";
1301 if (sysfs(GETFSTYP, statfsbuf.f_fsid[1], name) != 0) {
1302 return "unable to determine filesystem type for cache base dir";
1305 if (strcmp(name, "hfs")) {
1306 return "can only use hfs filesystem for cache partition on hpux";
1315 struct stat statmnt, statci;
1317 if ((stat(dir, &statci) == 0)
1318 && ((vfstab = fopen(MNTTAB, "r")) != NULL)) {
1319 while (getmntent(vfstab, &mnt) == 0) {
1320 if (strcmp(dir, mnt.mnt_mountp) != 0) {
1324 if (cp = hasmntopt(&mnt, "dev="))
1326 (int)strtol(cp + strlen("dev="), (char **)NULL,
1329 if ((rdev == 0) && (stat(mnt.mnt_mountp, &statmnt) == 0))
1330 rdev = statmnt.st_dev;
1332 if ((rdev == statci.st_dev)
1333 && (hasmntopt(&mnt, "logging") != NULL)) {
1337 "mounting a multi-use partition which contains the AFS cache with the\n\"logging\" option may deadlock your system.\n\n";
1351 SweepAFSCache(int *vFilesFound)
1353 static char rn[] = "SweepAFSCache"; /*Routine name */
1354 int maxDir = (cacheFiles + nFilesPerDir - 1) / nFilesPerDir;
1359 if (cacheFlags & AFSCALL_INIT_MEMCACHE) {
1361 printf("%s: Memory Cache, no cache sweep done\n", rn);
1365 if (cache_dir_list == NULL) {
1366 cache_dir_list = (int *)malloc(maxDir * sizeof(*cache_dir_list));
1367 if (cache_dir_list == NULL) {
1368 printf("%s: Malloc Failed!\n", rn);
1371 for (i = 0; i < maxDir; i++)
1372 cache_dir_list[i] = -1; /* Does not exist */
1375 if (cache_dir_filelist == NULL) {
1376 cache_dir_filelist = (struct afsd_file_list **)
1377 malloc(maxDir * sizeof(*cache_dir_filelist));
1378 if (cache_dir_filelist == NULL) {
1379 printf("%s: Malloc Failed!\n", rn);
1382 memset(cache_dir_filelist, 0, maxDir * sizeof(*cache_dir_filelist));
1385 if (dir_for_V == NULL) {
1386 dir_for_V = (int *)malloc(cacheFiles * sizeof(*dir_for_V));
1387 if (dir_for_V == NULL) {
1388 printf("%s: Malloc Failed!\n", rn);
1391 for (i = 0; i < cacheFiles; i++)
1392 dir_for_V[i] = -1; /* Does not exist */
1395 /* Note, setting dirNum to -2 here will cause cachefiles found in
1396 * the toplevel directory to be marked in directory "-2". This
1397 * allows us to differentiate between 'file not seen' (-1) and
1398 * 'file seen in top-level' (-2). Then when we try to move the
1399 * file into a subdirectory, we know it's in the top-level instead
1400 * of some other cache subdir.
1402 return doSweepAFSCache(vFilesFound, cacheBaseDir, -2, maxDir);
1406 ConfigCell(struct afsconf_cell *aci, void *arock, struct afsconf_dir *adir)
1410 afs_int32 cellFlags = 0;
1411 afs_int32 hosts[MAXHOSTSPERCELL];
1413 /* figure out if this is the home cell */
1414 isHomeCell = (strcmp(aci->name, LclCellName) == 0);
1416 cellFlags = 2; /* not home, suid is forbidden */
1417 if (enable_dynroot == 2)
1418 cellFlags |= 8; /* don't display foreign cells until looked up */
1420 /* build address list */
1421 for (i = 0; i < MAXHOSTSPERCELL; i++)
1422 memcpy(&hosts[i], &aci->hostAddr[i].sin_addr, sizeof(afs_int32));
1424 if (aci->linkedCell)
1425 cellFlags |= 4; /* Flag that linkedCell arg exists,
1426 * for upwards compatibility */
1428 /* configure one cell */
1429 code = afsd_call_syscall(AFSOP_ADDCELL2, hosts, /* server addresses */
1430 aci->name, /* cell name */
1431 cellFlags, /* is this the home cell? */
1432 aci->linkedCell); /* Linked cell, if any */
1434 printf("Adding cell '%s': error %d\n", aci->name, code);
1439 ConfigCellAlias(struct afsconf_cellalias *aca,
1440 void *arock, struct afsconf_dir *adir)
1442 /* push the alias into the kernel */
1443 afsd_call_syscall(AFSOP_ADDCELLALIAS, aca->aliasName, aca->realName);
1448 AfsdbLookupHandler(void)
1450 afs_int32 kernelMsg[64];
1451 char acellName[128];
1453 struct afsconf_cell acellInfo;
1458 acellName[0] = '\0';
1460 #ifdef AFS_DARWIN_ENV
1461 /* Fork the event handler also. */
1464 afsd_install_events();
1466 } else if (code != -1) {
1471 /* On some platforms you only get 4 args to an AFS call */
1472 int sizeArg = ((sizeof acellName) << 16) | (sizeof kernelMsg);
1474 afsd_call_syscall(AFSOP_AFSDB_HANDLER, acellName, kernelMsg, sizeArg);
1475 if (code) { /* Something is wrong? */
1480 if (*acellName == 1) /* Shutting down */
1483 code = afsconf_GetAfsdbInfo(acellName, 0, &acellInfo);
1488 kernelMsg[0] = acellInfo.numServers;
1489 if (acellInfo.timeout)
1490 kernelMsg[1] = acellInfo.timeout - time(0);
1493 for (i = 0; i < acellInfo.numServers; i++)
1494 kernelMsg[i + 2] = acellInfo.hostAddr[i].sin_addr.s_addr;
1495 strncpy(acellName, acellInfo.name, sizeof(acellName));
1496 acellName[sizeof(acellName) - 1] = '\0';
1499 #ifdef AFS_DARWIN_ENV
1500 kill(event_pid, SIGTERM);
1504 #ifdef AFS_DARWIN_ENV
1509 struct afs_uspc_param *uspc;
1513 uspc = (struct afs_uspc_param *)malloc(sizeof(struct afs_uspc_param));
1514 memset(uspc, 0, sizeof(struct afs_uspc_param));
1515 memset(srcName, 0, sizeof(srcName));
1516 memset(dstName, 0, sizeof(dstName));
1518 /* brscount starts at 0 */
1524 char srcpath[BUFSIZ];
1525 char dstpath[BUFSIZ];
1527 /* pushing in a buffer this large */
1530 code = afsd_call_syscall(AFSOP_BKG_HANDLER, uspc, srcName, dstName);
1531 if (code) { /* Something is wrong? */
1532 if (code == -2) /* shutting down */
1540 switch (uspc->reqtype) {
1542 snprintf(srcpath, BUFSIZ, "/afs/.:mount/%d:%d:%d:%d/%s",
1543 uspc->req.umv.sCell, uspc->req.umv.sVolume,
1544 uspc->req.umv.sVnode, uspc->req.umv.sUnique, srcName);
1545 snprintf(dstpath, BUFSIZ, "/afs/.:mount/%d:%d:%d:%d/%s",
1546 uspc->req.umv.dCell, uspc->req.umv.dVolume,
1547 uspc->req.umv.dVnode, uspc->req.umv.dUnique, dstName);
1548 if ((child = fork()) == 0) {
1549 /* first child does cp; second, rm. mv would re-enter. */
1551 switch (uspc->req.umv.idtype) {
1553 if (setuid(uspc->req.umv.id) != 0) {
1559 break; /* notreached */
1561 execl("/bin/cp", "(afsd EXDEV helper)", "-PRp", "--", srcpath,
1562 dstpath, (char *) NULL);
1564 if (child == (pid_t) -1) {
1569 if (waitpid(child, &status, 0) == -1)
1571 else if (WIFEXITED(status) != 0 && WEXITSTATUS(status) == 0) {
1572 if ((child = fork()) == 0) {
1573 switch (uspc->req.umv.idtype) {
1575 if (setuid(uspc->req.umv.id) != 0) {
1581 break; /* notreached */
1583 execl("/bin/rm", "(afsd EXDEV helper)", "-rf", "--",
1584 srcpath, (char *) NULL);
1586 if (child == (pid_t) -1) {
1590 if (waitpid(child, &status, 0) == -1)
1592 else if (WIFEXITED(status) != 0) {
1593 /* rm exit status */
1594 uspc->retval = WEXITSTATUS(status);
1596 /* rm signal status */
1597 uspc->retval = -(WTERMSIG(status));
1600 /* error from cp: exit or signal status */
1601 uspc->retval = (WIFEXITED(status) != 0) ?
1602 WEXITSTATUS(status) : -(WTERMSIG(status));
1604 memset(srcName, 0, sizeof(srcName));
1605 memset(dstName, 0, sizeof(dstName));
1609 /* unknown req type */
1618 afsdb_thread(void *rock)
1620 /* Since the AFSDB lookup handler runs as a user process,
1621 * need to drop the controlling TTY, etc.
1623 if (afsd_daemon(0, 0) == -1) {
1624 printf("Error starting AFSDB lookup handler: %s\n",
1628 AfsdbLookupHandler();
1633 daemon_thread(void *rock)
1635 #ifdef AFS_DARWIN80_ENV
1636 /* Since the background daemon runs as a user process,
1637 * need to drop the controlling TTY, etc.
1639 if (afsd_daemon(0, 0) == -1) {
1640 printf("Error starting background daemon: %s\n",
1645 #elif defined(AFS_AIX32_ENV)
1646 afsd_call_syscall(AFSOP_START_BKG, 0);
1648 afsd_call_syscall(AFSOP_START_BKG);
1655 rmtsysd_thread(void *rock)
1660 #endif /* !UKERNEL */
1663 mainproc(struct cmd_syndesc *as, void *arock)
1665 afs_int32 code; /*Result of fork() */
1669 #ifdef AFS_SGI65_ENV
1670 struct sched_param sp;
1673 #ifdef AFS_SGI_VNODE_GLUE
1674 if (afs_init_kernel_config(-1) < 0) {
1675 printf("Can't determine NUMA configuration, not starting AFS.\n");
1680 /* call atoi on the appropriate parsed results */
1681 if (as->parms[0].items) {
1683 cacheBlocks = atoi(as->parms[0].items->data);
1686 if (as->parms[1].items) {
1688 cacheFiles = atoi(as->parms[1].items->data);
1689 filesSet = 1; /* set when spec'd on cmd line */
1691 if (as->parms[2].items) {
1693 strcpy(rootVolume, as->parms[2].items->data);
1696 if (as->parms[3].items) {
1698 cacheStatEntries = atoi(as->parms[3].items->data);
1699 sawCacheStatEntries = 1;
1701 if (as->parms[4].items) {
1703 cacheBaseDir[0] = '\0';
1704 sawCacheBaseDir = 1;
1705 cacheFlags |= AFSCALL_INIT_MEMCACHE;
1707 if (as->parms[5].items) {
1709 strcpy(cacheBaseDir, as->parms[5].items->data);
1710 sawCacheBaseDir = 1;
1712 if (as->parms[6].items) {
1714 strcpy(afsd_cacheMountDir, as->parms[6].items->data);
1715 sawCacheMountDir = 1;
1717 if (as->parms[7].items) {
1719 nDaemons = atoi(as->parms[7].items->data);
1721 if (as->parms[8].items) {
1725 if (as->parms[9].items) {
1729 if (as->parms[10].items) {
1733 printf("-rmtsys not supported for UKERNEL\n");
1737 if (as->parms[11].items) {
1742 if (as->parms[12].items) {
1744 chunkSize = atoi(as->parms[12].items->data);
1745 if (chunkSize < 0 || chunkSize > 30) {
1747 ("afsd:invalid chunk size (not in range 0-30), using default\n");
1751 if (as->parms[13].items) {
1753 dCacheSize = atoi(as->parms[13].items->data);
1756 if (as->parms[14].items) {
1758 vCacheSize = atoi(as->parms[14].items->data);
1760 if (as->parms[15].items) {
1762 #ifndef AFS_AIX32_ENV
1764 ("afsd: [-biods] currently only enabled for aix3.x VM supported systems\n");
1766 nBiods = atoi(as->parms[15].items->data);
1770 if (as->parms[16].items) {
1772 preallocs = atoi(as->parms[16].items->data);
1774 strcpy(confDir, AFSDIR_CLIENT_ETC_DIRPATH);
1775 if (as->parms[17].items) {
1777 strcpy(confDir, as->parms[17].items->data);
1779 sprintf(fullpn_CacheInfo, "%s/%s", confDir, CACHEINFOFILE);
1780 if (as->parms[18].items) {
1782 printf("afsd: Ignoring obsolete -logfile flag\n");
1784 if (as->parms[19].items) {
1786 afsd_CloseSynch = 1;
1788 if (as->parms[20].items) {
1792 * Cold shutdown is the default
1794 printf("afsd: Shutting down all afs processes and afs state\n");
1795 code = afsd_call_syscall(AFSOP_SHUTDOWN, 1);
1797 printf("afsd: AFS still mounted; Not shutting down\n");
1802 if (as->parms[21].items) {
1803 /* -enable_peer_stats */
1804 enable_peer_stats = 1;
1806 if (as->parms[22].items) {
1807 /* -enable_process_stats */
1808 enable_process_stats = 1;
1810 if (as->parms[23].items) {
1811 /* -mem_alloc_sleep */
1812 printf("afsd: -mem_alloc_sleep is deprecated -- ignored\n");
1814 if (as->parms[24].items) {
1818 if (as->parms[25].items) {
1819 /* -files_per_subdir */
1820 int res = atoi(as->parms[25].items->data);
1821 if (res < 10 || res > (1 << 30)) {
1823 ("afsd:invalid number of files per subdir, \"%s\". Ignored\n",
1824 as->parms[25].items->data);
1829 if (as->parms[26].items) {
1833 if (as->parms[27].items) {
1835 enable_fakestat = 2;
1837 if (as->parms[28].items) {
1839 enable_fakestat = 1;
1841 if (as->parms[29].items) {
1845 if (as->parms[30].items) {
1847 enable_backuptree = 1;
1849 if (as->parms[31].items) {
1853 if (as->parms[32].items) {
1858 /* set rx_extraPackets */
1859 if (as->parms[33].items) {
1861 int rxpck = atoi(as->parms[33].items->data);
1862 printf("afsd: set rxpck = %d\n", rxpck);
1863 code = afsd_call_syscall(AFSOP_SET_RXPCK, rxpck);
1865 printf("afsd: failed to set rxpck\n");
1869 if (as->parms[34].items) {
1871 if (!as->parms[34].items->data ||
1872 ((c = strchr(as->parms[34].items->data, '/')) == NULL))
1874 ("ignoring splitcache (specify as RW/RO percentages: 60/40)\n");
1876 ropct = atoi((char *)c + 1);
1878 rwpct = atoi((char *)as->parms[30].items->data);
1879 if ((rwpct != 0) && (ropct != 0) && (ropct + rwpct == 100)) {
1881 enable_splitcache = 1;
1885 if (as->parms[35].items) {
1886 #ifdef AFS_MAXVCOUNT_ENV
1887 /* -disable-dynamic-vcaches */
1888 afsd_dynamic_vcaches = 0;
1890 printf("afsd: Error toggling flag, dynamically allocated vcaches not supported on your platform\n");
1894 #ifdef AFS_MAXVCOUNT_ENV
1896 /* -dynamic-vcaches */
1897 afsd_dynamic_vcaches = 1;
1901 printf("afsd: %s dynamically allocated vcaches\n", ( afsd_dynamic_vcaches ? "enabling" : "disabling" ));
1905 if (as->parms[36].items) {
1907 rxmaxmtu = atoi(as->parms[36].items->data);
1909 if (as->parms[37].items) {
1910 /* -dynroot-sparse */
1919 static char rn[] = "afsd"; /*Name of this routine */
1920 struct afsconf_dir *cdir; /* config dir */
1921 struct stat statbuf;
1922 int lookupResult; /*Result of GetLocalCellName() */
1924 afs_int32 code; /*Result of fork() */
1925 char *fsTypeMsg = NULL;
1926 int cacheIteration; /*How many times through cache verification */
1927 int vFilesFound; /*How many data cache files were found in sweep */
1928 int currVFile; /*Current AFS cache file number passed in */
1931 * Pull out all the configuration info for the workstation's AFS cache and
1932 * the cellular community we're willing to let our users see.
1934 cdir = afsconf_Open(confDir);
1936 printf("afsd: some file missing or bad in %s\n", confDir);
1941 afsconf_GetLocalCell(cdir, LclCellName, sizeof(LclCellName));
1943 printf("%s: Can't get my home cell name! [Error is %d]\n", rn,
1947 printf("%s: My home cell is '%s'\n", rn, LclCellName);
1950 /* parse cacheinfo file if this is a diskcache */
1951 if (ParseCacheInfoFile()) {
1955 if (stat(afsd_cacheMountDir, &statbuf)) {
1956 printf("afsd: Mountpoint %s missing.\n", afsd_cacheMountDir);
1959 if (!S_ISDIR(statbuf.st_mode)) {
1960 printf("afsd: Mountpoint %s is not a directory.\n", afsd_cacheMountDir);
1965 /* do some random computations in memcache case to get things to work
1966 * reasonably no matter which parameters you set.
1968 if (cacheFlags & AFSCALL_INIT_MEMCACHE) {
1969 /* memory cache: size described either as blocks or dcache entries, but
1973 fprintf(stderr, "%s: -files ignored with -memcache\n", rn);
1975 if (sawDCacheSize) {
1976 if (chunkSize == 0) {
1977 chunkSize = 13; /* 8k default chunksize for memcache */
1979 if (sawCacheBlocks) {
1981 ("%s: can't set cache blocks and dcache size simultaneously when diskless.\n",
1985 /* compute the cache size based on # of chunks times the chunk size */
1986 i = (1 << chunkSize); /* bytes per chunk */
1987 cacheBlocks = i * dCacheSize;
1988 sawCacheBlocks = 1; /* so that ParseCacheInfoFile doesn't overwrite */
1990 if (chunkSize == 0) {
1991 /* Try to autotune the memcache chunksize based on size
1992 * of memcache. This is done on the assumption that approx
1993 * 1024 chunks is suitable, it's a balance between enough
1994 * chunks to be useful and ramping up nicely when using larger
1995 * memcache to improve bulk read/write performance
1998 i <= 21 && (1 << i) / 1024 < (cacheBlocks / 1024); i++);
2001 /* compute the dcache size from overall cache size and chunk size */
2002 if (chunkSize > 10) {
2003 dCacheSize = (cacheBlocks >> (chunkSize - 10));
2004 } else if (chunkSize < 10) {
2005 dCacheSize = (cacheBlocks << (10 - chunkSize));
2007 dCacheSize = cacheBlocks;
2009 /* don't have to set sawDCacheSize here since it isn't overwritten
2010 * by ParseCacheInfoFile.
2014 printf("%s: chunkSize autotuned to %d\n", rn, chunkSize);
2016 /* kernel computes # of dcache entries as min of cacheFiles and
2017 * dCacheSize, so we now make them equal.
2019 cacheFiles = dCacheSize;
2022 * Compute the number of cache files based on cache size,
2023 * but only if -files isn't given on the command line.
2024 * Don't let # files be so small as to prevent full utilization
2025 * of the cache unless user has explicitly asked for it.
2027 if (chunkSize == 0) {
2028 /* Set chunksize to 256kB - 1MB depending on cache size */
2029 if (cacheBlocks < 500000) {
2031 } else if (cacheBlocks < 1000000) {
2038 cacheFiles = cacheBlocks / 32; /* Assume 32k avg filesize */
2040 cacheFiles = max(cacheFiles, 1000);
2042 /* Always allow more files than chunks. Presume average V-file
2043 * is ~67% of a chunk... (another guess, perhaps Honeyman will
2044 * have a grad student write a paper). i is KILOBYTES.
2046 i = 1 << (chunkSize < 10 ? 0 : chunkSize - 10);
2047 cacheFiles = max(cacheFiles, 1.5 * (cacheBlocks / i));
2049 /* never permit more files than blocks, while leaving space for
2050 * VolumeInfo and CacheItems files. VolumeInfo is usually 20K,
2051 * CacheItems is 50 Bytes / file (== 1K/20)
2053 #define CACHEITMSZ (cacheFiles / 20)
2054 #define VOLINFOSZ 50 /* 40kB has been seen, be conservative */
2055 #define CELLINFOSZ 4 /* Assuming disk block size is 4k ... */
2056 #define INFOSZ (VOLINFOSZ+CELLINFOSZ+CACHEITMSZ)
2058 /* Sanity check: If the obtained number of disk cache files
2059 * is larger than the number of available (4k) disk blocks, we're
2060 * doing something wrong. Fail hard so we can fix the bug instead
2061 * of silently hiding it like before */
2063 if (cacheFiles > (cacheBlocks - INFOSZ) / 4) {
2065 "%s: ASSERT: cacheFiles %d diskblocks %d\n",
2066 rn, cacheFiles, (cacheBlocks - INFOSZ) / 4);
2069 if (cacheFiles < 100)
2070 fprintf(stderr, "%s: WARNING: cache probably too small!\n",
2074 printf("%s: cacheFiles autotuned to %d\n", rn, cacheFiles);
2077 /* This actually needs to
2079 2) not second-guess when a chunksize comes from the command line
2080 3) be less, um, small. 2^2??
2082 /* Sanity check chunkSize */
2083 i = max(cacheBlocks / 1000, cacheBlocks / cacheFiles);
2084 chunkSize = min(chunkSize, i);
2085 chunkSize = max(chunkSize, 2);
2087 printf("%s: chunkSize autotuned to %d\n", rn, chunkSize);
2090 if (!sawDCacheSize) {
2091 dCacheSize = cacheFiles / 2;
2092 if (dCacheSize > 10000) {
2095 if (dCacheSize < 2000) {
2099 printf("%s: dCacheSize autotuned to %d\n", rn, dCacheSize);
2102 if (!sawCacheStatEntries) {
2103 if (chunkSize <= 13) {
2104 cacheStatEntries = dCacheSize / 4;
2105 } else if (chunkSize >= 16) {
2106 cacheStatEntries = dCacheSize * 1.5;
2108 cacheStatEntries = dCacheSize;
2111 printf("%s: cacheStatEntries autotuned to %d\n", rn,
2115 #if !defined(AFS_CACHE_VNODE_PATH) && !defined(AFS_LINUX26_ENV)
2117 * Create and zero the inode table for the desired cache files.
2119 inode_for_V = (AFSD_INO_T *) malloc(cacheFiles * sizeof(AFSD_INO_T));
2120 if (inode_for_V == (AFSD_INO_T *) 0) {
2122 ("%s: malloc() failed for cache file inode table with %d entries.\n",
2126 memset(inode_for_V, '\0', (cacheFiles * sizeof(AFSD_INO_T)));
2128 printf("%s: %d inode_for_V entries at 0x%x, %lu bytes\n", rn,
2129 cacheFiles, inode_for_V, (cacheFiles * sizeof(AFSD_INO_T)));
2133 * Set up all the pathnames we'll need for later.
2135 sprintf(fullpn_DCacheFile, "%s/%s", cacheBaseDir, DCACHEFILE);
2136 sprintf(fullpn_VolInfoFile, "%s/%s", cacheBaseDir, VOLINFOFILE);
2137 sprintf(fullpn_CellInfoFile, "%s/%s", cacheBaseDir, CELLINFOFILE);
2138 sprintf(fullpn_VFile, "%s/", cacheBaseDir);
2139 vFilePtr = fullpn_VFile + strlen(fullpn_VFile);
2141 if (!(cacheFlags & AFSCALL_INIT_MEMCACHE)
2142 && (fsTypeMsg = CheckCacheBaseDir(cacheBaseDir))) {
2144 printf("%s: WARNING: Cache dir check failed (%s)\n", rn, fsTypeMsg);
2146 printf("%s: ERROR: Cache dir check failed (%s)\n", rn, fsTypeMsg);
2152 * Set up all the kernel processes needed for AFS.
2155 setpgrp(getpid(), 0);
2159 * Set the primary cell name.
2161 afsd_call_syscall(AFSOP_SET_THISCELL, LclCellName);
2163 /* Initialize RX daemons and services */
2165 /* initialize the rx random number generator from user space */
2167 /* parse multihomed address files */
2168 afs_uint32 addrbuf[MAXIPADDRS], maskbuf[MAXIPADDRS],
2172 parseNetFiles(addrbuf, maskbuf, mtubuf, MAXIPADDRS, reason,
2173 AFSDIR_CLIENT_NETINFO_FILEPATH,
2174 AFSDIR_CLIENT_NETRESTRICT_FILEPATH);
2177 code = code | 0x80000000;
2178 afsd_call_syscall(AFSOP_ADVISEADDR, code, addrbuf, maskbuf, mtubuf);
2180 printf("ADVISEADDR: Error in specifying interface addresses:%s\n",
2184 /* Set realtime priority for most threads to same as for biod's. */
2185 afsd_set_afsd_rtpri();
2187 #ifdef AFS_SGI53_ENV
2188 #ifdef AFS_SGI61_ENV
2190 #else /* AFS_SGI61_ENV */
2191 code = get_nfsstaticaddr();
2193 afsd_call_syscall(AFSOP_NFSSTATICADDR, code);
2194 #endif /* AFS_SGI61_ENV */
2195 #endif /* AFS_SGI_53_ENV */
2197 /* Start listener, then callback listener. Lastly, start rx event daemon.
2198 * Change in ordering is so that Linux port has socket fd in listener
2200 * preallocs are passed for both listener and callback server. Only
2201 * the one which actually does the initialization uses them though.
2203 if (preallocs < cacheStatEntries + 50)
2204 preallocs = cacheStatEntries + 50;
2205 #ifdef RXK_LISTENER_ENV
2207 printf("%s: Forking rx listener daemon.\n", rn);
2208 # ifdef AFS_SUN510_ENV
2209 fork_rx_syscall_wait(rn, AFSOP_RXLISTENER_DAEMON, preallocs,
2210 enable_peer_stats, enable_process_stats);
2211 # else /* !AFS_SUN510_ENV */
2212 fork_rx_syscall(rn, AFSOP_RXLISTENER_DAEMON, preallocs, enable_peer_stats,
2213 enable_process_stats);
2214 # endif /* !AFS_SUN510_ENV */
2217 printf("%s: Forking rx callback listener.\n", rn);
2218 fork_syscall(rn, AFSOP_START_RXCALLBACK, preallocs);
2219 #if defined(AFS_SUN5_ENV) || defined(RXK_LISTENER_ENV)
2221 printf("%s: Forking rxevent daemon.\n", rn);
2222 fork_rx_syscall(rn, AFSOP_RXEVENT_DAEMON);
2227 printf("%s: Forking AFSDB lookup handler.\n", rn);
2228 afsd_fork(0, afsdb_thread, NULL);
2230 code = afsd_call_syscall(AFSOP_BASIC_INIT, 1);
2232 printf("%s: Error %d in basic initialization.\n", rn, code);
2237 * Tell the kernel some basic information about the workstation's cache.
2241 ("%s: Calling AFSOP_CACHEINIT: %d stat cache entries, %d optimum cache files, %d blocks in the cache, flags = 0x%x, dcache entries %d\n",
2242 rn, cacheStatEntries, cacheFiles, cacheBlocks, cacheFlags,
2244 memset(&cparams, '\0', sizeof(cparams));
2245 cparams.cacheScaches = cacheStatEntries;
2246 cparams.cacheFiles = cacheFiles;
2247 cparams.cacheBlocks = cacheBlocks;
2248 cparams.cacheDcaches = dCacheSize;
2249 cparams.cacheVolumes = vCacheSize;
2250 cparams.chunkSize = chunkSize;
2251 cparams.setTimeFlag = cacheSetTime;
2252 cparams.memCacheFlag = cacheFlags;
2253 cparams.dynamic_vcaches = afsd_dynamic_vcaches;
2254 afsd_call_syscall(AFSOP_CACHEINIT, &cparams);
2256 /* do it before we init the cache inodes */
2257 if (enable_splitcache) {
2258 afsd_call_syscall(AFSOP_BUCKETPCT, 1, rwpct);
2259 afsd_call_syscall(AFSOP_BUCKETPCT, 2, ropct);
2262 if (afsd_CloseSynch)
2263 afsd_call_syscall(AFSOP_CLOSEWAIT);
2266 * Sweep the workstation AFS cache directory, remembering the inodes of
2267 * valid files and deleting extraneous files. Keep sweeping until we
2268 * have the right number of data cache files or we've swept too many
2271 * This also creates files in the cache directory like VolumeItems and
2272 * CellItems, and thus must be ran before those are sent to the kernel.
2275 printf("%s: Sweeping workstation's AFS cache directory.\n", rn);
2277 /* Memory-cache based system doesn't need any of this */
2278 if (!(cacheFlags & AFSCALL_INIT_MEMCACHE)) {
2281 if (SweepAFSCache(&vFilesFound)) {
2282 printf("%s: Error on sweep %d of workstation AFS cache \
2283 directory.\n", rn, cacheIteration);
2288 ("%s: %d out of %d data cache files found in sweep %d.\n",
2289 rn, vFilesFound, cacheFiles, cacheIteration);
2290 } while ((vFilesFound < cacheFiles)
2291 && (cacheIteration < MAX_CACHE_LOOPS));
2292 } else if (afsd_verbose)
2293 printf("%s: Using memory cache, not swept\n", rn);
2296 * Pass the kernel the name of the workstation cache file holding the
2300 printf("%s: Calling AFSOP_CACHEINFO: dcache file is '%s'\n", rn,
2302 /* once again, meaningless for a memory-based cache. */
2303 if (!(cacheFlags & AFSCALL_INIT_MEMCACHE))
2304 afsd_call_syscall(AFSOP_CACHEINFO, fullpn_DCacheFile);
2307 * Pass the kernel the name of the workstation cache file holding the
2311 printf("%s: Calling AFSOP_CELLINFO: cell info file is '%s'\n", rn,
2312 fullpn_CellInfoFile);
2313 afsd_call_syscall(AFSOP_CELLINFO, fullpn_CellInfoFile);
2317 printf("%s: Setting rxmaxmtu in kernel = %d\n", rn, rxmaxmtu);
2318 code = afsd_call_syscall(AFSOP_SET_RXMAXMTU, rxmaxmtu);
2320 printf("%s: Error seting rxmaxmtu\n", rn);
2323 if (enable_dynroot) {
2325 printf("%s: Enabling dynroot support in kernel%s.\n", rn,
2326 (enable_dynroot==2)?", not showing cells.":"");
2327 code = afsd_call_syscall(AFSOP_SET_DYNROOT, 1);
2329 printf("%s: Error enabling dynroot support.\n", rn);
2332 if (enable_fakestat) {
2334 printf("%s: Enabling fakestat support in kernel%s.\n", rn,
2335 (enable_fakestat==2)?" for all mountpoints."
2336 :" for crosscell mountpoints");
2337 code = afsd_call_syscall(AFSOP_SET_FAKESTAT, enable_fakestat);
2339 printf("%s: Error enabling fakestat support.\n", rn);
2342 if (enable_backuptree) {
2344 printf("%s: Enabling backup tree support in kernel.\n", rn);
2345 code = afsd_call_syscall(AFSOP_SET_BACKUPTREE, enable_backuptree);
2347 printf("%s: Error enabling backup tree support.\n", rn);
2351 * Tell the kernel about each cell in the configuration.
2353 afsconf_CellApply(cdir, ConfigCell, NULL);
2354 afsconf_CellAliasApply(cdir, ConfigCellAlias, NULL);
2356 /* Initialize AFS daemon threads. */
2358 printf("%s: Forking AFS daemon.\n", rn);
2359 fork_syscall(rn, AFSOP_START_AFS);
2362 printf("%s: Forking Check Server Daemon.\n", rn);
2363 fork_syscall(rn, AFSOP_START_CS);
2366 printf("%s: Forking %d background daemons.\n", rn, nDaemons);
2367 #if defined(AFS_SGI_ENV) && defined(AFS_SGI_SHORTSTACK)
2368 /* Add one because for sgi we always "steal" the first daemon for a
2369 * different task if we only have a 4K stack.
2373 for (i = 0; i < nDaemons; i++) {
2374 afsd_fork(0, daemon_thread, NULL);
2376 #ifdef AFS_AIX32_ENV
2378 nBiods = nDaemons * 2;
2381 for (i = 0; i < nBiods; i++) {
2382 fork_syscall(rn, AFSOP_START_BKG, nBiods);
2387 * If the root volume has been explicitly set, tell the kernel.
2391 printf("%s: Calling AFSOP_ROOTVOLUME with '%s'\n", rn,
2393 afsd_call_syscall(AFSOP_ROOTVOLUME, rootVolume);
2397 * Pass the kernel the name of the workstation cache file holding the
2398 * volume information.
2401 printf("%s: Calling AFSOP_VOLUMEINFO: volume info file is '%s'\n", rn,
2402 fullpn_VolInfoFile);
2403 /* once again, meaningless for a memory-based cache. */
2404 if (!(cacheFlags & AFSCALL_INIT_MEMCACHE))
2405 afsd_call_syscall(AFSOP_VOLUMEINFO, fullpn_VolInfoFile);
2408 * Give the kernel the names of the AFS files cached on the workstation's
2413 ("%s: Calling AFSOP_CACHEFILE for each of the %d files in '%s'\n",
2414 rn, cacheFiles, cacheBaseDir);
2415 if (!(cacheFlags & AFSCALL_INIT_MEMCACHE)) {
2416 /* ... and again ... */
2417 int nocachefile = 0;
2418 for (currVFile = 0; currVFile < cacheFiles; currVFile++) {
2420 sprintf(fullpn_VFile, "%s/D%d/V%d", cacheBaseDir, dir_for_V[currVFile], currVFile);
2421 code = afsd_call_syscall(AFSOP_CACHEFILE, fullpn_VFile);
2423 if (currVFile == 0) {
2426 ("%s: Calling AFSOP_CACHEINODE for each of the %d files in '%s'\n",
2427 rn, cacheFiles, cacheBaseDir);
2431 ("%s: Error calling AFSOP_CACHEFILE for '%s'\n",
2438 /* fall through to setup-by-inode */
2440 #ifdef AFS_SGI62_ENV
2441 afsd_call_syscall(AFSOP_CACHEINODE,
2442 (afs_uint32) (inode_for_V[currVFile] >> 32),
2443 (afs_uint32) (inode_for_V[currVFile] & 0xffffffff));
2444 #elif !(defined(AFS_LINUX26_ENV) || defined(AFS_CACHE_VNODE_PATH))
2445 afsd_call_syscall(AFSOP_CACHEINODE, inode_for_V[currVFile]);
2448 ("%s: Error calling AFSOP_CACHEINODE: not configured\n",
2456 * All the necessary info has been passed into the kernel to run an AFS
2457 * system. Give the kernel our go-ahead.
2460 printf("%s: Calling AFSOP_GO with cacheSetTime = %d\n", rn,
2462 afsd_call_syscall(AFSOP_GO, cacheSetTime);
2465 * At this point, we have finished passing the kernel all the info
2466 * it needs to set up the AFS. Mount the AFS root.
2468 printf("%s: All AFS daemons started.\n", rn);
2471 printf("%s: Forking trunc-cache daemon.\n", rn);
2472 fork_syscall(rn, AFSOP_START_TRUNCDAEMON);
2474 if (!enable_nomount) {
2475 afsd_mount_afs(rn, afsd_cacheMountDir);
2481 printf("%s: Forking 'rmtsys' daemon.\n", rn);
2482 afsd_fork(0, rmtsysd_thread, NULL);
2484 #endif /* !UKERNEL */
2486 * Exit successfully.
2491 #include "AFS_component_version_number.c"
2496 struct cmd_syndesc *ts;
2498 ts = cmd_CreateSyntax(NULL, mainproc, NULL, "start AFS");
2501 cmd_AddParm(ts, "-blocks", CMD_SINGLE, CMD_OPTIONAL,
2502 "1024 byte blocks in cache");
2503 cmd_AddParm(ts, "-files", CMD_SINGLE, CMD_OPTIONAL, "files in cache");
2504 cmd_AddParm(ts, "-rootvol", CMD_SINGLE, CMD_OPTIONAL,
2505 "name of AFS root volume");
2506 cmd_AddParm(ts, "-stat", CMD_SINGLE, CMD_OPTIONAL,
2507 "number of stat entries");
2508 cmd_AddParm(ts, "-memcache", CMD_FLAG, CMD_OPTIONAL, "run diskless");
2509 cmd_AddParm(ts, "-cachedir", CMD_SINGLE, CMD_OPTIONAL, "cache directory");
2510 cmd_AddParm(ts, "-mountdir", CMD_SINGLE, CMD_OPTIONAL, "mount location");
2511 cmd_AddParm(ts, "-daemons", CMD_SINGLE, CMD_OPTIONAL,
2512 "number of daemons to use");
2513 cmd_AddParm(ts, "-nosettime", CMD_FLAG, CMD_OPTIONAL,
2514 "don't set the time");
2515 cmd_AddParm(ts, "-verbose", CMD_FLAG, CMD_OPTIONAL,
2516 "display lots of information");
2517 cmd_AddParm(ts, "-rmtsys", CMD_FLAG, CMD_OPTIONAL,
2518 "start NFS rmtsysd program");
2521 cmd_AddParm(ts, "-debug", CMD_FLAG, CMD_OPTIONAL, "display debug info");
2522 cmd_AddParm(ts, "-chunksize", CMD_SINGLE, CMD_OPTIONAL,
2523 "log(2) of chunk size");
2524 cmd_AddParm(ts, "-dcache", CMD_SINGLE, CMD_OPTIONAL,
2525 "number of dcache entries");
2526 cmd_AddParm(ts, "-volumes", CMD_SINGLE, CMD_OPTIONAL,
2527 "number of volume entries");
2528 cmd_AddParm(ts, "-biods", CMD_SINGLE, CMD_OPTIONAL,
2529 "number of bkg I/O daemons (aix vm)");
2530 cmd_AddParm(ts, "-prealloc", CMD_SINGLE, CMD_OPTIONAL,
2531 "number of 'small' preallocated blocks");
2532 cmd_AddParm(ts, "-confdir", CMD_SINGLE, CMD_OPTIONAL,
2533 "configuration directory");
2534 cmd_AddParm(ts, "-logfile", CMD_SINGLE, CMD_OPTIONAL,
2535 "Place to keep the CM log");
2536 cmd_AddParm(ts, "-waitclose", CMD_FLAG, CMD_OPTIONAL,
2537 "make close calls synchronous");
2538 cmd_AddParm(ts, "-shutdown", CMD_FLAG, CMD_OPTIONAL,
2539 "Shutdown all afs state");
2541 cmd_AddParm(ts, "-enable_peer_stats", CMD_FLAG, CMD_OPTIONAL | CMD_HIDE,
2542 "Collect rpc statistics by peer");
2543 cmd_AddParm(ts, "-enable_process_stats", CMD_FLAG,
2544 CMD_OPTIONAL | CMD_HIDE,
2545 "Collect rpc statistics for this process");
2546 cmd_AddParm(ts, "-mem_alloc_sleep", CMD_FLAG, (CMD_OPTIONAL | CMD_HIDE),
2547 "Allow sleeps when allocating memory cache");
2548 cmd_AddParm(ts, "-afsdb", CMD_FLAG, (CMD_OPTIONAL),
2549 "Enable AFSDB support");
2550 cmd_AddParm(ts, "-files_per_subdir", CMD_SINGLE, CMD_OPTIONAL,
2551 "log(2) of the number of cache files per cache subdirectory");
2552 cmd_AddParm(ts, "-dynroot", CMD_FLAG, CMD_OPTIONAL,
2553 "Enable dynroot support");
2554 cmd_AddParm(ts, "-fakestat", CMD_FLAG, CMD_OPTIONAL,
2555 "Enable fakestat support for cross-cell mounts");
2556 cmd_AddParm(ts, "-fakestat-all", CMD_FLAG, CMD_OPTIONAL,
2557 "Enable fakestat support for all mounts");
2558 cmd_AddParm(ts, "-nomount", CMD_FLAG, CMD_OPTIONAL, "Do not mount AFS");
2559 cmd_AddParm(ts, "-backuptree", CMD_FLAG, CMD_OPTIONAL,
2560 "Prefer backup volumes for mointpoints in backup volumes");
2562 cmd_AddParm(ts, "-rxbind", CMD_FLAG, CMD_OPTIONAL,
2563 "Bind the Rx socket (one interface only)");
2564 cmd_AddParm(ts, "-settime", CMD_FLAG, CMD_OPTIONAL, "set the time");
2565 cmd_AddParm(ts, "-rxpck", CMD_SINGLE, CMD_OPTIONAL,
2566 "set rx_extraPackets to this value");
2567 cmd_AddParm(ts, "-splitcache", CMD_SINGLE, CMD_OPTIONAL,
2568 "Percentage RW versus RO in cache (specify as 60/40)");
2569 cmd_AddParm(ts, "-disable-dynamic-vcaches", CMD_FLAG, CMD_OPTIONAL,
2570 "disable stat/vcache cache growing as needed");
2571 cmd_AddParm(ts, "-rxmaxmtu", CMD_SINGLE, CMD_OPTIONAL, "set rx max MTU to use");
2572 cmd_AddParm(ts, "-dynroot-sparse", CMD_FLAG, CMD_OPTIONAL,
2573 "Enable dynroot support with minimal cell list");
2577 afsd_parse(int argc, char **argv)
2579 return cmd_Dispatch(argc, argv);
2582 #ifdef AFS_SGI53_ENV
2583 #ifdef AFS_SGI61_ENV
2584 /* The dwarf structures are searched to find entry points of static functions
2585 * and the addresses of static variables. The file name as well as the
2586 * sybmol name is reaquired.
2589 /* Contains list of names to find in given file. */
2591 char *name; /* Name of variable or function. */
2592 afs_hyper_t addr; /* Address of function, undefined if not found. */
2593 Dwarf_Half type; /* DW_AT_location for vars, DW_AT_lowpc for func's */
2594 char found; /* set if found. */
2598 char *file; /* Name of file containing vars or funcs */
2599 staticAddrList *addrList; /* List of vars and/or funcs. */
2600 int nAddrs; /* # of addrList's */
2601 int found; /* set if we've found this file already. */
2604 /* routines used to find addresses in /unix */
2605 #if defined(AFS_SGI62_ENV) && !defined(AFS_SGI65_ENV)
2606 void findMDebugStaticAddresses(staticNameList *, int, int);
2608 void findDwarfStaticAddresses(staticNameList *, int);
2609 void findElfAddresses(Dwarf_Debug, Dwarf_Die, staticNameList *);
2610 void getElfAddress(Dwarf_Debug, Dwarf_Die, staticAddrList *);
2612 #if defined(AFS_SGI62_ENV) && !defined(AFS_SGI65_ENV)
2613 #define AFS_N_FILELISTS 2
2614 #define AFS_SYMS_NEEDED 3
2615 #else /* AFS_SGI62_ENV */
2616 #define AFS_N_FILELISTS 1
2617 #endif /* AFS_SGI62_ENV */
2622 set_staticaddrs(void)
2624 staticNameList fileList[AFS_N_FILELISTS];
2626 fileList[0].addrList =
2627 (staticAddrList *) calloc(1, sizeof(staticAddrList));
2628 if (!fileList[0].addrList) {
2629 printf("set_staticaddrs: Can't calloc fileList[0].addrList\n");
2632 fileList[0].file = "nfs_server.c";
2633 fileList[0].found = 0;
2634 fileList[0].nAddrs = 1;
2635 fileList[0].addrList[0].name = "rfsdisptab_v2";
2636 fileList[0].addrList[0].type = DW_AT_location;
2637 fileList[0].addrList[0].found = 0;
2639 #if defined(AFS_SGI62_ENV) && !defined(AFS_SGI65_ENV)
2640 fileList[1].addrList =
2641 (staticAddrList *) calloc(2, sizeof(staticAddrList));
2642 if (!fileList[1].addrList) {
2643 printf("set_staticaddrs: Can't malloc fileList[1].addrList\n");
2646 fileList[1].file = "uipc_socket.c";
2647 fileList[1].found = 0;
2648 fileList[1].nAddrs = 2;
2649 fileList[1].addrList[0].name = "sblock";
2650 fileList[1].addrList[0].type = DW_AT_low_pc;
2651 fileList[1].addrList[0].found = 0;
2652 fileList[1].addrList[1].name = "sbunlock";
2653 fileList[1].addrList[1].type = DW_AT_low_pc;
2654 fileList[1].addrList[1].found = 0;
2656 if (64 != sysconf(_SC_KERN_POINTERS))
2657 findMDebugStaticAddresses(fileList, AFS_N_FILELISTS, AFS_SYMS_NEEDED);
2659 #endif /* AFS_SGI62_ENV */
2660 findDwarfStaticAddresses(fileList, AFS_N_FILELISTS);
2662 if (fileList[0].addrList[0].found) {
2663 afsd_call_syscall(AFSOP_NFSSTATICADDR2, fileList[0].addrList[0].addr.high,
2664 fileList[0].addrList[0].addr.low);
2667 printf("NFS V2 is not present in the kernel.\n");
2669 free(fileList[0].addrList);
2670 #if defined(AFS_SGI62_ENV) && !defined(AFS_SGI65_ENV)
2671 if (fileList[1].addrList[0].found && fileList[1].addrList[1].found) {
2672 afsd_call_syscall(AFSOP_SBLOCKSTATICADDR2,
2673 fileList[1].addrList[0].addr.high,
2674 fileList[1].addrList[0].addr.low,
2675 fileList[1].addrList[1].addr.high,
2676 fileList[1].addrList[1].addr.low);
2678 if (!fileList[1].addrList[0].found)
2679 printf("Can't find %s in kernel. Exiting.\n",
2680 fileList[1].addrList[0].name);
2681 if (!fileList[1].addrList[0].found)
2682 printf("Can't find %s in kernel. Exiting.\n",
2683 fileList[1].addrList[1].name);
2686 free(fileList[1].addrList);
2687 #endif /* AFS_SGI62_ENV */
2691 /* Find addresses for static variables and functions. */
2693 findDwarfStaticAddresses(staticNameList * nameList, int nLists)
2700 char *hname = (char *)0;
2701 Dwarf_Unsigned dwarf_access = O_RDONLY;
2702 Dwarf_Debug dwarf_debug;
2703 Dwarf_Error dwarf_error;
2704 Dwarf_Unsigned dwarf_cu_header_length;
2705 Dwarf_Unsigned dwarf_abbrev_offset;
2706 Dwarf_Half dwarf_address_size;
2707 Dwarf_Unsigned next_cu_header;
2708 Dwarf_Die dwarf_die;
2709 Dwarf_Die dwarf_next_die;
2710 Dwarf_Die dwarf_child_die;
2712 if (elf_version(EV_CURRENT) == EV_NONE) {
2713 printf("findDwarfStaticAddresses: Bad elf version.\n");
2717 if ((fd = open("/unix", O_RDONLY, 0)) < 0) {
2718 printf("findDwarfStaticAddresses: Failed to open /unix.\n");
2722 dwarf_init(fd, dwarf_access, NULL, NULL, &dwarf_debug, &dwarf_error);
2723 if (code != DW_DLV_OK) {
2724 /* Nope hope for the elves and dwarves, try intermediate code. */
2731 /* Run through the headers until we find ones for files we've
2732 * specified in nameList.
2735 dwarf_next_cu_header(dwarf_debug, &dwarf_cu_header_length, NULL,
2736 &dwarf_abbrev_offset, &dwarf_address_size,
2737 &next_cu_header, &dwarf_error);
2738 if (code == DW_DLV_NO_ENTRY) {
2740 } else if (code == DW_DLV_ERROR) {
2741 printf("findDwarfStaticAddresses: Error reading headers: %s\n",
2742 dwarf_errmsg(dwarf_error));
2746 code = dwarf_siblingof(dwarf_debug, NULL, &dwarf_die, &dwarf_error);
2747 if (code != DW_DLV_OK) {
2748 printf("findDwarfStaticAddresses: Can't get first die. %s\n",
2749 (code == DW_DLV_ERROR) ? dwarf_errmsg(dwarf_error) : "");
2753 /* This is the header, test the name. */
2754 code = dwarf_diename(dwarf_die, &hname, &dwarf_error);
2755 if (code == DW_DLV_OK) {
2756 s = strrchr(hname, '/');
2757 for (i = 0; i < nLists; i++) {
2758 if (s && !strcmp(s + 1, nameList[i].file)) {
2759 findElfAddresses(dwarf_debug, dwarf_die, &nameList[i]);
2766 ("findDwarfStaticAddresses: Can't get name of current header. %s\n",
2767 (code == DW_DLV_ERROR) ? dwarf_errmsg(dwarf_error) : "");
2770 dwarf_dealloc(dwarf_debug, hname, DW_DLA_STRING);
2772 if (found >= nLists) { /* we're done */
2777 /* Frees up all allocated space. */
2778 (void)dwarf_finish(dwarf_debug, &dwarf_error);
2783 findElfAddresses(Dwarf_Debug dwarf_debug, Dwarf_Die dwarf_die,
2784 staticNameList * nameList)
2787 Dwarf_Error dwarf_error;
2788 Dwarf_Die dwarf_next_die;
2789 Dwarf_Die dwarf_child_die;
2790 Dwarf_Attribute dwarf_return_attr;
2791 char *vname = (char *)0;
2795 /* Drop into this die to find names in addrList. */
2796 code = dwarf_child(dwarf_die, &dwarf_child_die, &dwarf_error);
2797 if (code != DW_DLV_OK) {
2798 printf("findElfAddresses: Can't get child die. %s\n",
2799 (code == DW_DLV_ERROR) ? dwarf_errmsg(dwarf_error) : "");
2803 /* Try to find names in each sibling. */
2804 dwarf_next_die = (Dwarf_Die) 0;
2806 code = dwarf_diename(dwarf_child_die, &vname, &dwarf_error);
2807 /* It's possible that some siblings don't have names. */
2808 if (code == DW_DLV_OK) {
2809 for (i = 0; i < nameList->nAddrs; i++) {
2810 if (!nameList->addrList[i].found) {
2811 if (!strcmp(vname, nameList->addrList[i].name)) {
2812 getElfAddress(dwarf_debug, dwarf_child_die,
2813 &(nameList->addrList[i]));
2821 dwarf_dealloc(dwarf_debug, dwarf_next_die, DW_DLA_DIE);
2823 if (found >= nameList->nAddrs) { /* we're done. */
2827 dwarf_next_die = dwarf_child_die;
2829 dwarf_siblingof(dwarf_debug, dwarf_next_die, &dwarf_child_die,
2832 } while (code == DW_DLV_OK);
2835 /* Get address out of current die. */
2837 getElfAddress(Dwarf_Debug dwarf_debug, Dwarf_Die dwarf_child_die,
2838 staticAddrList * addrList)
2841 Dwarf_Error dwarf_error;
2842 Dwarf_Attribute dwarf_return_attr;
2843 Dwarf_Bool dwarf_return_bool;
2844 Dwarf_Locdesc *llbuf = NULL;
2845 Dwarf_Signed listlen;
2846 off64_t addr = (off64_t) 0;
2850 dwarf_hasattr(dwarf_child_die, addrList->type, &dwarf_return_bool,
2852 if ((code != DW_DLV_OK) || (!dwarf_return_bool)) {
2853 printf("getElfAddress: no address given for %s. %s\n", addrList->name,
2854 (code == DW_DLV_ERROR) ? dwarf_errmsg(dwarf_error) : "");
2858 dwarf_attr(dwarf_child_die, addrList->type, &dwarf_return_attr,
2860 if (code != DW_DLV_OK) {
2861 printf("getElfAddress: Can't get attribute. %s\n",
2862 (code == DW_DLV_ERROR) ? dwarf_errmsg(dwarf_error) : "");
2866 switch (addrList->type) {
2867 case DW_AT_location:
2869 dwarf_loclist(dwarf_return_attr, &llbuf, &listlen, &dwarf_error);
2870 if (code != DW_DLV_OK) {
2871 printf("getElfAddress: Can't get location for %s. %s\n",
2873 (code == DW_DLV_ERROR) ? dwarf_errmsg(dwarf_error) : "");
2876 if ((listlen != 1) || (llbuf[0].ld_cents != 1)) {
2877 printf("getElfAddress: %s has more than one address.\n",
2881 addr = llbuf[0].ld_s[0].lr_number;
2886 dwarf_lowpc(dwarf_child_die, (Dwarf_Addr *) & addr, &dwarf_error);
2887 if (code != DW_DLV_OK) {
2888 printf("getElfAddress: Can't get lowpc for %s. %s\n",
2890 (code == DW_DLV_ERROR) ? dwarf_errmsg(dwarf_error) : "");
2896 printf("getElfAddress: Bad case %d in switch.\n", addrList->type);
2900 addrList->addr.high = (addr >> 32) & 0xffffffff;
2901 addrList->addr.low = addr & 0xffffffff;
2902 addrList->found = 1;
2905 #if defined(AFS_SGI62_ENV) && !defined(AFS_SGI65_ENV)
2906 /* Find symbols in the .mdebug section for 32 bit kernels. */
2909 * On 32bit platforms, we're still using the ucode compilers to build
2910 * the kernel, so we need to get our static text/data from the .mdebug
2911 * section instead of the .dwarf sections.
2913 /* SearchNameList searches our bizarre structs for the given string.
2914 * If found, sets the found bit and the address and returns 1.
2915 * Not found returns 0.
2918 SearchNameList(char *name, afs_uint32 addr, staticNameList * nameList,
2922 for (i = 0; i < nLists; i++) {
2923 for (j = 0; j < nameList[i].nAddrs; j++) {
2924 if (nameList[i].addrList[j].found)
2926 if (!strcmp(name, nameList[i].addrList[j].name)) {
2927 nameList[i].addrList[j].addr.high = 0;
2928 nameList[i].addrList[j].addr.low = addr;
2929 nameList[i].addrList[j].found = 1;
2938 SearchMDebug(Elf_Scn * scnp, Elf32_Shdr * shdrp, staticNameList * nameList,
2939 int nLists, int needed)
2941 long *buf = (long *)(elf_getdata(scnp, NULL)->d_buf);
2942 u_long addr, mdoff = shdrp->sh_offset;
2944 SYMR *symbase, *symp, *symend;
2945 FDR *fdrbase, *fdrp;
2947 char *strbase, *str;
2952 addr = (__psunsigned_t) buf;
2953 hdrp = (HDRR *) addr;
2955 /* setup base addresses */
2956 addr = (u_long) buf + (u_long) (hdrp->cbFdOffset - mdoff);
2957 fdrbase = (FDR *) addr;
2958 addr = (u_long) buf + (u_long) (hdrp->cbSymOffset - mdoff);
2959 symbase = (SYMR *) addr;
2960 addr = (u_long) buf + (u_long) (hdrp->cbSsOffset - mdoff);
2961 strbase = (char *)addr;
2963 #define KEEPER(a,b) ((a == stStaticProc && b == scText) || \
2964 (a == stStatic && (b == scData || b == scBss || \
2965 b == scSBss || b == scSData)))
2967 for (fdrp = fdrbase; fdrp < &fdrbase[hdrp->ifdMax]; fdrp++) {
2968 str = strbase + fdrp->issBase + fdrp->rss;
2970 /* local symbols for each fd */
2971 for (symp = &symbase[fdrp->isymBase];
2972 symp < &symbase[fdrp->isymBase + fdrp->csym]; symp++) {
2973 if (KEEPER(symp->st, symp->sc)) {
2974 if (symp->value == 0)
2977 str = strbase + fdrp->issBase + symp->iss;
2978 /* Look for AFS symbols of interest */
2979 if (SearchNameList(str, symp->value, nameList, nLists)) {
2981 if (nFound >= needed)
2990 * returns section with the name of scn_name, & puts its header in shdr64 or
2991 * shdr32 based on elf's file type
2995 findMDebugSection(Elf * elf, char *scn_name)
2999 Elf_Scn *scn = NULL;
3003 if ((ehdr32 = elf32_getehdr(elf)) == NULL)
3006 if ((scn = elf_nextscn(elf, scn)) == NULL)
3008 if ((shdr32 = elf32_getshdr(scn)) == NULL)
3012 elf_strptr(elf, ehdr32->e_shstrndx, shdr32->sh_name)));
3019 findMDebugStaticAddresses(staticNameList * nameList, int nLists, int needed)
3023 Elf_Scn *mdebug_scn;
3024 Elf32_Shdr *mdebug_shdr;
3027 if ((fd = open("/unix", O_RDONLY)) == -1) {
3028 printf("findMDebugStaticAddresses: Failed to open /unix.\n");
3032 (void)elf_version(EV_CURRENT);
3033 if ((elf = elf_begin(fd, ELF_C_READ, NULL)) == NULL) {
3035 ("findMDebugStaticAddresses: /unix doesn't seem to be an elf file\n");
3039 mdebug_scn = findMDebugSection(elf, ".mdebug");
3041 printf("findMDebugStaticAddresses: Can't find .mdebug section.\n");
3044 mdebug_shdr = elf32_getshdr(mdebug_scn);
3046 printf("findMDebugStaticAddresses: Can't find .mdebug header.\n");
3050 (void)SearchMDebug(mdebug_scn, mdebug_shdr, nameList, nLists, needed);
3056 #endif /* AFS_SGI62_ENV */
3058 #else /* AFS_SGI61_ENV */
3060 struct nlist nlunix[] = {
3067 int i, j, kmem, count;
3069 if ((kmem = open("/dev/kmem", O_RDONLY)) < 0) {
3070 printf("Warning: can't open /dev/kmem\n");
3073 if ((j = nlist("/unix", nlunix)) < 0) {
3074 printf("Warning: can't nlist /unix\n");
3077 i = nlunix[0].n_value;
3078 if (lseek(kmem, i, L_SET /*0 */ ) != i) {
3079 printf("Warning: can't lseek to %x\n", i);
3082 if ((j = read(kmem, &count, sizeof count)) != sizeof count) {
3083 printf("WARNING: kmem read at %x failed\n", i);
3088 #endif /* AFS_SGI61_ENV */
3089 #endif /* AFS_SGI53_ENV */
3091 struct afsd_syscall_args {
3103 * entry point for calling a syscall from another proc/thread.
3105 * @param[in] rock a struct afsd_syscall_args* specifying what syscall to call
3108 * @retval NULL always
3111 call_syscall_thread(void *rock)
3113 struct afsd_syscall_args *args = rock;
3117 afsd_set_rx_rtpri();
3120 code = afsd_call_syscall(args->syscall, args->param1, args->param2,
3121 args->param3, args->param4, args->param5);
3122 if (code && args->syscall == AFSOP_START_CS) {
3123 printf("%s: No check server daemon in client.\n", args->rn);
3132 * common code for calling a syscall in another proc/thread.
3134 * @param[in] rx 1 if this is a thread for RX stuff, 0 otherwise
3135 * @param[in] wait 1 if we should wait for the new proc/thread to finish, 0 to
3136 * let it run in the background
3137 * @param[in] rn the name of the running program
3138 * @param[in] syscall syscall to run
3141 fork_syscall_impl(int rx, int wait, const char *rn, long syscall, long param1,
3142 long param2, long param3, long param4, long param5)
3144 struct afsd_syscall_args *args;
3146 args = malloc(sizeof(*args));
3148 args->syscall = syscall;
3149 args->param1 = param1;
3150 args->param2 = param2;
3151 args->param3 = param3;
3152 args->param4 = param4;
3153 args->param5 = param5;
3157 afsd_fork(wait, call_syscall_thread, args);
3161 * call a syscall in another process or thread.
3164 fork_syscall(const char *rn, long syscall, long param1, long param2,
3165 long param3, long param4, long param5)
3167 fork_syscall_impl(0, 0, rn, syscall, param1, param2, param3, param4, param5);
3170 #if defined(AFS_SUN510_ENV) || defined(RXK_LISTENER_ENV)
3172 * call a syscall in another process or thread, and give it RX priority.
3175 fork_rx_syscall(const char *rn, long syscall, long param1, long param2,
3176 long param3, long param4, long param5)
3178 fork_syscall_impl(1, 0, rn, syscall, param1, param2, param3, param4, param5);
3180 #endif /* AFS_SUN510_ENV || RXK_LISTENER_ENV */
3182 #if defined(AFS_SUN510_ENV) && defined(RXK_LISTENER_ENV)
3184 * call a syscall in another process or thread, give it RX priority, and wait
3185 * for it to finish before returning.
3188 fork_rx_syscall_wait(const char *rn, long syscall, long param1, long param2,
3189 long param3, long param4, long param5)
3191 fork_syscall_impl(1, 1, rn, syscall, param1, param2, param3, param4, param5);
3193 #endif /* AFS_SUN510_ENV && RXK_LISTENER_ENV */