mirror of
https://git.openafs.org/openafs.git
synced 2025-01-19 07:20:11 +00:00
55b8a4d35e
Document that the quotas passed to fs setquota, vos create, and vos
setfields and the size passed to fs setcachesize may take a suffix
indicating the unit. This documents the change in behavior implemented by
54c0a3f3e6.
Fix a copy/paste error in the vos create -maxquota option definition.
Reviewed-on: http://gerrit.openafs.org/212
Tested-by: Derrick Brashear <shadow@dementia.org>
Reviewed-by: Derrick Brashear <shadow@dementia.org>
108 lines
3.3 KiB
Plaintext
108 lines
3.3 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 (0 => reset)>>] [B<-reset>] [B<-help>]
|
|
|
|
B<fs setca> [B<-b> <I<size (0 => reset)>>] [B<-r>] [B<-h>]
|
|
|
|
B<fs cachesize> [B<-b> <I<size (0 => reset)>>] [B<-r>] [B<-h>]
|
|
|
|
B<fs ca> [B<-b> <I<size (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>>
|
|
|
|
Specifies the amount of disk space available for the Cache Manager to
|
|
devote to the cache. The size should be a positive integer followed by an
|
|
optional suffix: C<K> for kibibytes (1024 bytes, the default), C<M> for
|
|
mebibytes (1024 kibibytes), C<G> for gibibytes (1024 mebibytes), and C<T>
|
|
for tebibytes (1024 gibibytes). 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.
|