mirror of
https://git.openafs.org/openafs.git
synced 2025-01-22 08:50:17 +00:00
f64a78e701
This completes the first editing pass of the man pages. Very little content editing has been done, but the server and client versions of various man pages have been combined into a single man page for the file (affects CellServDB, ThisCell, NetInfo, and NetRestrict), the descriptions of the various AFS cache files have been combined into one afs_cache man page, and the descriptions of the two butc log files have been combined into one butc_logs man page. For man pages for databases with two files, symlinks are now created on installation for the secondary file name. All of the man pages should now be ready for public review, additional editing and cleanup, and content editing.
73 lines
2.5 KiB
Plaintext
73 lines
2.5 KiB
Plaintext
=head1 NAME
|
|
|
|
cacheinfo - Defines configuration parameters for the Cache Manager
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
The F<cacheinfo> file defines configuration parameters for the Cache
|
|
Manager, which reads the file as it initializes.
|
|
|
|
The file contains a single line of ASCII text and must reside in the
|
|
F</usr/vice/etc> directory. Use a text editor to create it during initial
|
|
configuration of the client machine; the required format is as follows:
|
|
|
|
<mount>:<cache>:<size>
|
|
|
|
where
|
|
|
|
=over 4
|
|
|
|
=item <mount>
|
|
|
|
Names the local disk directory at which the Cache Manager mounts the AFS
|
|
namespace. It must exist before the B<afsd> program runs. The conventional
|
|
value is F</afs>. Using any other value prevents traversal of pathnames
|
|
that begin with F</afs> (such as pathnames to files in foreign cells that
|
|
do use the conventional name). The B<-mountdir> argument to the B<afsd>
|
|
command overrides this value.
|
|
|
|
=item <cache>
|
|
|
|
Names the local disk directory to use as a cache. It must exist before the
|
|
B<afsd> program runs. The standard value is F</usr/vice/cache>, but it is
|
|
acceptable to substitute a directory on a partition with more available
|
|
space. Although the Cache Manager ignores this field when configuring a
|
|
memory cache, a value must always appear in it. The B<-cachedir> argument
|
|
to the B<afsd> command overrides this value.
|
|
|
|
=item <size>
|
|
|
|
Specifies the cache size as a number of 1-kilobyte blocks. Larger caches
|
|
generally yield better performance, but a disk cache must not exceed 90%
|
|
of the space available on the cache partition (85% for AIX systems), and a
|
|
memory cache must use no more than 25% of available machine memory.
|
|
|
|
The B<-blocks> argument to the afsd command overrides this value. To reset
|
|
cache size without rebooting on a machine that uses disk caching, use the
|
|
B<fs setcachesize> command. To display the current size of a disk or
|
|
memory cache between reboots, use the B<fs getcacheparms> command.
|
|
|
|
=back
|
|
|
|
=head1 EXAMPLES
|
|
|
|
The following example cacheinfo file mounts the AFS namespace at F</afs>,
|
|
establishes a disk cache in the F</usr/vice/cache> directory, and defines
|
|
cache size as 50,000 1-kilobyte blocks.
|
|
|
|
/afs:/usr/vice/cache:50000
|
|
|
|
=head1 SEE ALSO
|
|
|
|
L<afsd(8)>,
|
|
L<fs_getcacheparms(8)>,
|
|
L<fs_setcachesize(8)>
|
|
|
|
=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.
|