pod-man-pages-20051015
[openafs.git] / doc / man-pages / pod / 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 fs getcacheparms [B<-help>]
8
9 fs getca [B<-h>]
10
11 =head1 DESCRIPTION
12
13 The C<fs getcacheparms> command displays the current size of the cache
14 (which can be in memory or on disk), and the amount currently in use.
15
16 The reported statistics are from kernel memory, so the reported size
17 can differ from the setting specified in the B</usr/vice/etc/cacheinfo>
18 file on a machine using a disk cache, if the C<fs setcachesize> command
19 has been used to alter cache size.
20
21 =head1 OPTIONS
22
23 =over 4
24
25 =item B<-help>
26
27 Prints the online help for this command. All other valid
28 options are ignored.
29
30 =back
31
32 =head1 OUTPUT
33
34 The output reports
35
36 AFS using I<amount used> of the cache's available I<size> 1K byte blocks.
37
38 where I<amount used> is the number of kilobyte blocks currently used to
39 cache data and status information, and I<size> is the total current cache
40 size.
41
42 =head1 EXAMPLES
43
44 The following example shows the output on a machine with a 25000
45 kilobyte cache.
46
47     fs getcacheparms
48    AFS using 22876 of the cache's available 25000 1K byte blocks.
49
50 =head1 PRIVILEGE REQUIRED
51
52 None
53
54 =head1 COPYRIGHT
55
56 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
57
58 Converted from html to pod by Alf Wachsmann <alfw@slac.stanford.edu>, 2003,
59 and Elizabeth Cassell <e_a_c@mailsnare.net>, 2004,
60 Stanford Linear Accelerator Center, a department of Stanford University.
61
62 =head1 SEE ALSO
63
64 L<fs_setcachesize(1)>
65
66 =cut