mirror of
https://git.openafs.org/openafs.git
synced 2025-01-19 07:20:11 +00:00
e3dfba8e6c
This is the initial conversion of the AFS Adminstrators Reference into POD for use as man pages. The man pages are now generated via pod2man from regen.sh so that only those working from CVS have to have pod2man available. The Makefile only installs. The pages have also been sorted out into pod1, pod5, and pod8 directories, making conversion to the right section of man page easier without maintaining a separate list and allowing for names to be duplicated between pod5 and pod1 or pod8 (which will likely be needed in a few cases). This reconversion is done with a new script based on work by Chas Williams. In some cases, the output is worse than the previous POD pages, but this is a more comprehensive conversion. This is only the first step, and this initial conversion has various problems. In addition, the file man pages that didn't have simple names have not been converted in this pass and will be added later. Some of the man pages have syntax problems and all of them have formatting errors. The next editing pass, coming shortly, will clean up most of the remaining mess.
107 lines
3.1 KiB
Plaintext
107 lines
3.1 KiB
Plaintext
=head1 NAME
|
|
|
|
fs setcachesize - Sets the size of the disk cache
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
B<fs setcachesize> [-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>] [-h]
|
|
|
|
B<fs cachesize> [B<-b> <I<size in 1K byte blocks (0 => reset)>>] [B<-r>] [-h]
|
|
|
|
B<fs ca> [B<-b> <I<size in 1K byte blocks (0 => reset)>>] [B<-r>] [-h]
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
The 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 B</usr/vice/etc/cacheinfo> file, provide a value of
|
|
B<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
|
|
B<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 CAVEATS
|
|
|
|
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 -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
|
|
B<0> to set cache size to the default specified in the
|
|
B<cacheinfo> file.
|
|
|
|
=item -reset
|
|
|
|
Returns the cache size to the value set when the machine was last
|
|
booted. This agrees with the value in the B<cacheinfo> file
|
|
unless the B<-blocks> argument was used on the B<afsd>
|
|
command.
|
|
|
|
=item -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 B<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(1)>,
|
|
L<afsd(1)>,
|
|
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.
|