3 fs setcachesize - Sets the size of the disk cache
7 fs setcachesize [B<-blocks> I<size in 1K byte blocks (0 =E<gt> reset)>]
10 fs setca [B<-b> I<size in 1K byte blocks (0 =E<gt> reset)>] [B<-r>] [B<-h>]
12 fs cachesize [B<-b> I<size in 1K byte blocks (0 =E<gt> reset)>] [B<-r>] [B<-h>]
14 fs ca [B<-b> I<size in 1K byte blocks (0 =E<gt> reset)>] [B<-r>] [B<-h>]
18 The C<fs setcachesize> command changes the number of kilobyte blocks of
19 local disk space available to the Cache Manager for its data cache, on
20 machines that use a disk cache. The command is not operative on
21 machines that use a memory cache.
23 To return the cache size to the default value specified in the third
24 field of the local B</usr/vice/etc/cacheinfo> file, provide a value of B<0>
25 to the B<-blocks> argument.
27 To return the cache size to the value set when the machine was last
28 rebooted, use the B<-reset> flag instead of the B<-blocks> argument. This is
29 normally the amount specified in the B<cacheinfo> file, unless the
30 B<-blocks> argument was included on the C<afsd> command to override the
33 To display the current cache size and amount of cache in use, for both
34 disk and memory caches, use the C<fs getcacheparms> command.
40 =item B<-blocks> I<size in 1K byte blocks (0 =E<gt> reset)>
42 Specifies the number of one-kilobyte blocks of disk space
43 available for the Cache Manager to devote to the cache. Provide
44 a value of B<0> to set cache size to the default specified in the
49 Returns the cache size to the value set when the machine was
50 last booted. This agrees with the value in the B<cacheinfo> file
51 unless the B<-blocks> argument was used on the C<afsd> command.
55 Prints the online help for this command. All other valid
62 The following command sets the disk cache size to 25000 kilobyte
65 fs setcachesize -blocks 25000
67 Both of the following commands reset the disk cache size to the value
68 in the B<cacheinfo> file, assuming that the B<-blocks> argument to the C<afsd>
71 fs setcachesize -blocks 0
73 fs setcachesize -reset
75 =head1 PRIVILEGE REQUIRED
77 The issuer must be logged in as the local superuser B<root>.
81 This command is not operative on machines using a memory cache, and
82 results in an error message. To change memory cache size, edit the
83 B<cacheinfo> file and reboot, or reboot and provide the B<-blocks> argument
84 to the C<afsd> command.
86 On machines using a disk cache, do not set the cache size to exceed
87 85% to 90% of the actual disk space available for the cache directory.
88 The cache implementation itself requires a small amount of space on
93 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
95 Converted from html to pod by Alf Wachsmann <alfw@slac.stanford.edu>, 2003,
96 and Elizabeth Cassell <e_a_c@mailsnare.net>, 2004,
97 Stanford Linear Accelerator Center, a department of Stanford University.
103 L<fs_getcacheparms(1)>