src/WINNT/doc/install/Documentation/en_US/html/CmdRef/auarf161.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="auarf160.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="auarf162.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_SETQUOTA" HREF="auarf002.htm#ToC_175">fs setquota</A></H2>
  19 <A NAME="IDX4966"></A>
  20 <A NAME="IDX4967"></A>
  21 <A NAME="IDX4968"></A>
  22 <A NAME="IDX4969"></A>
  23 <A NAME="IDX4970"></A>
  24 <P><STRONG>Purpose</STRONG>
  25 <P>Sets the maximum quota for the volume containing a file or directory
  26 <P><STRONG>Synopsis</STRONG>
  27 <PRE><B>fs setquota</B> [<B>-path</B> &lt;<VAR>dir/file&nbsp;path</VAR>>]  <B>-max</B> &lt;<VAR>max&nbsp;quota&nbsp;in&nbsp;kbytes</VAR>>  [<B>-help</B>]
  28
  29 <B>fs setq</B> [<B>-p</B> &lt;<VAR>dir/file&nbsp;path</VAR>>]  <B>-m</B> &lt;<VAR>max&nbsp;quota&nbsp;in&nbsp;kbytes</VAR>>  [<B>-h</B>]
  30
  31 <B>fs sq</B> [<B>-p</B> &lt;<VAR>dir/file&nbsp;path</VAR>>]  <B>-m</B> &lt;<VAR>max quota in kbytes</VAR>>  [<B>-h</B>]
  32 </PRE>
  33 <P><STRONG>Description</STRONG>
  34 <P>The <B>fs setquota</B> command sets the quota (maximum possible size)
  35 of the read/write volume that contains the directory or file named by the
  36 <B>-path</B> argument.
  37 <P>To set the quota on multiple volumes at the same time, use the <B>fs
  38 setvol</B> command.
  39 <P>To display a volume&#39;s quota, use the <B>fs examine</B>, <B>fs
  40 listquota</B> or <B>fs quota</B> command.
  41 <P><STRONG>Options</STRONG>
  42 <DL>
  43 <P><DT><B>-path
  44 </B><DD>Names the directory or file for which to set the host volume&#39;s
  45 quota. Partial pathnames are interpreted relative to the current
  46 working directory, which is also the default value if this argument is
  47 omitted.
  48 <P>Specify the read/write path to the file or directory, to avoid the failure
  49 that results from attempting to change a read-only volume. By
  50 convention, the read/write path is indicated by placing a period before the
  51 cell name at the pathname&#39;s second level (for example,
  52 <B>/afs/.abc.com</B>). For further discussion of the
  53 concept of read/write and read-only paths through the filespace, see the
  54 <B>fs mkmount</B> reference page.
  55 <P><DT><B>-max
  56 </B><DD>Sets the maximum amount of file server disk space the volume can
  57 occupy. Specify the number of one-kilobyte blocks as a positive integer
  58 (<B>1024</B> is one megabyte). A value of <B>0</B> sets an
  59 unlimited quota, but the size of the disk partition that houses the volume
  60 places an absolute limit on the volume&#39;s size.
  61 <P>If the <B>-path</B> argument is omitted (to set the quota of the volume
  62 housing the current working directory), the <B>-max</B> switch must be
  63 included with this argument.
  64 <P><DT><B>-help
  65 </B><DD>Prints the online help for this command. All other valid options
  66 are ignored.
  67 </DL>
  68 <P><STRONG>Examples</STRONG>
  69 <P>The following command imposes a maximum quota of 3000 kilobytes on the
  70 volume that houses the <B>/afs/abc.com/usr/smith</B>
  71 directory&#58;
  72 <PRE>   % <B>fs setquota -path /afs/abc.com/usr/smith -max 3000</B>
  73
  74 </PRE>
  75 <P><STRONG>Privilege Required</STRONG>
  76 <P>The issuer must belong to the <B>system&#58;administrators</B>
  77 group.
  78 <P><STRONG>Related Information</STRONG>
  79 <P><A HREF="auarf138.htm#HDRFS_EXAMINE">fs examine</A>
  80 <P><A HREF="auarf150.htm#HDRFS_LISTQUOTA">fs listquota</A>
  81 <P><A HREF="auarf155.htm#HDRFS_QUOTA">fs quota</A>
  82 <P><A HREF="auarf153.htm#HDRFS_MKMOUNT">fs mkmount</A>
  83 <P><A HREF="auarf163.htm#HDRFS_SETVOL">fs setvol</A>
  84 <P>
  85 <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="auarf160.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="auarf162.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>
  86 <!-- Begin Footer Records  ========================================== -->
  87 <P><HR><B>
  88 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
  89 </B>
  90 <!-- End Footer Records  ============================================ -->
  91 <A NAME="Bot_Of_Page"></A>
  92 </BODY></HTML>