60155372274e5f6e8a58935dfe876cf58d9b4956
[openafs.git] / doc / man-pages / pod1 / fs_getcacheparms.pod
1 =head1 NAME
2
3 fs getcacheparms - Displays the current size of the cache and the amount being used
4
5 =head1 SYNOPSIS
6
7 B<fs getcacheparms> [-help]
8
9 B<fs getca> [-h]
10
11 =head1 DESCRIPTION
12
13 The fs getcacheparms command displays the current size of the
14 cache (which can be in memory or on disk), and the amount currently in
15 use.
16
17 The reported statistics are from kernel memory, so the reported size can
18 differ from the setting specified in the B</usr/vice/etc/cacheinfo>
19 file on a machine using a disk cache, if the B<fs setcachesize>
20 command has been used to alter cache size.
21
22 =head1 OPTIONS
23
24 =over 4
25
26 =item -help
27
28 Prints the online help for this command. All other valid options
29 are ignored.
30
31 =back
32
33 =head1 OUTPUT
34
35 The output reports
36
37    AFS using I<amount used> of the cache's available I<size> 1K byte blocks.
38
39 where I<amount used> is the number of kilobyte blocks currently used
40 to cache data and status information, and I<size> is the total current
41 cache size.
42
43 =head1 EXAMPLES
44
45 The following example shows the output on a machine with a 25000 kilobyte
46 cache.
47
48    % fs getcacheparms
49    AFS using 22876 of the cache's available 25000 1K byte blocks.
50
51 =head1 PRIVILEGE REQUIRED
52
53 None
54
55 =head1 SEE ALSO
56
57 L<fs_setcachesize(1)>
58
59 =head1 COPYRIGHT
60
61 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
62
63 This documentation is covered by the IBM Public License Version 1.0.  It was
64 converted from HTML to POD by software written by Chas Williams and Russ
65 Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.