fix-cbd-20051213
[openafs.git] / doc / man-pages / pod5 / CacheItems.pod
1 =head1 NAME
2
3 CacheItems - Records information about each VI<n> file in a disk cache
4
5 =head1 DESCRIPTION
6
7 The CacheItems file records information about each file in the
8 disk cache on a client machine (each B<V>I<n> file). The
9 information includes the file ID number and associated volume version number
10 of the AFS file currently stored in the B<V>I<n> file, which
11 enables the Cache Manager to determine which B<V>I<n> file
12 contains the AFS data it needs to present to an application.
13
14 As it initializes, the Cache Manager creates the binary-format
15 B<CacheItems> file in the same local disk cache directory as the
16 B<V>I<n> files that the B<CacheItems> file describes,
17 and it must always remain there. The conventional directory name is
18 B</usr/vice/cache>, but it is acceptable to use a directory on a
19 partition with more available space.
20
21 =head1 CAUTIONS
22
23 Editing or removing the CacheItems file can cause a kernel
24 panic. If the contents of B<V>I<n> files seem out of
25 date, clear the files by using the B<fs flush> or B<fs
26 flushvolume> command. If the B<CacheItems> file is
27 accidentally modified or deleted, rebooting the machine usually restores
28 normal performance.
29
30 =head1 SEE ALSO
31
32 L<VI<n>(1)>,
33 L<VolumeItems(1)>,
34 L<cacheinfo(1)>,
35 L<afsd(1)>,
36 L<fs_flush(1)>,
37 L<fs_flushvolume(1)>
38
39 =head1 COPYRIGHT
40
41 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
42
43 This documentation is covered by the IBM Public License Version 1.0.  It was
44 converted from HTML to POD by software written by Chas Williams and Russ
45 Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.