Commit | Line | Data |
---|---|---|
805e021f CE |
1 | =head1 NAME |
2 | ||
3 | fs_setcachesize - Sets the size of the disk cache | |
4 | ||
5 | =head1 SYNOPSIS | |
6 | ||
7 | =for html | |
8 | <div class="synopsis"> | |
9 | ||
10 | B<fs setcachesize> [B<-blocks> <I<size (0 => reset)>>] [B<-reset>] [B<-help>] | |
11 | ||
12 | B<fs setca> [B<-b> <I<size (0 => reset)>>] [B<-r>] [B<-h>] | |
13 | ||
14 | B<fs cachesize> [B<-b> <I<size (0 => reset)>>] [B<-r>] [B<-h>] | |
15 | ||
16 | B<fs ca> [B<-b> <I<size (0 => reset)>>] [B<-r>] [B<-h>] | |
17 | ||
18 | =for html | |
19 | </div> | |
20 | ||
21 | =head1 DESCRIPTION | |
22 | ||
23 | The B<fs setcachesize> command changes the number of kilobyte blocks of | |
24 | local disk space available to the Cache Manager for its data cache, on | |
25 | machines that use a disk cache. The command is not operative on machines | |
26 | that use a memory cache. | |
27 | ||
28 | To return the cache size to the default value specified in the third field | |
29 | of the local F</usr/vice/etc/cacheinfo> file, provide a value of C<0> to | |
30 | the B<-blocks> argument. | |
31 | ||
32 | To return the cache size to the value set when the machine was last | |
33 | rebooted, use the B<-reset> flag instead of the B<-blocks> argument. This | |
34 | is normally the amount specified in the F<cacheinfo> file, unless the | |
35 | B<-blocks> argument was included on the B<afsd> command to override the | |
36 | B<cacheinfo> value. | |
37 | ||
38 | To display the current cache size and amount of cache in use, for both | |
39 | disk and memory caches, use the B<fs getcacheparms> command. | |
40 | ||
41 | =head1 CAUTIONS | |
42 | ||
43 | This command is not operative on machines using a memory cache, and | |
44 | results in an error message. To change memory cache size, edit the | |
45 | B<cacheinfo> file and reboot, or reboot and provide the B<-blocks> | |
46 | argument to the B<afsd> command. | |
47 | ||
48 | On machines using a disk cache, do not set the cache size to exceed 85% to | |
49 | 90% of the actual disk space available for the cache directory. The cache | |
50 | implementation itself requires a small amount of space on the partition. | |
51 | ||
52 | =head1 OPTIONS | |
53 | ||
54 | =over 4 | |
55 | ||
56 | =item B<-blocks> <I<size>> | |
57 | ||
58 | Specifies the amount of disk space available for the Cache Manager to | |
59 | devote to the cache. The size should be a positive integer followed by an | |
60 | optional suffix: C<K> for kibibytes (1024 bytes, the default), C<M> for | |
61 | mebibytes (1024 kibibytes), C<G> for gibibytes (1024 mebibytes), and C<T> | |
62 | for tebibytes (1024 gibibytes). Provide a value of C<0> to set cache size | |
63 | to the default specified in the F<cacheinfo> file. | |
64 | ||
65 | =item B<-reset> | |
66 | ||
67 | Returns the cache size to the value set when the machine was last | |
68 | booted. This agrees with the value in the F<cacheinfo> file unless the | |
69 | B<-blocks> argument was used on the B<afsd> command. | |
70 | ||
71 | =item B<-help> | |
72 | ||
73 | Prints the online help for this command. All other valid options are | |
74 | ignored. | |
75 | ||
76 | =back | |
77 | ||
78 | =head1 EXAMPLES | |
79 | ||
80 | The following command sets the disk cache size to 25000 kilobyte blocks. | |
81 | ||
82 | % fs setcachesize -blocks 25000 | |
83 | ||
84 | Both of the following commands reset the disk cache size to the value in | |
85 | the F<cacheinfo> file, assuming that the B<-blocks> argument to the | |
86 | B<afsd> command was not used. | |
87 | ||
88 | % fs setcachesize -blocks 0 | |
89 | % fs setcachesize -reset | |
90 | ||
91 | =head1 PRIVILEGE REQUIRED | |
92 | ||
93 | The issuer must be logged in as the local superuser root. | |
94 | ||
95 | =head1 SEE ALSO | |
96 | ||
97 | L<cacheinfo(5)>, | |
98 | L<afsd(8)>, | |
99 | L<fs_getcacheparms(1)> | |
100 | ||
101 | =head1 COPYRIGHT | |
102 | ||
103 | IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved. | |
104 | ||
105 | This documentation is covered by the IBM Public License Version 1.0. It was | |
106 | converted from HTML to POD by software written by Chas Williams and Russ | |
107 | Allbery, based on work by Alf Wachsmann and Elizabeth Cassell. |