src/WINNT/doc/install/Documentation/en_US/html/CmdRef/auarf158.htm

   1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3//EN">
   2 <HTML><HEAD>
   3 <TITLE>Administration Reference</TITLE>
   4 <!-- Begin Header Records  ========================================== -->
   5 <!-- /tmp/idwt3190/auarf000.scr converted by idb2h R4.2 (359) ID      -->
   6 <!-- Workbench Version (AIX) on 5 Nov 1999 at 13:58:29                -->
   7 <META HTTP-EQUIV="updated" CONTENT="Fri, 05 Nov 1999 13:58:29">
   8 <META HTTP-EQUIV="review" CONTENT="Sun, 05 Nov 2000 13:58:29">
   9 <META HTTP-EQUIV="expires" CONTENT="Mon, 05 Nov 2001 13:58: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="auarf157.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="auarf159.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="HDRFS_SETCACHESIZE" HREF="auarf002.htm#ToC_172">fs setcachesize</A></H2>
  19 <A NAME="IDX4947"></A>
  20 <A NAME="IDX4948"></A>
  21 <A NAME="IDX4949"></A>
  22 <A NAME="IDX4950"></A>
  23 <A NAME="IDX4951"></A>
  24 <A NAME="IDX4952"></A>
  25 <A NAME="IDX4953"></A>
  26 <A NAME="IDX4954"></A>
  27 <P><STRONG>Purpose</STRONG>
  28 <P>Sets the size of the disk cache
  29 <P><STRONG>Synopsis</STRONG>
  30 <PRE><B>fs setcachesize</B> [<B>-blocks</B> &lt;<VAR>size&nbsp;in&nbsp;1K&nbsp;byte&nbsp;blocks&nbsp;(0&nbsp;=>&nbsp;reset)</VAR>>]
  31                 [<B>-reset</B>]  [<B>-help</B>]
  32
  33 <B>fs setca</B>  [<B>-b</B> &lt;<VAR>size&nbsp;in&nbsp;1K&nbsp;byte&nbsp;blocks&nbsp;(0&nbsp;=>&nbsp;reset)</VAR>>]  [<B>-r</B>]  [<B>-h</B>]
  34
  35 <B>fs cachesize</B> [<B>-b</B> &lt;<VAR>size&nbsp;in&nbsp;1K&nbsp;byte&nbsp;blocks&nbsp;(0&nbsp;=>&nbsp;reset)</VAR>>]  [<B>-r</B>]  [<B>-h</B>]
  36
  37 <B>fs ca</B> [<B>-b</B> &lt;<VAR>size&nbsp;in&nbsp;1K&nbsp;byte&nbsp;blocks&nbsp;(0&nbsp;=>&nbsp;reset)</VAR>>]  [<B>-r</B>]  [<B>-h</B>]
  38 </PRE>
  39 <P><STRONG>Description</STRONG>
  40 <P>The <B>fs setcachesize</B> command changes the number of kilobyte
  41 blocks of local disk space available to the Cache Manager for its data cache,
  42 on machines that use a disk cache. The command is not operative on
  43 machines that use a memory cache.
  44 <P>To return the cache size to the default value specified in the third field
  45 of the local <B>/usr/vice/etc/cacheinfo</B> file, provide a value of
  46 <B>0</B> to the <B>-blocks</B> argument.
  47 <P>To return the cache size to the value set when the machine was last
  48 rebooted, use the <B>-reset</B> flag instead of the <B>-blocks</B>
  49 argument. This is normally the amount specified in the
  50 <B>cacheinfo</B> file, unless the <B>-blocks</B> argument was included
  51 on the <B>afsd</B> command to override the <B>cacheinfo</B>
  52 value.
  53 <P>To display the current cache size and amount of cache in use, for both disk
  54 and memory caches, use the <B>fs getcacheparms</B> command.
  55 <P><STRONG>Cautions</STRONG>
  56 <P>This command is not operative on machines using a memory cache, and results
  57 in an error message. To change memory cache size, edit the
  58 <B>cacheinfo</B> file and reboot, or reboot and provide the
  59 <B>-blocks</B> argument to the <B>afsd</B> command.
  60 <P>On machines using a disk cache, do not set the cache size to exceed 85% to
  61 90% of the actual disk space available for the cache directory. The
  62 cache implementation itself requires a small amount of space on the
  63 partition.
  64 <P><STRONG>Options</STRONG>
  65 <DL>
  66 <P><DT><B>-blocks
  67 </B><DD>Specifies the number of one-kilobyte blocks of disk space available for
  68 the Cache Manager to devote to the cache. Provide a value of
  69 <B>0</B> to set cache size to the default specified in the
  70 <B>cacheinfo</B> file.
  71 <P><DT><B>-reset
  72 </B><DD>Returns the cache size to the value set when the machine was last
  73 booted. This agrees with the value in the <B>cacheinfo</B> file
  74 unless the <B>-blocks</B> argument was used on the <B>afsd</B>
  75 command.
  76 <P><DT><B>-help
  77 </B><DD>Prints the online help for this command. All other valid options
  78 are ignored.
  79 </DL>
  80 <P><STRONG>Examples</STRONG>
  81 <P>The following command sets the disk cache size to 25000 kilobyte
  82 blocks.
  83 <PRE>   % <B>fs setcachesize -blocks 25000</B>
  84
  85 </PRE>
  86 <P>Both of the following commands reset the disk cache size to the value in
  87 the <B>cacheinfo</B> file, assuming that the <B>-blocks</B> argument
  88 to the <B>afsd</B> command was not used.
  89 <PRE>   % <B>fs setcachesize -blocks 0</B>
  90
  91    % <B>fs setcachesize -reset</B>
  92
  93 </PRE>
  94 <P><STRONG>Privilege Required</STRONG>
  95 <P>The issuer must be logged in as the local superuser <B>root</B>.
  96 <P><STRONG>Related Information</STRONG>
  97 <P><A HREF="auarf043.htm#HDRCACHEINFO">cacheinfo</A>
  98 <P><A HREF="auarf058.htm#HDRAFSD">afsd</A>
  99 <P><A HREF="auarf143.htm#HDRFS_GETCACHEPARMS">fs getcacheparms</A>
 100 <P>
 101 <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="auarf157.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="auarf159.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>
 102 <!-- Begin Footer Records  ========================================== -->
 103 <P><HR><B>
 104 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
 105 </B>
 106 <!-- End Footer Records  ============================================ -->
 107 <A NAME="Bot_Of_Page"></A>
 108 </BODY></HTML>