afsmonitor-document-stat-entries-correctly-20040729
[openafs.git] / doc / html / AdminReference / auarf017.htm
1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 4//EN">
2 <HTML><HEAD>
3 <TITLE>Administration Reference</TITLE>
4 <!-- Begin Header Records  ========================================== -->
5 <!-- /tmp/idwt3672/auarf000.scr converted by idb2h R4.2 (359) ID      -->
6 <!-- Workbench Version (AIX) on 3 Oct 2000 at 16:18:30                -->
7 <META HTTP-EQUIV="updated" CONTENT="Tue, 03 Oct 2000 16:18:29">
8 <META HTTP-EQUIV="review" CONTENT="Wed, 03 Oct 2001 16:18:29">
9 <META HTTP-EQUIV="expires" CONTENT="Thu, 03 Oct 2002 16:18:29">
10 </HEAD><BODY>
11 <!-- (C) IBM Corporation 2000. All Rights Reserved    --> 
12 <BODY bgcolor="ffffff"> 
13 <!-- End Header Records  ============================================ -->
14 <A NAME="Top_Of_Page"></A>
15 <H1>Administration Reference</H1>
16 <HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf016.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Bot_Of_Page"><IMG SRC="../bot.gif" BORDER="0" ALT="[Bottom of Topic]"></A> <A HREF="auarf018.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P> 
17 <P>
18 <H2><A NAME="HDRCACHEITEMS" HREF="auarf002.htm#ToC_15">CacheItems</A></H2>
19 <P><STRONG>Purpose</STRONG>
20 <A NAME="IDX3897"></A>
21 <A NAME="IDX3898"></A>
22 <A NAME="IDX3899"></A>
23 <P>Records information about each <B>V</B><VAR>n</VAR> file in a disk cache
24 <P><STRONG>Description</STRONG>
25 <P>The <B>CacheItems</B> file records information about each file in the
26 disk cache on a client machine (each <B>V</B><VAR>n</VAR> file). The
27 information includes the file ID number and associated volume version number
28 of the AFS file currently stored in the <B>V</B><VAR>n</VAR> file, which
29 enables the Cache Manager to determine which <B>V</B><VAR>n</VAR> file
30 contains the AFS data it needs to present to an application.
31 <P>As it initializes, the Cache Manager creates the binary-format
32 <B>CacheItems</B> file in the same local disk cache directory as the
33 <B>V</B><VAR>n</VAR> files that the <B>CacheItems</B> file describes,
34 and it must always remain there. The conventional directory name is
35 <B>/usr/vice/cache</B>, but it is acceptable to use a directory on a
36 partition with more available space.
37 <P><STRONG>Cautions</STRONG>
38 <P>Editing or removing the <B>CacheItems</B> file can cause a kernel
39 panic. If the contents of <B>V</B><VAR>n</VAR> files seem out of
40 date, clear the files by using the <B>fs flush</B> or <B>fs
41 flushvolume</B> command. If the <B>CacheItems</B> file is
42 accidentally modified or deleted, rebooting the machine usually restores
43 normal performance.
44 <P><STRONG>Related Information</STRONG>
45 <P><A HREF="auarf036.htm#HDRVN">V<I>n</I></A>
46 <P><A HREF="auarf040.htm#HDRVOLUMEITEMS">VolumeItems</A>
47 <P><A HREF="auarf043.htm#HDRCACHEINFO">cacheinfo</A>
48 <P><A HREF="auarf058.htm#HDRAFSD">afsd</A>
49 <P><A HREF="auarf140.htm#HDRFS_FLUSH">fs flush</A>
50 <P><A HREF="auarf142.htm#HDRFS_FLUSHVOLUME">fs flushvolume</A>
51 <P>
52 <HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf016.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Top_Of_Page"><IMG SRC="../top.gif" BORDER="0" ALT="[Top of Topic]"></A> <A HREF="auarf018.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P> 
53 <!-- Begin Footer Records  ========================================== -->
54 <P><HR><B> 
55 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved 
56 </B> 
57 <!-- End Footer Records  ============================================ -->
58 <A NAME="Bot_Of_Page"></A>
59 </BODY></HTML>