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;
231 #define s_host S_un.S_un_b.s_b2 /* host on imp */
232 #define s_net S_un.S_un_b.s_b1 /* network */
233 #define s_imp S_un.S_un_w.s_w2 /* imp */
234 #define s_impno S_un.S_un_b.s_b4 /* imp # */
235 #define s_lh S_un.S_un_b.s_b3 /* logical host */
238 #define mPrintIPAddr(ipaddr) printf("[%d.%d.%d.%d] ", \
239 ((struct in_addr_42 *) &(ipaddr))->S_un.S_un_b.s_b1, \
240 ((struct in_addr_42 *) &(ipaddr))->S_un.S_un_b.s_b2, \
241 ((struct in_addr_42 *) &(ipaddr))->S_un.S_un_b.s_b3, \
242 ((struct in_addr_42 *) &(ipaddr))->S_un.S_un_b.s_b4)
245 * Global configuration variables.
247 static afs_int32 enable_rxbind = 0;
248 static afs_int32 afs_shutdown = 0;
249 static afs_int32 cacheBlocks; /*Num blocks in the cache */
250 static afs_int32 cacheFiles; /*Optimal # of files in workstation cache */
251 static afs_int32 rwpct = 0;
252 static afs_int32 ropct = 0;
253 static afs_int32 cacheStatEntries; /*Number of stat cache entries */
254 static char cacheBaseDir[1024]; /*Where the workstation AFS cache lives */
255 static char confDir[1024]; /*Where the workstation AFS configuration lives */
256 static char fullpn_DCacheFile[1024]; /*Full pathname of DCACHEFILE */
257 static char fullpn_VolInfoFile[1024]; /*Full pathname of VOLINFOFILE */
258 static char fullpn_CellInfoFile[1024]; /*Full pathanem of CELLINFOFILE */
259 static char fullpn_CacheInfo[1024]; /*Full pathname of CACHEINFO */
260 static char fullpn_VFile[1024]; /*Full pathname of data cache files */
261 static char *vFilePtr; /*Ptr to the number part of above pathname */
262 static int sawCacheMountDir = 0; /* from cmd line */
263 static int sawCacheBaseDir = 0;
264 static int sawCacheBlocks = 0;
265 static int sawDCacheSize = 0;
267 static int sawBiod = 0;
269 static int sawCacheStatEntries = 0;
270 char afsd_cacheMountDir[1024]; /*Mount directory for AFS */
271 static char rootVolume[64] = "root.afs"; /*AFS root volume name */
272 static afs_int32 cacheSetTime = 0; /*Keep checking time to avoid drift? */
274 static int createAndTrunc = O_RDWR | O_CREAT | O_TRUNC; /*Create & truncate on open */
276 static int createAndTrunc = O_CREAT | O_TRUNC; /*Create & truncate on open */
278 static int ownerRWmode = 0600; /*Read/write OK by owner */
279 static int filesSet = 0; /*True if number of files explicitly set */
280 static int nFilesPerDir = 2048; /* # files per cache dir */
281 #if defined(AFS_CACHE_BYPASS)
282 #define AFSD_NDAEMONS 4
284 #define AFSD_NDAEMONS 2
286 static int nDaemons = AFSD_NDAEMONS; /* Number of background daemons */
287 static int chunkSize = 0; /* 2^chunkSize bytes per chunk */
288 static int dCacheSize; /* # of dcache entries */
289 static int vCacheSize = 200; /* # of volume cache entries */
290 static int rootVolSet = 0; /*True if root volume name explicitly set */
291 int addrNum; /*Cell server address index being printed */
292 static int cacheFlags = 0; /*Flags to cache manager */
294 static int nBiods = 5; /* AIX3.1 only */
296 static int preallocs = 400; /* Def # of allocated memory blocks */
297 static int enable_peer_stats = 0; /* enable rx stats */
298 static int enable_process_stats = 0; /* enable rx stats */
299 static int enable_afsdb = 0; /* enable AFSDB support */
300 static int enable_dynroot = 0; /* enable dynroot support */
301 static int enable_fakestat = 0; /* enable fakestat support */
302 static int enable_backuptree = 0; /* enable backup tree support */
303 static int enable_nomount = 0; /* do not mount */
304 static int enable_splitcache = 0;
305 static int afsd_dynamic_vcaches = 0; /* Enable dynamic-vcache support */
306 int afsd_verbose = 0; /*Are we being chatty? */
307 int afsd_debug = 0; /*Are we printing debugging info? */
308 static int afsd_CloseSynch = 0; /*Are closes synchronous or not? */
309 static int rxmaxmtu = 0; /* Are we forcing a limit on the mtu? */
312 #define AFSD_INO_T ino64_t
314 #define AFSD_INO_T afs_uint32
316 struct afsd_file_list {
318 struct afsd_file_list *next;
320 struct afsd_file_list **cache_dir_filelist = NULL;
321 int *cache_dir_list = NULL; /* Array of cache subdirs */
322 int *dir_for_V = NULL; /* Array: dir of each cache file.
323 * -1: file does not exist
324 * -2: file exists in top-level
325 * >=0: file exists in Dxxx
327 #if !defined(AFS_CACHE_VNODE_PATH) && !defined(AFS_LINUX26_ENV)
328 AFSD_INO_T *inode_for_V; /* Array of inodes for desired
331 int missing_DCacheFile = 1; /*Is the DCACHEFILE missing? */
332 int missing_VolInfoFile = 1; /*Is the VOLINFOFILE missing? */
333 int missing_CellInfoFile = 1; /*Is the CELLINFOFILE missing? */
334 int afsd_rmtsys = 0; /* Default: don't support rmtsys */
335 struct afs_cacheParams cparams; /* params passed to cache manager */
337 int PartSizeOverflow(char *path, int cs);
339 #if defined(AFS_SUN510_ENV) && defined(RXK_LISTENER_ENV)
340 static void fork_rx_syscall_wait();
342 #if defined(AFS_SUN510_ENV) || defined(RXK_LISTENER_ENV)
343 static void fork_rx_syscall();
345 static void fork_syscall();
347 #if defined(AFS_DARWIN_ENV) && !defined(AFS_ARM_DARWIN_ENV)
349 afsd_sleep_callback(void * refCon, io_service_t service,
350 natural_t messageType, void * messageArgument )
352 switch (messageType) {
353 case kIOMessageCanSystemSleep:
354 /* Idle sleep is about to kick in; can
355 prevent sleep by calling IOCancelPowerChange, otherwise
356 if we don't ack in 30s the system sleeps anyway */
359 IOAllowPowerChange(root_port, (long)messageArgument);
362 case kIOMessageSystemWillSleep:
363 /* The system WILL go to sleep. Ack or suffer delay */
365 IOAllowPowerChange(root_port, (long)messageArgument);
368 case kIOMessageSystemWillRestart:
369 /* The system WILL restart. Ack or suffer delay */
371 IOAllowPowerChange(root_port, (long)messageArgument);
374 case kIOMessageSystemWillPowerOn:
375 case kIOMessageSystemHasPoweredOn:
376 /* coming back from sleep */
378 IOAllowPowerChange(root_port, (long)messageArgument);
382 IOAllowPowerChange(root_port, (long)messageArgument);
388 afsd_update_addresses(CFRunLoopTimerRef timer, void *info)
390 /* parse multihomed address files */
391 afs_uint32 addrbuf[MAXIPADDRS], maskbuf[MAXIPADDRS],
397 parseNetFiles(addrbuf, maskbuf, mtubuf, MAXIPADDRS, reason,
398 AFSDIR_CLIENT_NETINFO_FILEPATH,
399 AFSDIR_CLIENT_NETRESTRICT_FILEPATH);
402 /* Note we're refreshing */
403 code = code | 0x40000000;
404 afsd_call_syscall(AFSOP_ADVISEADDR, code, addrbuf, maskbuf, mtubuf);
406 printf("ADVISEADDR: Error in specifying interface addresses:%s\n",
409 /* Since it's likely this means our DNS server changed, reinit now */
414 /* This function is called when the system's ip addresses may have changed. */
416 afsd_ipaddr_callback (SCDynamicStoreRef store, CFArrayRef changed_keys, void *info)
418 CFRunLoopTimerRef timer;
420 timer = CFRunLoopTimerCreate (NULL, CFAbsoluteTimeGetCurrent () + 1.0,
421 0.0, 0, 0, afsd_update_addresses, NULL);
422 CFRunLoopAddTimer (CFRunLoopGetCurrent (), timer,
423 kCFRunLoopDefaultMode);
428 afsd_event_cleanup(int signo) {
430 CFRunLoopRemoveSource(CFRunLoopGetCurrent(), source, kCFRunLoopDefaultMode);
432 #ifndef AFS_ARM_DARWIN_ENV
433 IODeregisterForSystemPower(&iterator);
434 IOServiceClose(root_port);
435 IONotificationPortDestroy(notify);
440 /* Adapted from "Living in a Dynamic TCP/IP Environment" technote. */
442 afsd_install_events(void)
444 SCDynamicStoreContext ctx = {0};
445 SCDynamicStoreRef store;
447 #ifndef AFS_ARM_DARWIN_ENV
448 root_port = IORegisterForSystemPower(0,¬ify,afsd_sleep_callback,&iterator);
451 CFRunLoopAddSource(CFRunLoopGetCurrent(),
452 IONotificationPortGetRunLoopSource(notify),
453 kCFRunLoopDefaultMode);
457 store = SCDynamicStoreCreate (NULL,
458 CFSTR ("AddIPAddressListChangeCallbackSCF"),
459 afsd_ipaddr_callback, &ctx);
464 /* Request IPV4 address change notification */
465 keys[0] = (SCDynamicStoreKeyCreateNetworkServiceEntity
466 (NULL, kSCDynamicStoreDomainState,
467 kSCCompAnyRegex, kSCEntNetIPv4));
470 /* This should tell us when the hostname(s) change. do we care? */
471 keys[N] = SCDynamicStoreKeyCreateHostNames (NULL);
474 if (keys[0] != NULL) {
475 CFArrayRef pattern_array;
477 pattern_array = CFArrayCreate (NULL, keys, 1,
478 &kCFTypeArrayCallBacks);
480 if (pattern_array != NULL)
482 SCDynamicStoreSetNotificationKeys (store, NULL, pattern_array);
483 source = SCDynamicStoreCreateRunLoopSource (NULL, store, 0);
485 CFRelease (pattern_array);
496 if (source != NULL) {
497 CFRunLoopAddSource (CFRunLoopGetCurrent(),
498 source, kCFRunLoopDefaultMode);
501 signal(SIGTERM, afsd_event_cleanup);
507 /* ParseArgs is now obsolete, being handled by cmd */
509 /*------------------------------------------------------------------------------
513 * Open the file containing the description of the workstation's AFS cache
514 * and pull out its contents. The format of this file is as follows:
516 * cacheMountDir:cacheBaseDir:cacheBlocks
522 * 0 if everything went well,
526 * Nothing interesting.
530 *---------------------------------------------------------------------------*/
533 ParseCacheInfoFile(void)
535 static char rn[] = "ParseCacheInfoFile"; /*This routine's name */
536 FILE *cachefd; /*Descriptor for cache info file */
537 int parseResult; /*Result of our fscanf() */
538 afs_int32 tCacheBlocks;
539 char tCacheBaseDir[1024], *tbd, tCacheMountDir[1024], *tmd;
542 printf("%s: Opening cache info file '%s'...\n", rn, fullpn_CacheInfo);
544 cachefd = fopen(fullpn_CacheInfo, "r");
546 printf("%s: Can't read cache info file '%s'\n", rn, fullpn_CacheInfo);
551 * Parse the contents of the cache info file. All chars up to the first
552 * colon are the AFS mount directory, all chars to the next colon are the
553 * full path name of the workstation cache directory and all remaining chars
554 * represent the number of blocks in the cache.
556 tCacheMountDir[0] = tCacheBaseDir[0] = '\0';
558 fscanf(cachefd, "%1024[^:]:%1024[^:]:%d", tCacheMountDir,
559 tCacheBaseDir, &tCacheBlocks);
562 * Regardless of how the parse went, we close the cache info file.
566 if (parseResult == EOF || parseResult < 3) {
567 printf("%s: Format error in cache info file!\n", rn);
568 if (parseResult == EOF)
569 printf("\tEOF encountered before any field parsed.\n");
571 printf("\t%d out of 3 fields successfully parsed.\n",
577 for (tmd = tCacheMountDir; *tmd == '\n' || *tmd == ' ' || *tmd == '\t';
579 for (tbd = tCacheBaseDir; *tbd == '\n' || *tbd == ' ' || *tbd == '\t';
581 /* now copy in the fields not explicitly overridden by cmd args */
582 if (!sawCacheMountDir)
583 strcpy(afsd_cacheMountDir, tmd);
584 if (!sawCacheBaseDir)
585 strcpy(cacheBaseDir, tbd);
587 cacheBlocks = tCacheBlocks;
590 printf("%s: Cache info file successfully parsed:\n", rn);
592 ("\tcacheMountDir: '%s'\n\tcacheBaseDir: '%s'\n\tcacheBlocks: %d\n",
593 tmd, tbd, tCacheBlocks);
595 if (!(cacheFlags & AFSCALL_INIT_MEMCACHE)) {
596 return (PartSizeOverflow(tbd, cacheBlocks));
603 * All failures to open the partition are ignored. Also if the cache dir
604 * isn't a mounted partition it's also ignored since we can't guarantee
605 * what will be stored afterwards. Too many if's. This is now purely
606 * advisory. ODS with over 2G partition also gives warning message.
609 * 0 if everything went well,
613 PartSizeOverflow(char *path, int cs)
616 afs_int64 totalblks, mint;
617 #if AFS_HAVE_STATVFS || defined(HAVE_SYS_STATVFS_H)
618 struct statvfs statbuf;
620 if (statvfs(path, &statbuf) != 0) {
623 ("statvfs failed on %s; skip checking for adequate partition space\n",
627 totalblks = statbuf.f_blocks;
628 bsize = statbuf.f_frsize;
630 if (strcmp(statbuf.f_basetype, "jfs")) {
631 fprintf(stderr, "Cache filesystem '%s' must be jfs (now %s)\n",
632 path, statbuf.f_basetype);
635 #endif /* AFS_AIX51_ENV */
637 #else /* AFS_HAVE_STATVFS */
638 struct statfs statbuf;
640 if (statfs(path, &statbuf) < 0) {
643 ("statfs failed on %s; skip checking for adequate partition space\n",
647 totalblks = statbuf.f_blocks;
648 bsize = statbuf.f_bsize;
651 return 0; /* success */
653 /* now free and totalblks are in fragment units, but we want them in 1K units */
655 totalblks *= (bsize / 1024);
657 totalblks /= (1024 / bsize);
660 mint = totalblks / 100 * 95;
663 ("Cache size (%d) must be less than 95%% of partition size (which is %lld). Lower cache size\n",
671 /*-----------------------------------------------------------------------------
675 * Given the final component of a filename expected to be a data cache file,
676 * return the integer corresponding to the file. Note: we reject names that
677 * are not a ``V'' followed by an integer. We also reject those names having
678 * the right format but lying outside the range [0..cacheFiles-1].
681 * fname : Char ptr to the filename to parse.
682 * max : integer for the highest number to accept
685 * >= 0 iff the file is really a data cache file numbered from 0 to cacheFiles-1, or
689 * Nothing interesting.
693 *---------------------------------------------------------------------------*/
696 doGetXFileNumber(char *fname, char filechar, int maxNum)
698 int computedVNumber; /*The computed file number we return */
699 int filenameLen; /*Number of chars in filename */
700 int currDigit; /*Current digit being processed */
703 * The filename must have at least two characters, the first of which must be a ``filechar''
704 * and the second of which cannot be a zero unless the file is exactly two chars long.
706 filenameLen = strlen(fname);
709 if (fname[0] != filechar)
711 if ((filenameLen > 2) && (fname[1] == '0'))
715 * Scan through the characters in the given filename, failing immediately if a non-digit
718 for (currDigit = 1; currDigit < filenameLen; currDigit++)
719 if (isdigit(fname[currDigit]) == 0)
723 * All relevant characters are digits. Pull out the decimal number they represent.
724 * Reject it if it's out of range, otherwise return it.
726 computedVNumber = atoi(++fname);
727 if (computedVNumber < cacheFiles)
728 return (computedVNumber);
734 GetVFileNumber(char *fname, int maxFile)
736 return doGetXFileNumber(fname, 'V', maxFile);
740 GetDDirNumber(char *fname, int maxDir)
742 return doGetXFileNumber(fname, 'D', maxDir);
746 /*-----------------------------------------------------------------------------
750 * Given a full pathname for a file we need to create for the workstation AFS
751 * cache, go ahead and create the file.
754 * fname : Full pathname of file to create.
755 * statp : A pointer to a stat buffer which, if NON-NULL, will be
759 * 0 iff the file was created,
763 * The given cache file has been found to be missing.
767 *---------------------------------------------------------------------------*/
770 CreateCacheSubDir(char *basename, int dirNum)
772 static char rn[] = "CreateCacheSubDir"; /* Routine Name */
776 /* Build the new cache subdirectory */
777 sprintf(dir, "%s/D%d", basename, dirNum);
780 printf("%s: Creating cache subdir '%s'\n", rn, dir);
782 if ((ret = mkdir(dir, 0700)) != 0) {
783 printf("%s: Can't create '%s', error return is %d (%d)\n", rn, dir,
789 /* Mark this directory as created */
790 cache_dir_list[dirNum] = 0;
792 /* And return success */
797 SetNoBackupAttr(char *fullpn)
799 #ifdef AFS_DARWIN80_ENV
802 ret = setxattr(fullpn, "com.apple.metadata:com_apple_backup_excludeItem",
803 "com.apple.backupd", strlen("com.apple.backupd"), 0,
808 fprintf(stderr, "afsd: Warning: failed to set attribute to preclude cache backup: %s\n", strerror(errno));
815 MoveCacheFile(char *basename, int fromDir, int toDir, int cacheFile,
818 static char rn[] = "MoveCacheFile";
819 char from[1024], to[1024];
822 if (cache_dir_list[toDir] < 0
823 && (ret = CreateCacheSubDir(basename, toDir))) {
824 printf("%s: Can't create directory '%s/D%d'\n", rn, basename, toDir);
828 /* Build the from,to dir */
830 /* old-style location */
831 snprintf(from, sizeof(from), "%s/V%d", basename, cacheFile);
833 snprintf(from, sizeof(from), "%s/D%d/V%d", basename, fromDir,
837 snprintf(to, sizeof(from), "%s/D%d/V%d", basename, toDir, cacheFile);
840 printf("%s: Moving cacheFile from '%s' to '%s'\n", rn, from, to);
842 if ((ret = rename(from, to)) != 0) {
843 printf("%s: Can't rename '%s' to '%s', error return is %d (%d)\n", rn,
844 from, to, ret, errno);
849 /* Reset directory pointer; fix file counts */
850 dir_for_V[cacheFile] = toDir;
851 cache_dir_list[toDir]++;
852 if (fromDir < maxDir && fromDir >= 0)
853 cache_dir_list[fromDir]--;
859 CreateCacheFile(char *fname, struct stat *statp)
861 static char rn[] = "CreateCacheFile"; /*Routine name */
862 int cfd; /*File descriptor to AFS cache file */
863 int closeResult; /*Result of close() */
866 printf("%s: Creating cache file '%s'\n", rn, fname);
867 cfd = open(fname, createAndTrunc, ownerRWmode);
869 printf("%s: Can't create '%s', error return is %d (%d)\n", rn, fname,
874 closeResult = fstat(cfd, statp);
877 ("%s: Can't stat newly-created AFS cache file '%s' (code %d)\n",
882 closeResult = close(cfd);
885 ("%s: Can't close newly-created AFS cache file '%s' (code %d)\n",
894 CreateFileIfMissing(char *fullpn, int missing)
897 if (CreateCacheFile(fullpn, NULL))
898 printf("CreateFileIfMissing: Can't create '%s'\n", fullpn);
903 UnlinkUnwantedFile(char *rn, char *fullpn_FileToDelete, char *fileToDelete)
905 if (unlink(fullpn_FileToDelete)) {
906 if ((errno == EISDIR || errno == EPERM) && *fileToDelete == 'D') {
907 if (rmdir(fullpn_FileToDelete)) {
908 printf("%s: Can't rmdir '%s', errno is %d\n", rn,
909 fullpn_FileToDelete, errno);
912 printf("%s: Can't unlink '%s', errno is %d\n", rn,
913 fullpn_FileToDelete, errno);
917 /*-----------------------------------------------------------------------------
921 * Sweep through the AFS cache directory, recording the inode number for
922 * each valid data cache file there. Also, delete any file that doesn't belong
923 * in the cache directory during this sweep, and remember which of the other
924 * residents of this directory were seen. After the sweep, we create any data
925 * cache files that were missing.
928 * vFilesFound : Set to the number of data cache files found.
931 * 0 if everything went well,
935 * This routine may be called several times. If the number of data cache files
936 * found is less than the global cacheFiles, then the caller will need to call it
937 * again to record the inodes of the missing zero-length data cache files created
938 * in the previous call.
941 * Fills up the global inode_for_V array, may create and/or delete files as
943 *---------------------------------------------------------------------------*/
947 doSweepAFSCache(int *vFilesFound,
948 char *directory, /* /path/to/cache/directory */
949 int dirNum, /* current directory number */
950 int maxDir) /* maximum directory number */
952 static char rn[] = "doSweepAFSCache"; /* Routine Name */
953 char fullpn_FileToDelete[1024]; /*File to be deleted from cache */
954 char *fileToDelete; /*Ptr to last component of above */
955 DIR *cdirp; /*Ptr to cache directory structure */
957 struct dirent64 *currp; /*Current directory entry */
959 struct dirent *currp; /*Current directory entry */
961 int vFileNum; /*Data cache file's associated number */
962 int thisDir; /* A directory number */
966 printf("%s: Opening cache directory '%s'\n", rn, directory);
968 if (chmod(directory, 0700)) { /* force it to be 700 */
969 printf("%s: Can't 'chmod 0700' the cache dir, '%s'.\n", rn,
973 cdirp = opendir(directory);
974 if (cdirp == (DIR *) 0) {
975 printf("%s: Can't open AFS cache directory, '%s'.\n", rn, directory);
980 * Scan the directory entries, remembering data cache file inodes
981 * and the existance of other important residents. Recurse into
982 * the data subdirectories.
984 * Delete all files and directories that don't belong here.
986 sprintf(fullpn_FileToDelete, "%s/", directory);
987 fileToDelete = fullpn_FileToDelete + strlen(fullpn_FileToDelete);
990 for (currp = readdir64(cdirp); currp; currp = readdir64(cdirp))
992 for (currp = readdir(cdirp); currp; currp = readdir(cdirp))
996 printf("%s: Current directory entry:\n", rn);
997 #if defined(AFS_SGI62_ENV) || defined(AFS_DARWIN90_ENV)
998 printf("\tinode=%" AFS_INT64_FMT ", reclen=%d, name='%s'\n", currp->d_ino,
999 currp->d_reclen, currp->d_name);
1000 #elif defined(AFS_DFBSD_ENV) || defined(AFS_USR_DFBSD_ENV)
1001 printf("\tinode=%ld, name='%s'\n", (long)currp->d_ino, currp->d_name);
1003 printf("\tinode=%ld, reclen=%d, name='%s'\n", (long)currp->d_ino,
1004 currp->d_reclen, currp->d_name);
1009 * If dirNum < 0, we are a top-level cache directory and should
1010 * only contain sub-directories and other sundry files. Therefore,
1011 * V-files are valid only if dirNum >= 0, and Directories are only
1012 * valid if dirNum < 0.
1015 if (*(currp->d_name) == 'V'
1016 && ((vFileNum = GetVFileNumber(currp->d_name, cacheFiles)) >=
1019 * Found a valid data cache filename. Remember this
1020 * file's inode, directory, and bump the number of files found
1021 * total and in this directory.
1023 #if !defined(AFS_CACHE_VNODE_PATH) && !defined(AFS_LINUX26_ENV)
1024 inode_for_V[vFileNum] = currp->d_ino;
1026 dir_for_V[vFileNum] = dirNum; /* remember this directory */
1029 /* If we're in a real subdir, mark this file to be moved
1030 * if we've already got too many files in this directory
1032 assert(dirNum >= 0);
1033 cache_dir_list[dirNum]++; /* keep directory's file count */
1034 if (cache_dir_list[dirNum] > nFilesPerDir) {
1035 /* Too many files -- add to filelist */
1036 struct afsd_file_list *tmp = (struct afsd_file_list *)
1037 malloc(sizeof(*tmp));
1040 ("%s: MALLOC FAILED allocating file_list entry\n",
1043 tmp->fileNum = vFileNum;
1044 tmp->next = cache_dir_filelist[dirNum];
1045 cache_dir_filelist[dirNum] = tmp;
1050 } else if (dirNum < 0 && (*(currp->d_name) == 'D')
1051 && GetDDirNumber(currp->d_name, 1 << 30) >= 0) {
1053 if ((vFileNum = GetDDirNumber(currp->d_name, maxDir)) >= 0) {
1054 /* Found a valid cachefile sub-Directory. Remember this number
1055 * and recurse into it. Note that subdirs cannot have subdirs.
1058 } else if ((vFileNum = GetDDirNumber(currp->d_name, 1 << 30)) >=
1060 /* This directory is going away, but figure out if there
1061 * are any cachefiles in here that should be saved by
1062 * moving them to other cache directories. This directory
1063 * will be removed later.
1068 /* Save the highest directory number we've seen */
1069 if (vFileNum > highDir)
1072 /* If this directory is staying, be sure to mark it as 'found' */
1074 cache_dir_list[vFileNum] = 0;
1076 /* Print the dirname for recursion */
1077 sprintf(fileToDelete, "%s", currp->d_name);
1079 /* Note: vFileNum is the directory number */
1081 doSweepAFSCache(vFilesFound, fullpn_FileToDelete, vFileNum,
1082 (retval == 1 ? 0 : -1));
1084 printf("%s: Recursive sweep failed on directory %s\n", rn,
1088 } else if (dirNum < 0 && strcmp(currp->d_name, DCACHEFILE) == 0) {
1090 * Found the file holding the dcache entries.
1092 missing_DCacheFile = 0;
1093 SetNoBackupAttr(fullpn_DCacheFile);
1094 } else if (dirNum < 0 && strcmp(currp->d_name, VOLINFOFILE) == 0) {
1096 * Found the file holding the volume info.
1098 missing_VolInfoFile = 0;
1099 SetNoBackupAttr(fullpn_VolInfoFile);
1100 } else if (dirNum < 0 && strcmp(currp->d_name, CELLINFOFILE) == 0) {
1102 * Found the file holding the cell info.
1104 missing_CellInfoFile = 0;
1105 SetNoBackupAttr(fullpn_CellInfoFile);
1106 } else if ((strcmp(currp->d_name, ".") == 0)
1107 || (strcmp(currp->d_name, "..") == 0) ||
1108 #ifdef AFS_DECOSF_ENV
1109 /* these are magic AdvFS files */
1110 (strcmp(currp->d_name, ".tags") == 0)
1111 || (strcmp(currp->d_name, "quota.user") == 0)
1112 || (strcmp(currp->d_name, "quota.group") == 0) ||
1114 #ifdef AFS_LINUX22_ENV
1115 /* this is the ext3 journal file */
1116 (strcmp(currp->d_name, ".journal") == 0) ||
1118 (strcmp(currp->d_name, "lost+found") == 0)) {
1120 * Don't do anything - this file is legit, and is to be left alone.
1124 * This file/directory doesn't belong in the cache. Nuke it.
1126 sprintf(fileToDelete, "%s", currp->d_name);
1128 printf("%s: Deleting '%s'\n", rn, fullpn_FileToDelete);
1129 UnlinkUnwantedFile(rn, fullpn_FileToDelete, fileToDelete);
1136 * Create all the cache files that are missing.
1138 CreateFileIfMissing(fullpn_DCacheFile, missing_DCacheFile);
1139 CreateFileIfMissing(fullpn_VolInfoFile, missing_VolInfoFile);
1140 CreateFileIfMissing(fullpn_CellInfoFile, missing_CellInfoFile);
1142 /* ADJUST CACHE FILES */
1144 /* First, let's walk through the list of files and figure out
1145 * if there are any leftover files in extra directories or
1146 * missing files. Move the former and create the latter in
1147 * subdirs with extra space.
1150 thisDir = 0; /* Keep track of which subdir has space */
1152 for (vFileNum = 0; vFileNum < cacheFiles; vFileNum++) {
1153 if (dir_for_V[vFileNum] == -1) {
1154 /* This file does not exist. Create it in the first
1155 * subdir that still has extra space.
1157 while (thisDir < maxDir
1158 && cache_dir_list[thisDir] >= nFilesPerDir)
1160 if (thisDir >= maxDir)
1161 printf("%s: can't find directory to create V%d\n", rn,
1165 #if !defined(AFS_CACHE_VNODE_PATH) && !defined(AFS_LINUX26_ENV)
1166 assert(inode_for_V[vFileNum] == (AFSD_INO_T) 0);
1168 sprintf(vFilePtr, "D%d/V%d", thisDir, vFileNum);
1170 printf("%s: Creating '%s'\n", rn, fullpn_VFile);
1171 if (cache_dir_list[thisDir] < 0
1172 && CreateCacheSubDir(directory, thisDir))
1173 printf("%s: Can't create directory for '%s'\n", rn,
1175 if (CreateCacheFile(fullpn_VFile, &statb))
1176 printf("%s: Can't create '%s'\n", rn, fullpn_VFile);
1178 #if !defined(AFS_CACHE_VNODE_PATH) && !defined(AFS_LINUX26_ENV)
1179 inode_for_V[vFileNum] = statb.st_ino;
1181 dir_for_V[vFileNum] = thisDir;
1182 cache_dir_list[thisDir]++;
1185 SetNoBackupAttr(fullpn_VFile);
1188 } else if (dir_for_V[vFileNum] >= maxDir
1189 || dir_for_V[vFileNum] == -2) {
1190 /* This file needs to move; move it to the first subdir
1191 * that has extra space. (-2 means it's in the toplevel)
1193 while (thisDir < maxDir
1194 && cache_dir_list[thisDir] >= nFilesPerDir)
1196 if (thisDir >= maxDir)
1197 printf("%s: can't find directory to move V%d\n", rn,
1201 (directory, dir_for_V[vFileNum], thisDir, vFileNum,
1203 /* Cannot move. Ignore this file??? */
1210 /* At this point, we've moved all of the valid cache files
1211 * into the valid subdirs, and created all the extra
1212 * cachefiles we need to create. Next, rebalance any subdirs
1213 * with too many cache files into the directories with not
1214 * enough cache files. Note that thisDir currently sits at
1215 * the lowest subdir that _may_ have room.
1218 for (dirNum = 0; dirNum < maxDir; dirNum++) {
1219 struct afsd_file_list *thisFile;
1221 for (thisFile = cache_dir_filelist[dirNum];
1222 thisFile && cache_dir_list[dirNum] >= nFilesPerDir;
1223 thisFile = thisFile->next) {
1224 while (thisDir < maxDir
1225 && cache_dir_list[thisDir] >= nFilesPerDir)
1227 if (thisDir >= maxDir)
1228 printf("%s: can't find directory to move V%d\n", rn,
1232 (directory, dirNum, thisDir, thisFile->fileNum,
1234 /* Cannot move. Ignore this file??? */
1238 } /* for each file to move */
1239 } /* for each directory */
1241 /* Remove any directories >= maxDir -- they should be empty */
1242 for (; highDir >= maxDir; highDir--) {
1243 sprintf(fileToDelete, "D%d", highDir);
1244 UnlinkUnwantedFile(rn, fullpn_FileToDelete, fileToDelete);
1250 * Close the directory, return success.
1253 printf("%s: Closing cache directory.\n", rn);
1259 CheckCacheBaseDir(char *dir)
1261 struct stat statbuf;
1264 return "cache base dir not specified";
1266 if (stat(dir, &statbuf) != 0) {
1267 return "unable to stat cache base directory";
1270 /* might want to check here for anything else goofy, like cache pointed at a non-dedicated directory, etc */
1272 #ifdef AFS_LINUX24_ENV
1275 struct statfs statfsbuf;
1277 res = statfs(dir, &statfsbuf);
1279 return "unable to statfs cache base directory";
1281 #if !defined(AFS_LINUX26_ENV)
1282 if (statfsbuf.f_type == 0x52654973) { /* REISERFS_SUPER_MAGIC */
1283 return "cannot use reiserfs as cache partition";
1284 } else if (statfsbuf.f_type == 0x58465342) { /* XFS_SUPER_MAGIC */
1285 return "cannot use xfs as cache partition";
1286 } else if (statfsbuf.f_type == 0x01021994) { /* TMPFS_SUPER_MAGIC */
1287 return "cannot use tmpfs as cache partition";
1288 } else if (statfsbuf.f_type != 0xEF53) {
1289 return "must use ext2 or ext3 for cache partition";
1298 struct statfs statfsbuf;
1301 res = statfs(dir, &statfsbuf);
1303 return "unable to statfs cache base directory";
1306 if (sysfs(GETFSTYP, statfsbuf.f_fsid[1], name) != 0) {
1307 return "unable to determine filesystem type for cache base dir";
1310 if (strcmp(name, "hfs")) {
1311 return "can only use hfs filesystem for cache partition on hpux";
1320 struct stat statmnt, statci;
1322 if ((stat(dir, &statci) == 0)
1323 && ((vfstab = fopen(MNTTAB, "r")) != NULL)) {
1324 while (getmntent(vfstab, &mnt) == 0) {
1325 if (strcmp(dir, mnt.mnt_mountp) != 0) {
1329 if (cp = hasmntopt(&mnt, "dev="))
1331 (int)strtol(cp + strlen("dev="), (char **)NULL,
1334 if ((rdev == 0) && (stat(mnt.mnt_mountp, &statmnt) == 0))
1335 rdev = statmnt.st_dev;
1337 if ((rdev == statci.st_dev)
1338 && (hasmntopt(&mnt, "logging") != NULL)) {
1342 "mounting a multi-use partition which contains the AFS cache with the\n\"logging\" option may deadlock your system.\n\n";
1356 SweepAFSCache(int *vFilesFound)
1358 static char rn[] = "SweepAFSCache"; /*Routine name */
1359 int maxDir = (cacheFiles + nFilesPerDir - 1) / nFilesPerDir;
1364 if (cacheFlags & AFSCALL_INIT_MEMCACHE) {
1366 printf("%s: Memory Cache, no cache sweep done\n", rn);
1370 if (cache_dir_list == NULL) {
1371 cache_dir_list = (int *)malloc(maxDir * sizeof(*cache_dir_list));
1372 if (cache_dir_list == NULL) {
1373 printf("%s: Malloc Failed!\n", rn);
1376 for (i = 0; i < maxDir; i++)
1377 cache_dir_list[i] = -1; /* Does not exist */
1380 if (cache_dir_filelist == NULL) {
1381 cache_dir_filelist = (struct afsd_file_list **)
1382 malloc(maxDir * sizeof(*cache_dir_filelist));
1383 if (cache_dir_filelist == NULL) {
1384 printf("%s: Malloc Failed!\n", rn);
1387 memset(cache_dir_filelist, 0, maxDir * sizeof(*cache_dir_filelist));
1390 if (dir_for_V == NULL) {
1391 dir_for_V = (int *)malloc(cacheFiles * sizeof(*dir_for_V));
1392 if (dir_for_V == NULL) {
1393 printf("%s: Malloc Failed!\n", rn);
1396 for (i = 0; i < cacheFiles; i++)
1397 dir_for_V[i] = -1; /* Does not exist */
1400 /* Note, setting dirNum to -2 here will cause cachefiles found in
1401 * the toplevel directory to be marked in directory "-2". This
1402 * allows us to differentiate between 'file not seen' (-1) and
1403 * 'file seen in top-level' (-2). Then when we try to move the
1404 * file into a subdirectory, we know it's in the top-level instead
1405 * of some other cache subdir.
1407 return doSweepAFSCache(vFilesFound, cacheBaseDir, -2, maxDir);
1411 ConfigCell(struct afsconf_cell *aci, void *arock, struct afsconf_dir *adir)
1415 afs_int32 cellFlags = 0;
1416 afs_int32 hosts[MAXHOSTSPERCELL];
1418 /* figure out if this is the home cell */
1419 isHomeCell = (strcmp(aci->name, LclCellName) == 0);
1421 cellFlags = 2; /* not home, suid is forbidden */
1422 if (enable_dynroot == 2)
1423 cellFlags |= 8; /* don't display foreign cells until looked up */
1425 /* build address list */
1426 for (i = 0; i < MAXHOSTSPERCELL; i++)
1427 memcpy(&hosts[i], &aci->hostAddr[i].sin_addr, sizeof(afs_int32));
1429 if (aci->linkedCell)
1430 cellFlags |= 4; /* Flag that linkedCell arg exists,
1431 * for upwards compatibility */
1433 /* configure one cell */
1434 code = afsd_call_syscall(AFSOP_ADDCELL2, hosts, /* server addresses */
1435 aci->name, /* cell name */
1436 cellFlags, /* is this the home cell? */
1437 aci->linkedCell); /* Linked cell, if any */
1439 printf("Adding cell '%s': error %d\n", aci->name, code);
1444 ConfigCellAlias(struct afsconf_cellalias *aca,
1445 void *arock, struct afsconf_dir *adir)
1447 /* push the alias into the kernel */
1448 afsd_call_syscall(AFSOP_ADDCELLALIAS, aca->aliasName, aca->realName);
1453 AfsdbLookupHandler(void)
1455 afs_int32 kernelMsg[64];
1456 char acellName[128];
1458 struct afsconf_cell acellInfo;
1463 acellName[0] = '\0';
1465 #ifdef AFS_DARWIN_ENV
1466 /* Fork the event handler also. */
1469 afsd_install_events();
1471 } else if (code != -1) {
1476 /* On some platforms you only get 4 args to an AFS call */
1477 int sizeArg = ((sizeof acellName) << 16) | (sizeof kernelMsg);
1479 afsd_call_syscall(AFSOP_AFSDB_HANDLER, acellName, kernelMsg, sizeArg);
1480 if (code) { /* Something is wrong? */
1485 if (*acellName == 1) /* Shutting down */
1488 code = afsconf_GetAfsdbInfo(acellName, 0, &acellInfo);
1493 kernelMsg[0] = acellInfo.numServers;
1494 if (acellInfo.timeout)
1495 kernelMsg[1] = acellInfo.timeout - time(0);
1498 for (i = 0; i < acellInfo.numServers; i++)
1499 kernelMsg[i + 2] = acellInfo.hostAddr[i].sin_addr.s_addr;
1500 strncpy(acellName, acellInfo.name, sizeof(acellName));
1501 acellName[sizeof(acellName) - 1] = '\0';
1504 #ifdef AFS_DARWIN_ENV
1505 kill(event_pid, SIGTERM);
1509 #ifdef AFS_DARWIN_ENV
1514 struct afs_uspc_param *uspc;
1518 uspc = (struct afs_uspc_param *)malloc(sizeof(struct afs_uspc_param));
1519 memset(uspc, 0, sizeof(struct afs_uspc_param));
1520 memset(srcName, 0, sizeof(srcName));
1521 memset(dstName, 0, sizeof(dstName));
1523 /* brscount starts at 0 */
1529 char srcpath[BUFSIZ];
1530 char dstpath[BUFSIZ];
1532 /* pushing in a buffer this large */
1535 code = afsd_call_syscall(AFSOP_BKG_HANDLER, uspc, srcName, dstName);
1536 if (code) { /* Something is wrong? */
1537 if (code == -2) /* shutting down */
1545 switch (uspc->reqtype) {
1547 snprintf(srcpath, BUFSIZ, "/afs/.:mount/%d:%d:%d:%d/%s",
1548 uspc->req.umv.sCell, uspc->req.umv.sVolume,
1549 uspc->req.umv.sVnode, uspc->req.umv.sUnique, srcName);
1550 snprintf(dstpath, BUFSIZ, "/afs/.:mount/%d:%d:%d:%d/%s",
1551 uspc->req.umv.dCell, uspc->req.umv.dVolume,
1552 uspc->req.umv.dVnode, uspc->req.umv.dUnique, dstName);
1553 if ((child = fork()) == 0) {
1554 /* first child does cp; second, rm. mv would re-enter. */
1556 switch (uspc->req.umv.idtype) {
1558 if (setuid(uspc->req.umv.id) != 0) {
1564 break; /* notreached */
1566 execl("/bin/cp", "(afsd EXDEV helper)", "-PRp", "--", srcpath,
1567 dstpath, (char *) NULL);
1569 if (child == (pid_t) -1) {
1574 if (waitpid(child, &status, 0) == -1)
1576 else if (WIFEXITED(status) != 0 && WEXITSTATUS(status) == 0) {
1577 if ((child = fork()) == 0) {
1578 switch (uspc->req.umv.idtype) {
1580 if (setuid(uspc->req.umv.id) != 0) {
1586 break; /* notreached */
1588 execl("/bin/rm", "(afsd EXDEV helper)", "-rf", "--",
1589 srcpath, (char *) NULL);
1591 if (child == (pid_t) -1) {
1595 if (waitpid(child, &status, 0) == -1)
1597 else if (WIFEXITED(status) != 0) {
1598 /* rm exit status */
1599 uspc->retval = WEXITSTATUS(status);
1601 /* rm signal status */
1602 uspc->retval = -(WTERMSIG(status));
1605 /* error from cp: exit or signal status */
1606 uspc->retval = (WIFEXITED(status) != 0) ?
1607 WEXITSTATUS(status) : -(WTERMSIG(status));
1609 memset(srcName, 0, sizeof(srcName));
1610 memset(dstName, 0, sizeof(dstName));
1614 /* unknown req type */
1623 afsdb_thread(void *rock)
1625 /* Since the AFSDB lookup handler runs as a user process,
1626 * need to drop the controlling TTY, etc.
1628 if (afsd_daemon(0, 0) == -1) {
1629 printf("Error starting AFSDB lookup handler: %s\n",
1633 AfsdbLookupHandler();
1638 daemon_thread(void *rock)
1640 #ifdef AFS_DARWIN80_ENV
1641 /* Since the background daemon runs as a user process,
1642 * need to drop the controlling TTY, etc.
1644 if (afsd_daemon(0, 0) == -1) {
1645 printf("Error starting background daemon: %s\n",
1650 #elif defined(AFS_AIX32_ENV)
1651 afsd_call_syscall(AFSOP_START_BKG, 0);
1653 afsd_call_syscall(AFSOP_START_BKG);
1660 rmtsysd_thread(void *rock)
1665 #endif /* !UKERNEL */
1668 mainproc(struct cmd_syndesc *as, void *arock)
1670 afs_int32 code; /*Result of fork() */
1674 #ifdef AFS_SGI65_ENV
1675 struct sched_param sp;
1678 #ifdef AFS_SGI_VNODE_GLUE
1679 if (afs_init_kernel_config(-1) < 0) {
1680 printf("Can't determine NUMA configuration, not starting AFS.\n");
1685 /* call atoi on the appropriate parsed results */
1686 if (as->parms[0].items) {
1688 cacheBlocks = atoi(as->parms[0].items->data);
1691 if (as->parms[1].items) {
1693 cacheFiles = atoi(as->parms[1].items->data);
1694 filesSet = 1; /* set when spec'd on cmd line */
1696 if (as->parms[2].items) {
1698 strcpy(rootVolume, as->parms[2].items->data);
1701 if (as->parms[3].items) {
1703 cacheStatEntries = atoi(as->parms[3].items->data);
1704 sawCacheStatEntries = 1;
1706 if (as->parms[4].items) {
1708 cacheBaseDir[0] = '\0';
1709 sawCacheBaseDir = 1;
1710 cacheFlags |= AFSCALL_INIT_MEMCACHE;
1712 if (as->parms[5].items) {
1714 strcpy(cacheBaseDir, as->parms[5].items->data);
1715 sawCacheBaseDir = 1;
1717 if (as->parms[6].items) {
1719 strcpy(afsd_cacheMountDir, as->parms[6].items->data);
1720 sawCacheMountDir = 1;
1722 if (as->parms[7].items) {
1724 nDaemons = atoi(as->parms[7].items->data);
1726 if (as->parms[8].items) {
1730 if (as->parms[9].items) {
1734 if (as->parms[10].items) {
1738 printf("-rmtsys not supported for UKERNEL\n");
1742 if (as->parms[11].items) {
1747 if (as->parms[12].items) {
1749 chunkSize = atoi(as->parms[12].items->data);
1750 if (chunkSize < 0 || chunkSize > 30) {
1752 ("afsd:invalid chunk size (not in range 0-30), using default\n");
1756 if (as->parms[13].items) {
1758 dCacheSize = atoi(as->parms[13].items->data);
1761 if (as->parms[14].items) {
1763 vCacheSize = atoi(as->parms[14].items->data);
1765 if (as->parms[15].items) {
1767 #ifndef AFS_AIX32_ENV
1769 ("afsd: [-biods] currently only enabled for aix3.x VM supported systems\n");
1771 nBiods = atoi(as->parms[15].items->data);
1775 if (as->parms[16].items) {
1777 preallocs = atoi(as->parms[16].items->data);
1779 strcpy(confDir, AFSDIR_CLIENT_ETC_DIRPATH);
1780 if (as->parms[17].items) {
1782 strcpy(confDir, as->parms[17].items->data);
1784 sprintf(fullpn_CacheInfo, "%s/%s", confDir, CACHEINFOFILE);
1785 if (as->parms[18].items) {
1787 printf("afsd: Ignoring obsolete -logfile flag\n");
1789 if (as->parms[19].items) {
1791 afsd_CloseSynch = 1;
1793 if (as->parms[20].items) {
1797 * Cold shutdown is the default
1799 printf("afsd: Shutting down all afs processes and afs state\n");
1800 code = afsd_call_syscall(AFSOP_SHUTDOWN, 1);
1802 printf("afsd: AFS still mounted; Not shutting down\n");
1807 if (as->parms[21].items) {
1808 /* -enable_peer_stats */
1809 enable_peer_stats = 1;
1811 if (as->parms[22].items) {
1812 /* -enable_process_stats */
1813 enable_process_stats = 1;
1815 if (as->parms[23].items) {
1816 /* -mem_alloc_sleep */
1817 printf("afsd: -mem_alloc_sleep is deprecated -- ignored\n");
1819 if (as->parms[24].items) {
1823 if (as->parms[25].items) {
1824 /* -files_per_subdir */
1825 int res = atoi(as->parms[25].items->data);
1826 if (res < 10 || res > (1 << 30)) {
1828 ("afsd:invalid number of files per subdir, \"%s\". Ignored\n",
1829 as->parms[25].items->data);
1834 if (as->parms[26].items) {
1838 if (as->parms[27].items) {
1840 enable_fakestat = 2;
1842 if (as->parms[28].items) {
1844 enable_fakestat = 1;
1846 if (as->parms[29].items) {
1850 if (as->parms[30].items) {
1852 enable_backuptree = 1;
1854 if (as->parms[31].items) {
1858 if (as->parms[32].items) {
1863 /* set rx_extraPackets */
1864 if (as->parms[33].items) {
1866 int rxpck = atoi(as->parms[33].items->data);
1867 printf("afsd: set rxpck = %d\n", rxpck);
1868 code = afsd_call_syscall(AFSOP_SET_RXPCK, rxpck);
1870 printf("afsd: failed to set rxpck\n");
1874 if (as->parms[34].items) {
1876 if (!as->parms[34].items->data ||
1877 ((c = strchr(as->parms[34].items->data, '/')) == NULL))
1879 ("ignoring splitcache (specify as RW/RO percentages: 60/40)\n");
1881 ropct = atoi((char *)c + 1);
1883 rwpct = atoi((char *)as->parms[30].items->data);
1884 if ((rwpct != 0) && (ropct != 0) && (ropct + rwpct == 100)) {
1886 enable_splitcache = 1;
1890 if (as->parms[35].items) {
1891 #ifdef AFS_MAXVCOUNT_ENV
1892 /* -disable-dynamic-vcaches */
1893 afsd_dynamic_vcaches = 0;
1895 printf("afsd: Error toggling flag, dynamically allocated vcaches not supported on your platform\n");
1899 #ifdef AFS_MAXVCOUNT_ENV
1901 /* -dynamic-vcaches */
1902 afsd_dynamic_vcaches = 1;
1906 printf("afsd: %s dynamically allocated vcaches\n", ( afsd_dynamic_vcaches ? "enabling" : "disabling" ));
1910 if (as->parms[36].items) {
1912 rxmaxmtu = atoi(as->parms[36].items->data);
1914 if (as->parms[37].items) {
1915 /* -dynroot-sparse */
1924 static char rn[] = "afsd"; /*Name of this routine */
1925 struct afsconf_dir *cdir; /* config dir */
1926 int lookupResult; /*Result of GetLocalCellName() */
1928 afs_int32 code; /*Result of fork() */
1929 char *fsTypeMsg = NULL;
1930 int cacheIteration; /*How many times through cache verification */
1931 int vFilesFound; /*How many data cache files were found in sweep */
1932 int currVFile; /*Current AFS cache file number passed in */
1935 * Pull out all the configuration info for the workstation's AFS cache and
1936 * the cellular community we're willing to let our users see.
1938 cdir = afsconf_Open(confDir);
1940 printf("afsd: some file missing or bad in %s\n", confDir);
1945 afsconf_GetLocalCell(cdir, LclCellName, sizeof(LclCellName));
1947 printf("%s: Can't get my home cell name! [Error is %d]\n", rn,
1951 printf("%s: My home cell is '%s'\n", rn, LclCellName);
1954 /* parse cacheinfo file if this is a diskcache */
1955 if (ParseCacheInfoFile()) {
1959 /* do some random computations in memcache case to get things to work
1960 * reasonably no matter which parameters you set.
1962 if (cacheFlags & AFSCALL_INIT_MEMCACHE) {
1963 /* memory cache: size described either as blocks or dcache entries, but
1967 fprintf(stderr, "%s: -files ignored with -memcache\n", rn);
1969 if (sawDCacheSize) {
1970 if (chunkSize == 0) {
1971 chunkSize = 13; /* 8k default chunksize for memcache */
1973 if (sawCacheBlocks) {
1975 ("%s: can't set cache blocks and dcache size simultaneously when diskless.\n",
1979 /* compute the cache size based on # of chunks times the chunk size */
1980 i = (1 << chunkSize); /* bytes per chunk */
1981 cacheBlocks = i * dCacheSize;
1982 sawCacheBlocks = 1; /* so that ParseCacheInfoFile doesn't overwrite */
1984 if (chunkSize == 0) {
1985 /* Try to autotune the memcache chunksize based on size
1986 * of memcache. This is done on the assumption that approx
1987 * 1024 chunks is suitable, it's a balance between enough
1988 * chunks to be useful and ramping up nicely when using larger
1989 * memcache to improve bulk read/write performance
1992 i <= 21 && (1 << i) / 1024 < (cacheBlocks / 1024); i++);
1995 /* compute the dcache size from overall cache size and chunk size */
1996 if (chunkSize > 10) {
1997 dCacheSize = (cacheBlocks >> (chunkSize - 10));
1998 } else if (chunkSize < 10) {
1999 dCacheSize = (cacheBlocks << (10 - chunkSize));
2001 dCacheSize = cacheBlocks;
2003 /* don't have to set sawDCacheSize here since it isn't overwritten
2004 * by ParseCacheInfoFile.
2008 printf("%s: chunkSize autotuned to %d\n", rn, chunkSize);
2010 /* kernel computes # of dcache entries as min of cacheFiles and
2011 * dCacheSize, so we now make them equal.
2013 cacheFiles = dCacheSize;
2016 * Compute the number of cache files based on cache size,
2017 * but only if -files isn't given on the command line.
2018 * Don't let # files be so small as to prevent full utilization
2019 * of the cache unless user has explicitly asked for it.
2021 if (chunkSize == 0) {
2022 /* Set chunksize to 256kB - 1MB depending on cache size */
2023 if (cacheBlocks < 500000) {
2025 } else if (cacheBlocks < 1000000) {
2032 cacheFiles = cacheBlocks / 32; /* Assume 32k avg filesize */
2034 cacheFiles = max(cacheFiles, 1000);
2036 /* Always allow more files than chunks. Presume average V-file
2037 * is ~67% of a chunk... (another guess, perhaps Honeyman will
2038 * have a grad student write a paper). i is KILOBYTES.
2040 i = 1 << (chunkSize < 10 ? 0 : chunkSize - 10);
2041 cacheFiles = max(cacheFiles, 1.5 * (cacheBlocks / i));
2043 /* never permit more files than blocks, while leaving space for
2044 * VolumeInfo and CacheItems files. VolumeInfo is usually 20K,
2045 * CacheItems is 50 Bytes / file (== 1K/20)
2047 #define CACHEITMSZ (cacheFiles / 20)
2048 #define VOLINFOSZ 50 /* 40kB has been seen, be conservative */
2049 #define CELLINFOSZ 4 /* Assuming disk block size is 4k ... */
2050 #define INFOSZ (VOLINFOSZ+CELLINFOSZ+CACHEITMSZ)
2052 /* Sanity check: If the obtained number of disk cache files
2053 * is larger than the number of available (4k) disk blocks, we're
2054 * doing something wrong. Fail hard so we can fix the bug instead
2055 * of silently hiding it like before */
2057 if (cacheFiles > (cacheBlocks - INFOSZ) / 4) {
2059 "%s: ASSERT: cacheFiles %d diskblocks %d\n",
2060 rn, cacheFiles, (cacheBlocks - INFOSZ) / 4);
2063 if (cacheFiles < 100)
2064 fprintf(stderr, "%s: WARNING: cache probably too small!\n",
2068 printf("%s: cacheFiles autotuned to %d\n", rn, cacheFiles);
2071 /* This actually needs to
2073 2) not second-guess when a chunksize comes from the command line
2074 3) be less, um, small. 2^2??
2076 /* Sanity check chunkSize */
2077 i = max(cacheBlocks / 1000, cacheBlocks / cacheFiles);
2078 chunkSize = min(chunkSize, i);
2079 chunkSize = max(chunkSize, 2);
2081 printf("%s: chunkSize autotuned to %d\n", rn, chunkSize);
2084 if (!sawDCacheSize) {
2085 dCacheSize = cacheFiles / 2;
2086 if (dCacheSize > 10000) {
2089 if (dCacheSize < 2000) {
2093 printf("%s: dCacheSize autotuned to %d\n", rn, dCacheSize);
2096 if (!sawCacheStatEntries) {
2097 if (chunkSize <= 13) {
2098 cacheStatEntries = dCacheSize / 4;
2099 } else if (chunkSize >= 16) {
2100 cacheStatEntries = dCacheSize * 1.5;
2102 cacheStatEntries = dCacheSize;
2105 printf("%s: cacheStatEntries autotuned to %d\n", rn,
2109 #if !defined(AFS_CACHE_VNODE_PATH) && !defined(AFS_LINUX26_ENV)
2111 * Create and zero the inode table for the desired cache files.
2113 inode_for_V = (AFSD_INO_T *) malloc(cacheFiles * sizeof(AFSD_INO_T));
2114 if (inode_for_V == (AFSD_INO_T *) 0) {
2116 ("%s: malloc() failed for cache file inode table with %d entries.\n",
2120 memset(inode_for_V, '\0', (cacheFiles * sizeof(AFSD_INO_T)));
2122 printf("%s: %d inode_for_V entries at 0x%x, %lu bytes\n", rn,
2123 cacheFiles, inode_for_V, (cacheFiles * sizeof(AFSD_INO_T)));
2127 * Set up all the pathnames we'll need for later.
2129 sprintf(fullpn_DCacheFile, "%s/%s", cacheBaseDir, DCACHEFILE);
2130 sprintf(fullpn_VolInfoFile, "%s/%s", cacheBaseDir, VOLINFOFILE);
2131 sprintf(fullpn_CellInfoFile, "%s/%s", cacheBaseDir, CELLINFOFILE);
2132 sprintf(fullpn_VFile, "%s/", cacheBaseDir);
2133 vFilePtr = fullpn_VFile + strlen(fullpn_VFile);
2135 if (!(cacheFlags & AFSCALL_INIT_MEMCACHE)
2136 && (fsTypeMsg = CheckCacheBaseDir(cacheBaseDir))) {
2138 printf("%s: WARNING: Cache dir check failed (%s)\n", rn, fsTypeMsg);
2140 printf("%s: ERROR: Cache dir check failed (%s)\n", rn, fsTypeMsg);
2146 * Set up all the kernel processes needed for AFS.
2149 setpgrp(getpid(), 0);
2153 * Set the primary cell name.
2155 afsd_call_syscall(AFSOP_SET_THISCELL, LclCellName);
2157 /* Initialize RX daemons and services */
2159 /* initialize the rx random number generator from user space */
2161 /* parse multihomed address files */
2162 afs_uint32 addrbuf[MAXIPADDRS], maskbuf[MAXIPADDRS],
2166 parseNetFiles(addrbuf, maskbuf, mtubuf, MAXIPADDRS, reason,
2167 AFSDIR_CLIENT_NETINFO_FILEPATH,
2168 AFSDIR_CLIENT_NETRESTRICT_FILEPATH);
2171 code = code | 0x80000000;
2172 afsd_call_syscall(AFSOP_ADVISEADDR, code, addrbuf, maskbuf, mtubuf);
2174 printf("ADVISEADDR: Error in specifying interface addresses:%s\n",
2178 /* Set realtime priority for most threads to same as for biod's. */
2179 afsd_set_afsd_rtpri();
2181 #ifdef AFS_SGI53_ENV
2182 #ifdef AFS_SGI61_ENV
2184 #else /* AFS_SGI61_ENV */
2185 code = get_nfsstaticaddr();
2187 afsd_call_syscall(AFSOP_NFSSTATICADDR, code);
2188 #endif /* AFS_SGI61_ENV */
2189 #endif /* AFS_SGI_53_ENV */
2191 /* Start listener, then callback listener. Lastly, start rx event daemon.
2192 * Change in ordering is so that Linux port has socket fd in listener
2194 * preallocs are passed for both listener and callback server. Only
2195 * the one which actually does the initialization uses them though.
2197 if (preallocs < cacheStatEntries + 50)
2198 preallocs = cacheStatEntries + 50;
2199 #ifdef RXK_LISTENER_ENV
2201 printf("%s: Forking rx listener daemon.\n", rn);
2202 # ifdef AFS_SUN510_ENV
2203 fork_rx_syscall_wait(rn, AFSOP_RXLISTENER_DAEMON, preallocs,
2204 enable_peer_stats, enable_process_stats);
2205 # else /* !AFS_SUN510_ENV */
2206 fork_rx_syscall(rn, AFSOP_RXLISTENER_DAEMON, preallocs, enable_peer_stats,
2207 enable_process_stats);
2208 # endif /* !AFS_SUN510_ENV */
2211 printf("%s: Forking rx callback listener.\n", rn);
2212 fork_syscall(rn, AFSOP_START_RXCALLBACK, preallocs);
2213 #if defined(AFS_SUN5_ENV) || defined(RXK_LISTENER_ENV)
2215 printf("%s: Forking rxevent daemon.\n", rn);
2216 fork_rx_syscall(rn, AFSOP_RXEVENT_DAEMON);
2221 printf("%s: Forking AFSDB lookup handler.\n", rn);
2222 afsd_fork(0, afsdb_thread, NULL);
2224 code = afsd_call_syscall(AFSOP_BASIC_INIT, 1);
2226 printf("%s: Error %d in basic initialization.\n", rn, code);
2231 * Tell the kernel some basic information about the workstation's cache.
2235 ("%s: Calling AFSOP_CACHEINIT: %d stat cache entries, %d optimum cache files, %d blocks in the cache, flags = 0x%x, dcache entries %d\n",
2236 rn, cacheStatEntries, cacheFiles, cacheBlocks, cacheFlags,
2238 memset(&cparams, '\0', sizeof(cparams));
2239 cparams.cacheScaches = cacheStatEntries;
2240 cparams.cacheFiles = cacheFiles;
2241 cparams.cacheBlocks = cacheBlocks;
2242 cparams.cacheDcaches = dCacheSize;
2243 cparams.cacheVolumes = vCacheSize;
2244 cparams.chunkSize = chunkSize;
2245 cparams.setTimeFlag = cacheSetTime;
2246 cparams.memCacheFlag = cacheFlags;
2247 cparams.dynamic_vcaches = afsd_dynamic_vcaches;
2248 afsd_call_syscall(AFSOP_CACHEINIT, &cparams);
2250 /* do it before we init the cache inodes */
2251 if (enable_splitcache) {
2252 afsd_call_syscall(AFSOP_BUCKETPCT, 1, rwpct);
2253 afsd_call_syscall(AFSOP_BUCKETPCT, 2, ropct);
2256 if (afsd_CloseSynch)
2257 afsd_call_syscall(AFSOP_CLOSEWAIT);
2260 * Sweep the workstation AFS cache directory, remembering the inodes of
2261 * valid files and deleting extraneous files. Keep sweeping until we
2262 * have the right number of data cache files or we've swept too many
2265 * This also creates files in the cache directory like VolumeItems and
2266 * CellItems, and thus must be ran before those are sent to the kernel.
2269 printf("%s: Sweeping workstation's AFS cache directory.\n", rn);
2271 /* Memory-cache based system doesn't need any of this */
2272 if (!(cacheFlags & AFSCALL_INIT_MEMCACHE)) {
2275 if (SweepAFSCache(&vFilesFound)) {
2276 printf("%s: Error on sweep %d of workstation AFS cache \
2277 directory.\n", rn, cacheIteration);
2282 ("%s: %d out of %d data cache files found in sweep %d.\n",
2283 rn, vFilesFound, cacheFiles, cacheIteration);
2284 } while ((vFilesFound < cacheFiles)
2285 && (cacheIteration < MAX_CACHE_LOOPS));
2286 } else if (afsd_verbose)
2287 printf("%s: Using memory cache, not swept\n", rn);
2290 * Pass the kernel the name of the workstation cache file holding the
2294 printf("%s: Calling AFSOP_CACHEINFO: dcache file is '%s'\n", rn,
2296 /* once again, meaningless for a memory-based cache. */
2297 if (!(cacheFlags & AFSCALL_INIT_MEMCACHE))
2298 afsd_call_syscall(AFSOP_CACHEINFO, fullpn_DCacheFile);
2301 * Pass the kernel the name of the workstation cache file holding the
2305 printf("%s: Calling AFSOP_CELLINFO: cell info file is '%s'\n", rn,
2306 fullpn_CellInfoFile);
2307 afsd_call_syscall(AFSOP_CELLINFO, fullpn_CellInfoFile);
2311 printf("%s: Setting rxmaxmtu in kernel = %d\n", rn, rxmaxmtu);
2312 code = afsd_call_syscall(AFSOP_SET_RXMAXMTU, rxmaxmtu);
2314 printf("%s: Error seting rxmaxmtu\n", rn);
2317 if (enable_dynroot) {
2319 printf("%s: Enabling dynroot support in kernel%s.\n", rn,
2320 (enable_dynroot==2)?", not showing cells.":"");
2321 code = afsd_call_syscall(AFSOP_SET_DYNROOT, 1);
2323 printf("%s: Error enabling dynroot support.\n", rn);
2326 if (enable_fakestat) {
2328 printf("%s: Enabling fakestat support in kernel%s.\n", rn,
2329 (enable_fakestat==2)?" for all mountpoints."
2330 :" for crosscell mountpoints");
2331 code = afsd_call_syscall(AFSOP_SET_FAKESTAT, enable_fakestat);
2333 printf("%s: Error enabling fakestat support.\n", rn);
2336 if (enable_backuptree) {
2338 printf("%s: Enabling backup tree support in kernel.\n", rn);
2339 code = afsd_call_syscall(AFSOP_SET_BACKUPTREE, enable_backuptree);
2341 printf("%s: Error enabling backup tree support.\n", rn);
2345 * Tell the kernel about each cell in the configuration.
2347 afsconf_CellApply(cdir, ConfigCell, NULL);
2348 afsconf_CellAliasApply(cdir, ConfigCellAlias, NULL);
2350 /* Initialize AFS daemon threads. */
2352 printf("%s: Forking AFS daemon.\n", rn);
2353 fork_syscall(rn, AFSOP_START_AFS);
2356 printf("%s: Forking Check Server Daemon.\n", rn);
2357 fork_syscall(rn, AFSOP_START_CS);
2360 printf("%s: Forking %d background daemons.\n", rn, nDaemons);
2361 #if defined(AFS_SGI_ENV) && defined(AFS_SGI_SHORTSTACK)
2362 /* Add one because for sgi we always "steal" the first daemon for a
2363 * different task if we only have a 4K stack.
2367 for (i = 0; i < nDaemons; i++) {
2368 afsd_fork(0, daemon_thread, NULL);
2370 #ifdef AFS_AIX32_ENV
2372 nBiods = nDaemons * 2;
2375 for (i = 0; i < nBiods; i++) {
2376 fork_syscall(rn, AFSOP_START_BKG, nBiods);
2381 * If the root volume has been explicitly set, tell the kernel.
2385 printf("%s: Calling AFSOP_ROOTVOLUME with '%s'\n", rn,
2387 afsd_call_syscall(AFSOP_ROOTVOLUME, rootVolume);
2391 * Pass the kernel the name of the workstation cache file holding the
2392 * volume information.
2395 printf("%s: Calling AFSOP_VOLUMEINFO: volume info file is '%s'\n", rn,
2396 fullpn_VolInfoFile);
2397 /* once again, meaningless for a memory-based cache. */
2398 if (!(cacheFlags & AFSCALL_INIT_MEMCACHE))
2399 afsd_call_syscall(AFSOP_VOLUMEINFO, fullpn_VolInfoFile);
2402 * Give the kernel the names of the AFS files cached on the workstation's
2407 ("%s: Calling AFSOP_CACHEFILE for each of the %d files in '%s'\n",
2408 rn, cacheFiles, cacheBaseDir);
2409 if (!(cacheFlags & AFSCALL_INIT_MEMCACHE)) {
2410 /* ... and again ... */
2411 int nocachefile = 0;
2412 for (currVFile = 0; currVFile < cacheFiles; currVFile++) {
2414 sprintf(fullpn_VFile, "%s/D%d/V%d", cacheBaseDir, dir_for_V[currVFile], currVFile);
2415 code = afsd_call_syscall(AFSOP_CACHEFILE, fullpn_VFile);
2417 if (currVFile == 0) {
2420 ("%s: Calling AFSOP_CACHEINODE for each of the %d files in '%s'\n",
2421 rn, cacheFiles, cacheBaseDir);
2425 ("%s: Error calling AFSOP_CACHEFILE for '%s'\n",
2432 /* fall through to setup-by-inode */
2434 #ifdef AFS_SGI62_ENV
2435 afsd_call_syscall(AFSOP_CACHEINODE,
2436 (afs_uint32) (inode_for_V[currVFile] >> 32),
2437 (afs_uint32) (inode_for_V[currVFile] & 0xffffffff));
2438 #elif !(defined(AFS_LINUX26_ENV) || defined(AFS_CACHE_VNODE_PATH))
2439 afsd_call_syscall(AFSOP_CACHEINODE, inode_for_V[currVFile]);
2442 ("%s: Error calling AFSOP_CACHEINODE: not configured\n",
2450 * All the necessary info has been passed into the kernel to run an AFS
2451 * system. Give the kernel our go-ahead.
2454 printf("%s: Calling AFSOP_GO with cacheSetTime = %d\n", rn,
2456 afsd_call_syscall(AFSOP_GO, cacheSetTime);
2459 * At this point, we have finished passing the kernel all the info
2460 * it needs to set up the AFS. Mount the AFS root.
2462 printf("%s: All AFS daemons started.\n", rn);
2465 printf("%s: Forking trunc-cache daemon.\n", rn);
2466 fork_syscall(rn, AFSOP_START_TRUNCDAEMON);
2468 if (!enable_nomount) {
2469 afsd_mount_afs(rn, afsd_cacheMountDir);
2475 printf("%s: Forking 'rmtsys' daemon.\n", rn);
2476 afsd_fork(0, rmtsysd_thread, NULL);
2478 #endif /* !UKERNEL */
2480 * Exit successfully.
2485 #include "AFS_component_version_number.c"
2490 struct cmd_syndesc *ts;
2492 ts = cmd_CreateSyntax(NULL, mainproc, NULL, "start AFS");
2495 cmd_AddParm(ts, "-blocks", CMD_SINGLE, CMD_OPTIONAL,
2496 "1024 byte blocks in cache");
2497 cmd_AddParm(ts, "-files", CMD_SINGLE, CMD_OPTIONAL, "files in cache");
2498 cmd_AddParm(ts, "-rootvol", CMD_SINGLE, CMD_OPTIONAL,
2499 "name of AFS root volume");
2500 cmd_AddParm(ts, "-stat", CMD_SINGLE, CMD_OPTIONAL,
2501 "number of stat entries");
2502 cmd_AddParm(ts, "-memcache", CMD_FLAG, CMD_OPTIONAL, "run diskless");
2503 cmd_AddParm(ts, "-cachedir", CMD_SINGLE, CMD_OPTIONAL, "cache directory");
2504 cmd_AddParm(ts, "-mountdir", CMD_SINGLE, CMD_OPTIONAL, "mount location");
2505 cmd_AddParm(ts, "-daemons", CMD_SINGLE, CMD_OPTIONAL,
2506 "number of daemons to use");
2507 cmd_AddParm(ts, "-nosettime", CMD_FLAG, CMD_OPTIONAL,
2508 "don't set the time");
2509 cmd_AddParm(ts, "-verbose", CMD_FLAG, CMD_OPTIONAL,
2510 "display lots of information");
2511 cmd_AddParm(ts, "-rmtsys", CMD_FLAG, CMD_OPTIONAL,
2512 "start NFS rmtsysd program");
2515 cmd_AddParm(ts, "-debug", CMD_FLAG, CMD_OPTIONAL, "display debug info");
2516 cmd_AddParm(ts, "-chunksize", CMD_SINGLE, CMD_OPTIONAL,
2517 "log(2) of chunk size");
2518 cmd_AddParm(ts, "-dcache", CMD_SINGLE, CMD_OPTIONAL,
2519 "number of dcache entries");
2520 cmd_AddParm(ts, "-volumes", CMD_SINGLE, CMD_OPTIONAL,
2521 "number of volume entries");
2522 cmd_AddParm(ts, "-biods", CMD_SINGLE, CMD_OPTIONAL,
2523 "number of bkg I/O daemons (aix vm)");
2524 cmd_AddParm(ts, "-prealloc", CMD_SINGLE, CMD_OPTIONAL,
2525 "number of 'small' preallocated blocks");
2526 cmd_AddParm(ts, "-confdir", CMD_SINGLE, CMD_OPTIONAL,
2527 "configuration directory");
2528 cmd_AddParm(ts, "-logfile", CMD_SINGLE, CMD_OPTIONAL,
2529 "Place to keep the CM log");
2530 cmd_AddParm(ts, "-waitclose", CMD_FLAG, CMD_OPTIONAL,
2531 "make close calls synchronous");
2532 cmd_AddParm(ts, "-shutdown", CMD_FLAG, CMD_OPTIONAL,
2533 "Shutdown all afs state");
2535 cmd_AddParm(ts, "-enable_peer_stats", CMD_FLAG, CMD_OPTIONAL | CMD_HIDE,
2536 "Collect rpc statistics by peer");
2537 cmd_AddParm(ts, "-enable_process_stats", CMD_FLAG,
2538 CMD_OPTIONAL | CMD_HIDE,
2539 "Collect rpc statistics for this process");
2540 cmd_AddParm(ts, "-mem_alloc_sleep", CMD_FLAG, (CMD_OPTIONAL | CMD_HIDE),
2541 "Allow sleeps when allocating memory cache");
2542 cmd_AddParm(ts, "-afsdb", CMD_FLAG, (CMD_OPTIONAL),
2543 "Enable AFSDB support");
2544 cmd_AddParm(ts, "-files_per_subdir", CMD_SINGLE, CMD_OPTIONAL,
2545 "log(2) of the number of cache files per cache subdirectory");
2546 cmd_AddParm(ts, "-dynroot", CMD_FLAG, CMD_OPTIONAL,
2547 "Enable dynroot support");
2548 cmd_AddParm(ts, "-fakestat", CMD_FLAG, CMD_OPTIONAL,
2549 "Enable fakestat support for cross-cell mounts");
2550 cmd_AddParm(ts, "-fakestat-all", CMD_FLAG, CMD_OPTIONAL,
2551 "Enable fakestat support for all mounts");
2552 cmd_AddParm(ts, "-nomount", CMD_FLAG, CMD_OPTIONAL, "Do not mount AFS");
2553 cmd_AddParm(ts, "-backuptree", CMD_FLAG, CMD_OPTIONAL,
2554 "Prefer backup volumes for mointpoints in backup volumes");
2556 cmd_AddParm(ts, "-rxbind", CMD_FLAG, CMD_OPTIONAL,
2557 "Bind the Rx socket (one interface only)");
2558 cmd_AddParm(ts, "-settime", CMD_FLAG, CMD_OPTIONAL, "set the time");
2559 cmd_AddParm(ts, "-rxpck", CMD_SINGLE, CMD_OPTIONAL,
2560 "set rx_extraPackets to this value");
2561 cmd_AddParm(ts, "-splitcache", CMD_SINGLE, CMD_OPTIONAL,
2562 "Percentage RW versus RO in cache (specify as 60/40)");
2563 cmd_AddParm(ts, "-disable-dynamic-vcaches", CMD_FLAG, CMD_OPTIONAL,
2564 "disable stat/vcache cache growing as needed");
2565 cmd_AddParm(ts, "-rxmaxmtu", CMD_SINGLE, CMD_OPTIONAL, "set rx max MTU to use");
2566 cmd_AddParm(ts, "-dynroot-sparse", CMD_FLAG, CMD_OPTIONAL,
2567 "Enable dynroot support with minimal cell list");
2571 afsd_parse(int argc, char **argv)
2573 return cmd_Dispatch(argc, argv);
2576 #ifdef AFS_SGI53_ENV
2577 #ifdef AFS_SGI61_ENV
2578 /* The dwarf structures are searched to find entry points of static functions
2579 * and the addresses of static variables. The file name as well as the
2580 * sybmol name is reaquired.
2583 /* Contains list of names to find in given file. */
2585 char *name; /* Name of variable or function. */
2586 afs_hyper_t addr; /* Address of function, undefined if not found. */
2587 Dwarf_Half type; /* DW_AT_location for vars, DW_AT_lowpc for func's */
2588 char found; /* set if found. */
2592 char *file; /* Name of file containing vars or funcs */
2593 staticAddrList *addrList; /* List of vars and/or funcs. */
2594 int nAddrs; /* # of addrList's */
2595 int found; /* set if we've found this file already. */
2598 /* routines used to find addresses in /unix */
2599 #if defined(AFS_SGI62_ENV) && !defined(AFS_SGI65_ENV)
2600 void findMDebugStaticAddresses(staticNameList *, int, int);
2602 void findDwarfStaticAddresses(staticNameList *, int);
2603 void findElfAddresses(Dwarf_Debug, Dwarf_Die, staticNameList *);
2604 void getElfAddress(Dwarf_Debug, Dwarf_Die, staticAddrList *);
2606 #if defined(AFS_SGI62_ENV) && !defined(AFS_SGI65_ENV)
2607 #define AFS_N_FILELISTS 2
2608 #define AFS_SYMS_NEEDED 3
2609 #else /* AFS_SGI62_ENV */
2610 #define AFS_N_FILELISTS 1
2611 #endif /* AFS_SGI62_ENV */
2616 set_staticaddrs(void)
2618 staticNameList fileList[AFS_N_FILELISTS];
2620 fileList[0].addrList =
2621 (staticAddrList *) calloc(1, sizeof(staticAddrList));
2622 if (!fileList[0].addrList) {
2623 printf("set_staticaddrs: Can't calloc fileList[0].addrList\n");
2626 fileList[0].file = "nfs_server.c";
2627 fileList[0].found = 0;
2628 fileList[0].nAddrs = 1;
2629 fileList[0].addrList[0].name = "rfsdisptab_v2";
2630 fileList[0].addrList[0].type = DW_AT_location;
2631 fileList[0].addrList[0].found = 0;
2633 #if defined(AFS_SGI62_ENV) && !defined(AFS_SGI65_ENV)
2634 fileList[1].addrList =
2635 (staticAddrList *) calloc(2, sizeof(staticAddrList));
2636 if (!fileList[1].addrList) {
2637 printf("set_staticaddrs: Can't malloc fileList[1].addrList\n");
2640 fileList[1].file = "uipc_socket.c";
2641 fileList[1].found = 0;
2642 fileList[1].nAddrs = 2;
2643 fileList[1].addrList[0].name = "sblock";
2644 fileList[1].addrList[0].type = DW_AT_low_pc;
2645 fileList[1].addrList[0].found = 0;
2646 fileList[1].addrList[1].name = "sbunlock";
2647 fileList[1].addrList[1].type = DW_AT_low_pc;
2648 fileList[1].addrList[1].found = 0;
2650 if (64 != sysconf(_SC_KERN_POINTERS))
2651 findMDebugStaticAddresses(fileList, AFS_N_FILELISTS, AFS_SYMS_NEEDED);
2653 #endif /* AFS_SGI62_ENV */
2654 findDwarfStaticAddresses(fileList, AFS_N_FILELISTS);
2656 if (fileList[0].addrList[0].found) {
2657 afsd_call_syscall(AFSOP_NFSSTATICADDR2, fileList[0].addrList[0].addr.high,
2658 fileList[0].addrList[0].addr.low);
2661 printf("NFS V2 is not present in the kernel.\n");
2663 free(fileList[0].addrList);
2664 #if defined(AFS_SGI62_ENV) && !defined(AFS_SGI65_ENV)
2665 if (fileList[1].addrList[0].found && fileList[1].addrList[1].found) {
2666 afsd_call_syscall(AFSOP_SBLOCKSTATICADDR2,
2667 fileList[1].addrList[0].addr.high,
2668 fileList[1].addrList[0].addr.low,
2669 fileList[1].addrList[1].addr.high,
2670 fileList[1].addrList[1].addr.low);
2672 if (!fileList[1].addrList[0].found)
2673 printf("Can't find %s in kernel. Exiting.\n",
2674 fileList[1].addrList[0].name);
2675 if (!fileList[1].addrList[0].found)
2676 printf("Can't find %s in kernel. Exiting.\n",
2677 fileList[1].addrList[1].name);
2680 free(fileList[1].addrList);
2681 #endif /* AFS_SGI62_ENV */
2685 /* Find addresses for static variables and functions. */
2687 findDwarfStaticAddresses(staticNameList * nameList, int nLists)
2694 char *hname = (char *)0;
2695 Dwarf_Unsigned dwarf_access = O_RDONLY;
2696 Dwarf_Debug dwarf_debug;
2697 Dwarf_Error dwarf_error;
2698 Dwarf_Unsigned dwarf_cu_header_length;
2699 Dwarf_Unsigned dwarf_abbrev_offset;
2700 Dwarf_Half dwarf_address_size;
2701 Dwarf_Unsigned next_cu_header;
2702 Dwarf_Die dwarf_die;
2703 Dwarf_Die dwarf_next_die;
2704 Dwarf_Die dwarf_child_die;
2706 if (elf_version(EV_CURRENT) == EV_NONE) {
2707 printf("findDwarfStaticAddresses: Bad elf version.\n");
2711 if ((fd = open("/unix", O_RDONLY, 0)) < 0) {
2712 printf("findDwarfStaticAddresses: Failed to open /unix.\n");
2716 dwarf_init(fd, dwarf_access, NULL, NULL, &dwarf_debug, &dwarf_error);
2717 if (code != DW_DLV_OK) {
2718 /* Nope hope for the elves and dwarves, try intermediate code. */
2725 /* Run through the headers until we find ones for files we've
2726 * specified in nameList.
2729 dwarf_next_cu_header(dwarf_debug, &dwarf_cu_header_length, NULL,
2730 &dwarf_abbrev_offset, &dwarf_address_size,
2731 &next_cu_header, &dwarf_error);
2732 if (code == DW_DLV_NO_ENTRY) {
2734 } else if (code == DW_DLV_ERROR) {
2735 printf("findDwarfStaticAddresses: Error reading headers: %s\n",
2736 dwarf_errmsg(dwarf_error));
2740 code = dwarf_siblingof(dwarf_debug, NULL, &dwarf_die, &dwarf_error);
2741 if (code != DW_DLV_OK) {
2742 printf("findDwarfStaticAddresses: Can't get first die. %s\n",
2743 (code == DW_DLV_ERROR) ? dwarf_errmsg(dwarf_error) : "");
2747 /* This is the header, test the name. */
2748 code = dwarf_diename(dwarf_die, &hname, &dwarf_error);
2749 if (code == DW_DLV_OK) {
2750 s = strrchr(hname, '/');
2751 for (i = 0; i < nLists; i++) {
2752 if (s && !strcmp(s + 1, nameList[i].file)) {
2753 findElfAddresses(dwarf_debug, dwarf_die, &nameList[i]);
2760 ("findDwarfStaticAddresses: Can't get name of current header. %s\n",
2761 (code == DW_DLV_ERROR) ? dwarf_errmsg(dwarf_error) : "");
2764 dwarf_dealloc(dwarf_debug, hname, DW_DLA_STRING);
2766 if (found >= nLists) { /* we're done */
2771 /* Frees up all allocated space. */
2772 (void)dwarf_finish(dwarf_debug, &dwarf_error);
2777 findElfAddresses(Dwarf_Debug dwarf_debug, Dwarf_Die dwarf_die,
2778 staticNameList * nameList)
2781 Dwarf_Error dwarf_error;
2782 Dwarf_Die dwarf_next_die;
2783 Dwarf_Die dwarf_child_die;
2784 Dwarf_Attribute dwarf_return_attr;
2785 char *vname = (char *)0;
2789 /* Drop into this die to find names in addrList. */
2790 code = dwarf_child(dwarf_die, &dwarf_child_die, &dwarf_error);
2791 if (code != DW_DLV_OK) {
2792 printf("findElfAddresses: Can't get child die. %s\n",
2793 (code == DW_DLV_ERROR) ? dwarf_errmsg(dwarf_error) : "");
2797 /* Try to find names in each sibling. */
2798 dwarf_next_die = (Dwarf_Die) 0;
2800 code = dwarf_diename(dwarf_child_die, &vname, &dwarf_error);
2801 /* It's possible that some siblings don't have names. */
2802 if (code == DW_DLV_OK) {
2803 for (i = 0; i < nameList->nAddrs; i++) {
2804 if (!nameList->addrList[i].found) {
2805 if (!strcmp(vname, nameList->addrList[i].name)) {
2806 getElfAddress(dwarf_debug, dwarf_child_die,
2807 &(nameList->addrList[i]));
2815 dwarf_dealloc(dwarf_debug, dwarf_next_die, DW_DLA_DIE);
2817 if (found >= nameList->nAddrs) { /* we're done. */
2821 dwarf_next_die = dwarf_child_die;
2823 dwarf_siblingof(dwarf_debug, dwarf_next_die, &dwarf_child_die,
2826 } while (code == DW_DLV_OK);
2829 /* Get address out of current die. */
2831 getElfAddress(Dwarf_Debug dwarf_debug, Dwarf_Die dwarf_child_die,
2832 staticAddrList * addrList)
2835 Dwarf_Error dwarf_error;
2836 Dwarf_Attribute dwarf_return_attr;
2837 Dwarf_Bool dwarf_return_bool;
2838 Dwarf_Locdesc *llbuf = NULL;
2839 Dwarf_Signed listlen;
2840 off64_t addr = (off64_t) 0;
2844 dwarf_hasattr(dwarf_child_die, addrList->type, &dwarf_return_bool,
2846 if ((code != DW_DLV_OK) || (!dwarf_return_bool)) {
2847 printf("getElfAddress: no address given for %s. %s\n", addrList->name,
2848 (code == DW_DLV_ERROR) ? dwarf_errmsg(dwarf_error) : "");
2852 dwarf_attr(dwarf_child_die, addrList->type, &dwarf_return_attr,
2854 if (code != DW_DLV_OK) {
2855 printf("getElfAddress: Can't get attribute. %s\n",
2856 (code == DW_DLV_ERROR) ? dwarf_errmsg(dwarf_error) : "");
2860 switch (addrList->type) {
2861 case DW_AT_location:
2863 dwarf_loclist(dwarf_return_attr, &llbuf, &listlen, &dwarf_error);
2864 if (code != DW_DLV_OK) {
2865 printf("getElfAddress: Can't get location for %s. %s\n",
2867 (code == DW_DLV_ERROR) ? dwarf_errmsg(dwarf_error) : "");
2870 if ((listlen != 1) || (llbuf[0].ld_cents != 1)) {
2871 printf("getElfAddress: %s has more than one address.\n",
2875 addr = llbuf[0].ld_s[0].lr_number;
2880 dwarf_lowpc(dwarf_child_die, (Dwarf_Addr *) & addr, &dwarf_error);
2881 if (code != DW_DLV_OK) {
2882 printf("getElfAddress: Can't get lowpc for %s. %s\n",
2884 (code == DW_DLV_ERROR) ? dwarf_errmsg(dwarf_error) : "");
2890 printf("getElfAddress: Bad case %d in switch.\n", addrList->type);
2894 addrList->addr.high = (addr >> 32) & 0xffffffff;
2895 addrList->addr.low = addr & 0xffffffff;
2896 addrList->found = 1;
2899 #if defined(AFS_SGI62_ENV) && !defined(AFS_SGI65_ENV)
2900 /* Find symbols in the .mdebug section for 32 bit kernels. */
2903 * On 32bit platforms, we're still using the ucode compilers to build
2904 * the kernel, so we need to get our static text/data from the .mdebug
2905 * section instead of the .dwarf sections.
2907 /* SearchNameList searches our bizarre structs for the given string.
2908 * If found, sets the found bit and the address and returns 1.
2909 * Not found returns 0.
2912 SearchNameList(char *name, afs_uint32 addr, staticNameList * nameList,
2916 for (i = 0; i < nLists; i++) {
2917 for (j = 0; j < nameList[i].nAddrs; j++) {
2918 if (nameList[i].addrList[j].found)
2920 if (!strcmp(name, nameList[i].addrList[j].name)) {
2921 nameList[i].addrList[j].addr.high = 0;
2922 nameList[i].addrList[j].addr.low = addr;
2923 nameList[i].addrList[j].found = 1;
2932 SearchMDebug(Elf_Scn * scnp, Elf32_Shdr * shdrp, staticNameList * nameList,
2933 int nLists, int needed)
2935 long *buf = (long *)(elf_getdata(scnp, NULL)->d_buf);
2936 u_long addr, mdoff = shdrp->sh_offset;
2938 SYMR *symbase, *symp, *symend;
2939 FDR *fdrbase, *fdrp;
2941 char *strbase, *str;
2946 addr = (__psunsigned_t) buf;
2947 hdrp = (HDRR *) addr;
2949 /* setup base addresses */
2950 addr = (u_long) buf + (u_long) (hdrp->cbFdOffset - mdoff);
2951 fdrbase = (FDR *) addr;
2952 addr = (u_long) buf + (u_long) (hdrp->cbSymOffset - mdoff);
2953 symbase = (SYMR *) addr;
2954 addr = (u_long) buf + (u_long) (hdrp->cbSsOffset - mdoff);
2955 strbase = (char *)addr;
2957 #define KEEPER(a,b) ((a == stStaticProc && b == scText) || \
2958 (a == stStatic && (b == scData || b == scBss || \
2959 b == scSBss || b == scSData)))
2961 for (fdrp = fdrbase; fdrp < &fdrbase[hdrp->ifdMax]; fdrp++) {
2962 str = strbase + fdrp->issBase + fdrp->rss;
2964 /* local symbols for each fd */
2965 for (symp = &symbase[fdrp->isymBase];
2966 symp < &symbase[fdrp->isymBase + fdrp->csym]; symp++) {
2967 if (KEEPER(symp->st, symp->sc)) {
2968 if (symp->value == 0)
2971 str = strbase + fdrp->issBase + symp->iss;
2972 /* Look for AFS symbols of interest */
2973 if (SearchNameList(str, symp->value, nameList, nLists)) {
2975 if (nFound >= needed)
2984 * returns section with the name of scn_name, & puts its header in shdr64 or
2985 * shdr32 based on elf's file type
2989 findMDebugSection(Elf * elf, char *scn_name)
2993 Elf_Scn *scn = NULL;
2997 if ((ehdr32 = elf32_getehdr(elf)) == NULL)
3000 if ((scn = elf_nextscn(elf, scn)) == NULL)
3002 if ((shdr32 = elf32_getshdr(scn)) == NULL)
3006 elf_strptr(elf, ehdr32->e_shstrndx, shdr32->sh_name)));
3013 findMDebugStaticAddresses(staticNameList * nameList, int nLists, int needed)
3017 Elf_Scn *mdebug_scn;
3018 Elf32_Shdr *mdebug_shdr;
3021 if ((fd = open("/unix", O_RDONLY)) == -1) {
3022 printf("findMDebugStaticAddresses: Failed to open /unix.\n");
3026 (void)elf_version(EV_CURRENT);
3027 if ((elf = elf_begin(fd, ELF_C_READ, NULL)) == NULL) {
3029 ("findMDebugStaticAddresses: /unix doesn't seem to be an elf file\n");
3033 mdebug_scn = findMDebugSection(elf, ".mdebug");
3035 printf("findMDebugStaticAddresses: Can't find .mdebug section.\n");
3038 mdebug_shdr = elf32_getshdr(mdebug_scn);
3040 printf("findMDebugStaticAddresses: Can't find .mdebug header.\n");
3044 (void)SearchMDebug(mdebug_scn, mdebug_shdr, nameList, nLists, needed);
3050 #endif /* AFS_SGI62_ENV */
3052 #else /* AFS_SGI61_ENV */
3054 struct nlist nlunix[] = {
3061 int i, j, kmem, count;
3063 if ((kmem = open("/dev/kmem", O_RDONLY)) < 0) {
3064 printf("Warning: can't open /dev/kmem\n");
3067 if ((j = nlist("/unix", nlunix)) < 0) {
3068 printf("Warning: can't nlist /unix\n");
3071 i = nlunix[0].n_value;
3072 if (lseek(kmem, i, L_SET /*0 */ ) != i) {
3073 printf("Warning: can't lseek to %x\n", i);
3076 if ((j = read(kmem, &count, sizeof count)) != sizeof count) {
3077 printf("WARNING: kmem read at %x failed\n", i);
3082 #endif /* AFS_SGI61_ENV */
3083 #endif /* AFS_SGI53_ENV */
3085 struct afsd_syscall_args {
3097 * entry point for calling a syscall from another proc/thread.
3099 * @param[in] rock a struct afsd_syscall_args* specifying what syscall to call
3102 * @retval NULL always
3105 call_syscall_thread(void *rock)
3107 struct afsd_syscall_args *args = rock;
3111 afsd_set_rx_rtpri();
3114 code = afsd_call_syscall(args->syscall, args->param1, args->param2,
3115 args->param3, args->param4, args->param5);
3116 if (code && args->syscall == AFSOP_START_CS) {
3117 printf("%s: No check server daemon in client.\n", args->rn);
3126 * common code for calling a syscall in another proc/thread.
3128 * @param[in] rx 1 if this is a thread for RX stuff, 0 otherwise
3129 * @param[in] wait 1 if we should wait for the new proc/thread to finish, 0 to
3130 * let it run in the background
3131 * @param[in] rn the name of the running program
3132 * @param[in] syscall syscall to run
3135 fork_syscall_impl(int rx, int wait, const char *rn, long syscall, long param1,
3136 long param2, long param3, long param4, long param5)
3138 struct afsd_syscall_args *args;
3140 args = malloc(sizeof(*args));
3142 args->syscall = syscall;
3143 args->param1 = param1;
3144 args->param2 = param2;
3145 args->param3 = param3;
3146 args->param4 = param4;
3147 args->param5 = param5;
3151 afsd_fork(wait, call_syscall_thread, args);
3155 * call a syscall in another process or thread.
3158 fork_syscall(const char *rn, long syscall, long param1, long param2,
3159 long param3, long param4, long param5)
3161 fork_syscall_impl(0, 0, rn, syscall, param1, param2, param3, param4, param5);
3164 #if defined(AFS_SUN510_ENV) || defined(RXK_LISTENER_ENV)
3166 * call a syscall in another process or thread, and give it RX priority.
3169 fork_rx_syscall(const char *rn, long syscall, long param1, long param2,
3170 long param3, long param4, long param5)
3172 fork_syscall_impl(1, 0, rn, syscall, param1, param2, param3, param4, param5);
3174 #endif /* AFS_SUN510_ENV || RXK_LISTENER_ENV */
3176 #if defined(AFS_SUN510_ENV) && defined(RXK_LISTENER_ENV)
3178 * call a syscall in another process or thread, give it RX priority, and wait
3179 * for it to finish before returning.
3182 fork_rx_syscall_wait(const char *rn, long syscall, long param1, long param2,
3183 long param3, long param4, long param5)
3185 fork_syscall_impl(1, 1, rn, syscall, param1, param2, param3, param4, param5);
3187 #endif /* AFS_SUN510_ENV && RXK_LISTENER_ENV */