mirror of
https://git.openafs.org/openafs.git
synced 2025-01-19 07:20:11 +00:00
fc5acc0151
Implement proper synopsis wrapping for HTML generation. This was done in three pieces. First, add HTML-specific tags to the POD to mark the synopsis for HTML purposes so that we can apply style information to it. Second, update the style sheet to indent all lines except for the first in the synopsis section. Third, add the appropriate S<> tags around option and argument pairs so that we don't wrap between the option and its argument. Unfortunately, due to the <I<foo>> style that looks nicer for other reasons, we have to use the very verbose S<<< >>>. Oh well.
109 lines
3.2 KiB
Plaintext
109 lines
3.2 KiB
Plaintext
=head1 NAME
|
|
|
|
fs setcachesize - Sets the size of the disk cache
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
=for html
|
|
<div class="synopsis">
|
|
|
|
B<fs setcachesize> [B<-blocks> <I<size in 1K byte blocks (0 => reset)>>]
|
|
[B<-reset>] [B<-help>]
|
|
|
|
B<fs setca> [B<-b> <I<size in 1K byte blocks (0 => reset)>>]
|
|
[B<-r>] [B<-h>]
|
|
|
|
B<fs cachesize> [B<-b> <I<size in 1K byte blocks (0 => reset)>>]
|
|
[B<-r>] [B<-h>]
|
|
|
|
B<fs ca> [B<-b> <I<size in 1K byte blocks (0 => reset)>>]
|
|
[B<-r>] [B<-h>]
|
|
|
|
=for html
|
|
</div>
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
The B<fs setcachesize> command changes the number of kilobyte blocks of
|
|
local disk space available to the Cache Manager for its data cache, on
|
|
machines that use a disk cache. The command is not operative on machines
|
|
that use a memory cache.
|
|
|
|
To return the cache size to the default value specified in the third field
|
|
of the local F</usr/vice/etc/cacheinfo> file, provide a value of C<0> to
|
|
the B<-blocks> argument.
|
|
|
|
To return the cache size to the value set when the machine was last
|
|
rebooted, use the B<-reset> flag instead of the B<-blocks> argument. This
|
|
is normally the amount specified in the F<cacheinfo> file, unless the
|
|
B<-blocks> argument was included on the B<afsd> command to override the
|
|
B<cacheinfo> value.
|
|
|
|
To display the current cache size and amount of cache in use, for both
|
|
disk and memory caches, use the B<fs getcacheparms> command.
|
|
|
|
=head1 CAUTIONS
|
|
|
|
This command is not operative on machines using a memory cache, and
|
|
results in an error message. To change memory cache size, edit the
|
|
B<cacheinfo> file and reboot, or reboot and provide the B<-blocks>
|
|
argument to the B<afsd> command.
|
|
|
|
On machines using a disk cache, do not set the cache size to exceed 85% to
|
|
90% of the actual disk space available for the cache directory. The cache
|
|
implementation itself requires a small amount of space on the partition.
|
|
|
|
=head1 OPTIONS
|
|
|
|
=over 4
|
|
|
|
=item B<-blocks> <I<size in 1K byte blocks>>
|
|
|
|
Specifies the number of one-kilobyte blocks of disk space available for
|
|
the Cache Manager to devote to the cache. Provide a value of C<0> to set
|
|
cache size to the default specified in the F<cacheinfo> file.
|
|
|
|
=item B<-reset>
|
|
|
|
Returns the cache size to the value set when the machine was last
|
|
booted. This agrees with the value in the F<cacheinfo> file unless the
|
|
B<-blocks> argument was used on the B<afsd> command.
|
|
|
|
=item B<-help>
|
|
|
|
Prints the online help for this command. All other valid options are
|
|
ignored.
|
|
|
|
=back
|
|
|
|
=head1 EXAMPLES
|
|
|
|
The following command sets the disk cache size to 25000 kilobyte blocks.
|
|
|
|
% fs setcachesize -blocks 25000
|
|
|
|
Both of the following commands reset the disk cache size to the value in
|
|
the F<cacheinfo> file, assuming that the B<-blocks> argument to the
|
|
B<afsd> command was not used.
|
|
|
|
% fs setcachesize -blocks 0
|
|
% fs setcachesize -reset
|
|
|
|
=head1 PRIVILEGE REQUIRED
|
|
|
|
The issuer must be logged in as the local superuser root.
|
|
|
|
=head1 SEE ALSO
|
|
|
|
L<cacheinfo(5)>,
|
|
L<afsd(8)>,
|
|
L<fs_getcacheparms(1)>
|
|
|
|
=head1 COPYRIGHT
|
|
|
|
IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
|
|
|
|
This documentation is covered by the IBM Public License Version 1.0. It was
|
|
converted from HTML to POD by software written by Chas Williams and Russ
|
|
Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.
|