d46c35e2d6a43a37995075fada56849c1f8f41f8
[openafs.git] / doc / man-pages / pod8 / afsd.pod
1 =head1 NAME
2
3 afsd - Initializes the Cache Manager and starts related daemons
4
5 =head1 SYNOPSIS
6
7 =for html
8 <div class="synopsis">
9
10 B<afsd> [B<-afsdb>] [B<-backuptree>]
11      S<<< [B<-biods> <I<number of bkg I/O daemons (aix vm)>>] >>>
12      S<<< [B<-blocks> <I<1024 byte blocks in cache>>] >>>
13      S<<< [B<-cachedir> <I<cache directory>>] >>>
14      S<<< [B<-chunksize> <I<log(2) of chunk size>>] >>>
15      S<<< [B<-confdir> <I<configuration directory>>] >>>
16      S<<< [B<-daemons> <I<number of daemons to use>>] >>>
17      S<<< [B<-dcache> <I<number of dcache entries>>] >>> [B<-debug>]
18      [B<-dynroot>] [B<-enable_peer_stats>] [B<-enable_process_stats>]
19      [B<-fakestat>] [B<-fakestat-all>]
20      S<<< [B<-files> <I<files in cache>>] >>>
21      S<<< [B<-files_per_subdir> <I<log(2) of files per dir>> ] >>>
22      [B<-help>] S<<< [B<-logfile> <I<Place to keep the CM log>>] >>>
23      [B<-mem_alloc_sleep>] [B<-memcache>]
24      S<<< [B<-mountdir> <I<mount location>>] >>> [B<-nomount>]
25      [B<-nosettime>]
26      S<<< [B<-prealloc> <I<number of 'small' preallocated blocks>>] >>>
27      [B<-rmtsys>] S<<< [B<-rootvol> <I<name of AFS root volume>>] >>>
28      [B<-rxbind>] S<<< [B<-rxpck> value for rx_extraPackets ] >>>
29      [B<-settime>] [B<-shutdown>]
30      S<<< [B<-splitcache> <I<RW/RO ratio>>] >>>
31      S<<< [B<-stat> <I<number of stat entries>>] >>> [B<-verbose>]
32      [B<-disable-dynamic-vcaches>] 
33      S<<< [B<-volumes> <I<number of volume entries>>] >>>
34      [B<-waitclose>]
35
36 =for html
37 </div>
38
39 =head1 DESCRIPTION
40
41 The B<afsd> command initializes the Cache Manager on an AFS client machine
42 by transferring AFS-related configuration information into kernel memory
43 and starting several daemons. More specifically, the B<afsd> command
44 performs the following actions:
45
46 =over 4
47
48 =item *
49
50 Sets a field in kernel memory that defines the machine's cell
51 membership. Some Cache Manager-internal operations and system calls
52 consult this field to learn which cell to execute in. (The AFS command
53 interpreters refer to the F</usr/vice/etc/ThisCell> file instead.) This
54 information is transferred into the kernel from the
55 F</usr/vice/etc/ThisCell> file and cannot be changed until the B<afsd>
56 program runs again.
57
58 =item *
59
60 Places in kernel memory the names and Internet addresses of the database
61 server machines in the local cell and (optionally) foreign cells. The
62 appearance of a cell's database server machines in this list enables the
63 Cache Manager to contact them and to access files in the cell. Omission of
64 a cell from this list, or incorrect information about its database server
65 machines, prevents the Cache Manager from accessing files in it.
66
67 By default, the list of database server machines is transferred into the
68 kernel from the F</usr/vice/etc/CellServDB> file. Alternatively, when the
69 B<-afsdb> option is used, the list of database server machines is taken
70 from the AFSDB DNS records for each cell. After initialization, use the
71 B<fs newcell> command to change the kernel-resident list without having to
72 reboot.
73
74 =item *
75
76 Mounts the root of the AFS filespace on a directory on the machine's local
77 disk, according to either the first field in the
78 F</usr/vice/etc/cacheinfo> file (the default) or the B<afsd> command's
79 B<-mountdir> argument. The conventional value is F</afs>.
80
81 =item *
82
83 Determines which volume to mount at the root of the AFS file tree.  The
84 default is the volume C<root.afs>; use the B<-rootvol> argument to
85 override it. Although the base (read/write) form of the volume name is the
86 appropriate value, the Cache Manager has a bias for accessing the
87 read-only version of the volume (by convention, C<root.afs.readonly>) if
88 it is available.
89
90 =item *
91
92 Configures the cache on disk (the default) or in machine memory if the
93 B<-memcache> argument is provided. In the latter case, the B<afsd> program
94 allocates space in machine memory for caching, and the Cache Manager uses
95 no disk space for caching even if the machine has a disk.
96
97 =item *
98
99 Defines the name of the local disk directory devoted to caching, when the
100 B<-memcache> argument is not used. If necessary, the B<afsd> program
101 creates the directory (its parent directory must already exist). It does
102 not remove the directory that formerly served this function, if one
103 exists.
104
105 The second field in the F</usr/vice/etc/cacheinfo> file is the source for
106 this name. The standard value is F</usr/vice/cache>. Use the B<-cachedir>
107 argument to override the value in the B<cacheinfo> file.
108
109 =item *
110
111 Sets the size of the cache. The default source for the value is the third
112 field in the F</usr/vice/etc/cacheinfo> file, which specifies a number of
113 kilobytes.
114
115 For a memory cache, the following arguments to the afsd command override
116 the value in the B<cacheinfo> file:
117
118 =over 4
119
120 =item *
121
122 The B<-blocks> argument, to specify a different number of kilobyte blocks.
123
124 =item *
125
126 The B<-dcache> and B<-chunksize> arguments together, to set both the
127 number of dcache entries and the chunk size (see below for definition of
128 these parameters). In this case, the B<afsd> program derives cache size by
129 multiplying the two values. Using this combination is not recommended, as
130 it requires the issuer to perform the calculation beforehand to determine
131 the resulting cache size.
132
133 =item *
134
135 The B<-dcache> argument by itself. In this case, the B<afsd> program
136 derives cache size by multiplying the value specified by the B<-dcache>
137 argument by the default memory cache chunk size of eight kilobytes. Using
138 this argument is not recommended, as it requires the issuer to perform the
139 calculation beforehand to determine the resulting cache size.
140
141 =back
142
143 For satisfactory memory cache performance, the specified value must leave
144 enough memory free to accommodate all other processes and commands that
145 can run on the machine. If the value exceeds the amount of memory
146 available, the B<afsd> program exits without initializing the Cache
147 Manager and produces the following message on the standard output stream:
148
149    afsd: memCache allocation failure at <number> KB
150
151 where <number> is how many kilobytes were allocated just before the
152 failure.
153
154 For a disk cache, use the B<-blocks> argument to the B<afsd> command to
155 override the value in the B<cacheinfo> file. The value specified in either
156 way sets an absolute upper limit on cache size; values provided for other
157 arguments (such as B<-dcache> and B<-chunksize>) never result in a larger
158 cache. The B<afsd> program rejects any setting larger than 95% of the
159 partition size, and exits after generating an error message on the
160 standard output stream, because the cache implementation itself requires a
161 small amount of disk space and overfilling the partition can cause the
162 client machine to panic.
163
164 To change the size of a disk cache after initialization without rebooting,
165 use the B<fs setcachesize> command; the setting persists until the B<afsd>
166 command runs again or the B<fs setcachesize> command is reissued. The B<fs
167 setcachesize> command does not work for memory caches.
168
169 =item *
170
171 Sets the size of each cache I<chunk>, and by implication the amount of
172 data that the Cache Manager requests at a time from the File Server (how
173 much data per fetch RPC, since AFS uses partial file transfer).
174
175 For a disk cache, a chunk is a F<VI<n>> file and this parameter
176 sets the maximum size to which each one can expand; the default is 64
177 KB. For a memory cache, each chunk is a collection of contiguous memory
178 blocks; the default is size is 8 KB.
179
180 To override the default chunk size for either type of cache, use the
181 B<-chunksize> argument to provide an integer to be used as an exponent of
182 two; see L<OPTIONS> for details. For a memory cache, if total cache size
183 divided by chunk size leaves a remainder, the B<afsd> program rounds down
184 the number of dcache entries, resulting in a slightly smaller cache.
185
186 =item *
187
188 Sets the number of chunks in the cache. For a memory cache, the number of
189 chunks is equal to the cache size divided by the chunk size.  For a disk
190 cache, the number of chunks (F<VI<n>> files) is set to the largest
191 of the following unless the B<-files> argument is used to set the value
192 explicitly:
193
194 =over 4
195
196 =item *
197
198 100
199
200 =item *
201
202 1.5 times the result of dividing cache size by chunk size
203 (I<cachesize>/I<chunksize> * 1.5)
204
205 =item *
206
207 The result of dividing cachesize by 10 KB (I<cachesize>/10240)
208
209 =back
210
211 =item *
212
213 Sets the number of I<dcache entries> allocated in machine memory for
214 storing information about the chunks in the cache.
215
216 For a disk cache, the F</usr/vice/cache/CacheItems> file contains one
217 entry for each F<VI<n>> file. By default, one half the number of
218 these entries (but not more that 2,000) are duplicated as dcache entries
219 in machine memory for quicker access.
220
221 For a memory cache, there is no F<CacheItems> file so all information
222 about cache chunks must be in memory as dcache entries.  Thus, there is no
223 default number of dcache entries for a memory cache; instead, the B<afsd>
224 program derives it by dividing the cache size by the chunk size.
225
226 To set the number of dcache entries, use the B<-dcache> argument; the
227 specified value can exceed the default limit of 2,000. Using this argument
228 is not recommended for either type of cache. Increasing the number of
229 dcache entries for a disk cache sometimes improves performance (because
230 more entries are retrieved from memory rather than from disk), but only
231 marginally. Using this argument for a memory cache requires the issuer to
232 calculate the cache size by multiplying this value by the chunk size.
233
234 =item *
235
236 Sets the number of I<stat> entries available in machine memory for caching
237 status information about cached AFS files. The default is 300; use the
238 B<-stat> argument to override the default.
239
240 =item *
241
242 If the B<-settime> option is specified, then it randomly selects a file
243 server machine in the local cell as the source for the correct time. Every
244 five minutes thereafter, the local clock is adjusted (if necessary) to
245 match the file server machine's clock. This is not enabled by default.  It
246 is recommended, instead, that the Network Time Protocol Daemon be used to
247 synchronize the time.
248
249 =back
250
251 In addition to setting cache configuration parameters, the B<afsd> program
252 starts the following daemons. (On most system types, these daemons appear
253 as nameless entries in the output of the UNIX B<ps> command.)
254
255 =over 4
256
257 =item *
258
259 One I<callback> daemon, which handles callbacks. It also responds to the
260 File Server's periodic probes, which check that the client machine is
261 still alive.
262
263 =item *
264
265 One I<maintenance> daemon, which performs the following tasks:
266
267 =over 4
268
269 =item *
270
271 Garbage collects obsolete data (for example, expired tokens) from kernel
272 memory.
273
274 =item *
275
276 Synchronizes files.
277
278 =item *
279
280 Refreshes information from read-only volumes once per hour.
281
282 =item *
283
284 Does delayed writes for NFS clients if the machine is running the NFS/AFS
285 Translator.
286
287 =back
288
289 =item *
290
291 One I<cache-truncation> daemon, which flushes the cache when free space is
292 required, by writing cached data and status information to the File
293 Server.
294
295 =item *
296
297 One I<server connection> daemon, which sends a probe to the File
298 Server every few minutes to check that it is still accessible. If the
299 B<-settime> option is set, it also synchronizes the machine's clock
300 with the clock on a randomly-chosen file server machine. There is
301 always one server connection daemon.
302
303 =item *
304
305 One or more I<background> daemons that improve performance by pre-fetching
306 files and performing background (delayed) writes of saved data into AFS.
307
308 The default number of background daemons is two, enough to service at
309 least five simultaneous users of the machine. To increase the number, use
310 the B<-daemons> argument. A value greater than six is not generally
311 necessary.
312
313 =item *
314
315 On some system types, one I<Rx listener> daemon, which listens for
316 incoming RPCs.
317
318 =item *
319
320 On some system types, one I<Rx event> daemon, which reviews the Rx
321 system's queue of tasks and performs them as appropriate. Most items in
322 the queue are retransmissions of failed packets.
323
324 =item *
325
326 On machines that run AIX with virtual memory (VM) integration, one or more
327 I<VM> daemons (sometimes called I<I/O> daemons, which transfer data
328 between disk and machine memory. The number of them depends on the setting
329 of the B<-biods> and B<-daemons> arguments:
330
331 =over 4
332
333 =item *
334
335 If the B<-biods> argument is used, it sets the number of VM daemons.
336
337 =item *
338
339 If only the B<-daemons> argument is used, the number of VM daemons is
340 twice the number of background daemons.
341
342 =item *
343
344 If neither argument is used, there are five VM daemons.
345
346 =back
347
348 =back
349
350 This command does not use the syntax conventions of the AFS command
351 suites. Provide the command name and all option names in full.
352
353 =head1 CAUTIONS
354
355 Before using the B<-shutdown> parameter, use the standard UNIX B<umount>
356 command to unmount the AFS root directory (by convention, F</afs>).  On
357 Linux, unloading the AFS kernel module and then loading it again before
358 restarting AFS after B<-shutdown> is recommended.
359
360 AFS has for years had difficulties with being stopped and restarted
361 without an intervening reboot.  While most of these issues have been
362 ironed out, stopping and restarting AFS is not recommended unless
363 necessary and rebooting before restarting AFS is still the safest course
364 of action. This does not apply to Linux; it should be safe to restart the
365 AFS client on Linux without rebooting.
366
367 In contrast to many client-server applications, not all communication is
368 initiated by the client. When the AFS client opens a file, it registers a
369 callback with the AFS server. If the file changes, the server notifies the
370 client that the file has changed and that all cached copies should be
371 discarded. In order to enable full functionality on the AFS client,
372 including all command-line utilities, the following UDP ports must be open
373 on an firewalls between the client and the server:
374
375    fileserver      7000/udp 
376    cachemanager    7001/udp (OpenAFS client. Arla uses 4711/udp)
377    ptserver        7002/udp
378    vlserver        7003/udp
379    kaserver        7004/udp (not needed with Kerberos v5)
380    volserver       7005/udp
381    reserved        7006/udp (for future use)
382    bosserver       7007/udp
383
384 Additionally, for B<klog> to work through the firewall you need to allow
385 inbound and outbound UDP on ports >1024 (probably 1024<port<2048 would
386 suffice depending on the number of simultaneous B<klog>s).
387
388 Be sure to set the UDP timeouts on the firewall to be at least twenty
389 minutes for the best callback performance.
390
391 =head1 OPTIONS
392
393 =over 4
394
395 =item B<-afsdb>
396
397 Enable afsdb support. This will use DNS to lookup the AFSDB record and
398 use that for the database servers for each cell instead of the values
399 in the F<CellServDB> file. This has the advantage of only needing to
400 update one DNS record to reconfigure the AFS clients for a new
401 database server as opposed to touching all of the clients, and also
402 allows one to access a cell without preconfiguring its database
403 servers in F<CellServDB>. The format of AFSDB records is defined in
404 RFC 1183.
405
406 =item B<-backuptree>
407
408 Prefer backup volumes for mountpoints in backup volumes. This option means
409 that the AFS client will prefer to resolve mount points to backup volumes
410 when a parent of the current volume is a backup volume. This is similar to
411 the standard behaviour of preferring read-only volumes over read-write
412 volumes when the parent volume is a read-only volume.
413
414 =item B<-biods> <I<number of I/O daemons>>
415
416 Sets the number of VM daemons dedicated to performing I/O operations on a
417 machine running a version of AIX with virtual memory (VM) integration.  If
418 both this argument and the B<-daemons> argument are omitted, the default
419 is five. If this argument is omitted but the B<-daemons> argument is
420 provided, the number of VM daemons is set to twice the value of the
421 B<-daemons> argument.
422
423 =item B<-blocks> <I<blocks in cache>>
424
425 Specifies the number of kilobyte blocks to be made available for caching
426 in the machine's cache directory (for a disk cache) or memory (for a
427 memory cache), overriding the default defined in the third field of the
428 F</usr/vice/etc/cacheinfo> file. For a disk cache, the value cannot exceed
429 95% of the space available in the cache partition. If using a memory
430 cache, do not combine this argument with the B<-dcache> argument, since
431 doing so can possibly result in a chunk size that is not an exponent of 2.
432
433 =item B<-cachedir> <I<cache directory>>
434
435 Names the local disk directory to be used as the cache. This value
436 overrides the default defined in the second field of the
437 F</usr/vice/etc/cacheinfo> file.
438
439 =item B<-chunksize> <I<chunk size>>
440
441 Sets the size of each cache chunk. The integer provided, which must be
442 from the range C<0> to C<30>, is used as an exponent on the number 2. It
443 overrides the default of 16 for a disk cache (2^16 is 64 KB) and 13 for a
444 memory cache (2^13 is 8 KB). A value of C<0> or less, or greater than
445 C<30>, sets chunk size to the appropriate default. Values less than C<10>
446 (which sets chunk size to a 1 KB) are not recommended.  Combining this
447 argument with the B<-dcache> argument is not recommended because it
448 requires that the issuer calculate the cache size that results.
449
450 B<-chunksize> is an important option when tuning for performance. Setting
451 this option to larger values can increase performance when dealing with
452 large files.
453
454 =item B<-confdir> <I<configuration directory>>
455
456 Names a directory other than the F</usr/vice/etc> directory from which to
457 fetch the F<cacheinfo>, F<ThisCell>, and F<CellServDB> configuration
458 files.
459
460 =item B<-daemons> <I<number of daemons to use>>
461
462 Specifies the number of background daemons to run on the machine.  These
463 daemons improve efficiency by doing prefetching and background writing of
464 saved data. This value overrides the default of C<2>, which is adequate
465 for a machine serving up to five users. Values greater than C<6> are not
466 generally more effective than C<6>.
467
468 Note: On AIX machines with integrated virtual memory (VM), the number of
469 VM daemons is set to twice the value of this argument, if it is provided
470 and the B<-biods> argument is not. If both arguments are omitted, there
471 are five VM daemons.
472
473 =item B<-dcache> <I<number of dcache entries>>
474
475 Sets the number of dcache entries in memory, which are used to store
476 information about cache chunks. For a disk cache, this overrides the
477 default, which is 50% of the number of F<VI<n>> files (cache chunks). For
478 a memory cache, this argument effectively sets the number of cache chunks,
479 but its use is not recommended, because it requires the issuer to
480 calculate the resulting total cache size (derived by multiplying this
481 value by the chunk size). Do not combine this argument with the B<-blocks>
482 argument, since doing so can possibly result in a chunk size that is not
483 an exponent of 2.
484
485 =item B<-debug>
486
487 Generates a highly detailed trace of the B<afsd> program's actions on the
488 standard output stream. The information is useful mostly for debugging
489 purposes.
490
491 =item B<-dynroot>
492
493 The standard behaviour of the AFS client without the B<-dynroot> option is
494 to mount the root.afs volume from the default cell on the F</afs> path. The 
495 F</afs> folder and root.afs volume traditionally shows the folders for 
496 F<ThisCell> and other cells as configured by the AFS cell administrator.
497
498 The B<-dynroot> option changes this. Using this option, the AFS client
499 does not mount the root.afs volume on F</afs>. Instead it uses the
500 contents of the F<CellServDB> file to populate the listing of cells in
501 F</afs>. This is known as a DYNamic ROOT. A cell is not contacted until
502 the path F</afs/I<cellname>> if accessed. This functions similarly to an
503 automounter.  The main advantage of using B<-dynroot> is that the AFS
504 client will start properly even without network access, whereas the client
505 not using B<-dynroot> will freeze upon startup if cannot contact the
506 default cell specified in F<ThisCell> and mount the root.afs
507 volume. Dynamic root mode is also sometimes called travelling mode because
508 it works well for laptops which don't always have network connectivity.
509
510 Two advantages of not using dynroot are that listing F</afs> will usually
511 be faster because the contents of F</afs> are limited to what the AFS
512 administrator decides and that symbolic links are traditionally created
513 by the AFS administrator to provide a short name for the cell (i.e.
514 cellname.domain.com is aliased to cellname).  However, with dynroot, the
515 local system administrator can limit the default contents of F</afs> by
516 installing a stripped-down F<CellServDB> file, and if dynroot is in effect,
517 the F<CellAlias> file can be used to provide shortname for common AFS cells
518 which provides equivalent functionality to the most commonly used symbolic
519 links.
520
521 =item B<-enable_peer_stats>
522
523 Activates the collection of Rx statistics and allocates memory for their
524 storage. For each connection with a specific UDP port on another machine,
525 a separate record is kept for each type of RPC (FetchFile, GetStatus, and
526 so on) sent or received. To display or otherwise access the records, use
527 the Rx Monitoring API.
528
529 =item B<-enable_process_stats>
530
531 Activates the collection of Rx statistics and allocates memory for their
532 storage. A separate record is kept for each type of RPC (FetchFile,
533 GetStatus, and so on) sent or received, aggregated over all connections to
534 other machines. To display or otherwise access the records, use the Rx
535 Monitoring API.
536
537 =item B<-fakestat>
538
539 Return fake values for stat calls on cross-cell mounts. This option makes
540 an C<ls -l> of F</afs> much faster since each cell isn't contacted, and
541 this and the B<-fakestat-all> options are useful on Mac OS X so that the
542 Finder program doesn't try to contact every AFS cell the system knows
543 about.
544
545 =item B<-fakestat-all>
546
547 Return fake values for stat calls on all mounts, not just cross-cell
548 mounts. This and the B<-fakestat> options are useful on Mac OS X so that
549 the Finder program doesn't hang when browsing AFS directories.
550
551 =item B<-files> <I<files in cache>>
552
553 Specifies the number of F<VI<n>> files to create in the cache directory
554 for a disk cache, overriding the default that is calculated as described
555 in L<DESCRIPTION>. Each F<VI<n>> file accommodates a chunk of data, and
556 can grow to a maximum size of 64 KB by default. Do not combine this
557 argument with the B<-memcache> argument.
558
559 =item B<-files_per_subdir> <I<files per cache subdirectory>>
560
561 Limits the number of cache files in each subdirectory of the cache
562 directory. The value of the option should be the base-two log of the
563 number of cache files per cache subdirectory (so 10 for 1024 files, 14 for
564 16384 files, and so forth).
565
566 =item B<-help>
567
568 Prints the online help for this command. All other valid options are
569 ignored.
570
571 =item B<-logfile> <I<log file location>>
572
573 This option is obsolete and no longer has any effect.
574
575 =item B<-mem_alloc_sleep>
576
577 Allows sleeps when allocating a memory cache.
578
579 =item B<-memcache>
580
581 Initializes a memory cache rather than a disk cache. Do not combine this
582 flag with the B<-files> argument.
583
584 =item B<-mountdir> <I<mount location>>
585
586 Names the local disk directory on which to mount the root of the AFS
587 filespace. This value overrides the default defined in the first field of
588 the F</usr/vice/etc/cacheinfo> file. If a value other than the F</afs>
589 directory is used, the machine cannot access the filespace of cells that
590 do use that value.
591
592 =item B<-nomount>
593
594 Do not mount AFS on startup. The afs global mount must be mounted via
595 some other means. This is useful on Mac OS X where /afs is sometimes
596 mounted in /Network/afs like other network file systems.
597
598 =item B<-nosettime>
599
600 This is enabled by default. It prevents the Cache Manager from
601 synchronizing its clock with the clock on a server machine selected at
602 random by checking the time on the server machine every five minutes.
603 This is the recommended behavior; instead of the AFS Cache Manager, the
604 Network Time Protocol Daemon should be used to synchronize the system
605 time.
606
607 =item B<-prealloc> <I<number of preallocated blocks>>
608
609 Specifies the number of pieces of memory to preallocate for the Cache
610 Manager's internal use. The default initial value is C<400>, but the Cache
611 Manager dynamically allocates more memory as it needs it.
612
613 =item B<-rmtsys>
614
615 Initializes an additional daemon to execute AFS-specific system calls on
616 behalf of NFS client machines. Use this flag only if the machine is an
617 NFS/AFS translator machine serving users of NFS client machines who
618 execute AFS commands.
619
620 =item B<-rootvol> <I<name of AFS root volume>>
621
622 Names the read/write volume corresponding to the root directory for the
623 AFS file tree (which is usually the F</afs> directory). This value
624 overrides the default of the C<root.afs> volume. This option is ignored if
625 B<-dynroot> is given.
626
627 =item B<-rxbind>
628
629 Bind the Rx socket (one interface only).
630
631 =item B<-rxpck> <I<value for rx_extraPackets>>
632
633 Set rx_extraPackets to this value. This sets the number of extra Rx
634 packet structures that are available to handle Rx connections. This
635 value should be increased if the "rxdebug 127.0.0.1 -port 7001
636 -rxstats" command shows no free Rx packets. Increasing this value may
637 improve OpenAFS client performance in some circumstances.
638
639 =item B<-settime>
640
641 Enable native AFS time synchronization. This option is the opposite of
642 B<-nosettime> and cannot be used with the B<-nosettime> option.
643
644 =item B<-shutdown>
645
646 Shuts down the Cache Manager. Before calling B<afsd> with this option,
647 unmount the AFS file system with B<umount>.
648
649 =item B<-splitcache> <I<RW/RO Ratio>>
650
651 This allows the user to set a certain percentage of the AFS cache be
652 reserved for read/write content and the rest to be reserved for read-only
653 content. The ratio should be written as a fraction.  For example,
654 C<-splitcache 75/25> devotes 75% of your cache space to read/write content
655 and 25% to read-only.
656
657 =item B<-stat> <I<number of stat entries>>
658
659 Specifies the number of entries to allocate in the machine's memory for
660 recording status information about the AFS files in the cache. This value
661 overrides the default of C<300>.
662
663 =item B<-verbose>
664
665 Generates a detailed trace of the B<afsd> program's actions on the
666 standard output stream.
667
668 =item B<-volumes> <I<number of volume entries>>
669
670 Specifies the number of memory structures to allocate for storing volume
671 location information. The default value is C<50>.
672
673 =item B<-disable-dynamic-vcaches>
674
675 By default, dynamic vcache overrides the B<-stat> option by using the value of
676 B<-stat> (or the default) as the initial size of the stat (or vcache) pool and
677 increases the pool dynamically as needed on supported platforms. This flag will
678 disable this new functionality and honor the '-stat' setting.
679
680 =item B<-waitclose>
681
682 Has no effect on the operation of the Cache Manager. The behavior it
683 affected in previous versions of the Cache Manager, to perform synchronous
684 writes to the File Server, is now the default behavior. To perform
685 asynchronous writes in certain cases, use the B<fs storebehind> command.
686
687 =back
688
689 =head1 EXAMPLES
690
691 The B<afsd> command is normally included in the machine's AFS
692 initialization file, rather than typed at the command shell prompt. For
693 most disk caches, the appropriate form is
694
695    % /usr/vice/etc/afsd
696
697 The following command is appropriate when enabling a machine to act as an
698 NFS/AFS Translator machine serving more than five users.
699
700    % /usr/vice/etc/afsd -daemons 4 -rmtsys
701
702 The following command initializes a memory cache and sets chunk size to 16
703 KB (2^14).
704
705    % /usr/vice/etc/afsd -memcache -chunksize 14
706
707 =head1 PRIVILEGE REQUIRED
708
709 The issuer must be logged in as the local superuser root.
710
711 =head1 SEE ALSO
712
713 L<fs_newcell(1)>,
714 L<afs_cache(5)>,
715 L<CellServDB(5)>,
716 L<cacheinfo(5)>
717
718 RFC 1183 L<http://www.faqs.org/rfcs/rfc1183.html>
719
720 =head1 COPYRIGHT
721
722 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
723
724 This documentation is covered by the IBM Public License Version 1.0.  It
725 was converted from HTML to POD by software written by Chas Williams and
726 Russ Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.