doc/html/AdminReference/auarf161.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="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'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'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'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'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:
  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: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>