openafs/doc/html/AdminReference/auarf161.htm

93 lines
5.1 KiB
HTML
Raw Normal View History

<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 4//EN">
<HTML><HEAD>
<TITLE>Administration Reference</TITLE>
<!-- Begin Header Records ========================================== -->
<!-- /tmp/idwt3672/auarf000.scr converted by idb2h R4.2 (359) ID -->
<!-- Workbench Version (AIX) on 3 Oct 2000 at 16:18:30 -->
<META HTTP-EQUIV="updated" CONTENT="Tue, 03 Oct 2000 16:18:29">
<META HTTP-EQUIV="review" CONTENT="Wed, 03 Oct 2001 16:18:29">
<META HTTP-EQUIV="expires" CONTENT="Thu, 03 Oct 2002 16:18:29">
</HEAD><BODY>
<!-- (C) IBM Corporation 2000. All Rights Reserved -->
<BODY bgcolor="ffffff">
<!-- End Header Records ============================================ -->
<A NAME="Top_Of_Page"></A>
<H1>Administration Reference</H1>
<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>
<P>
<H2><A NAME="HDRFS_SETQUOTA" HREF="auarf002.htm#ToC_175">fs setquota</A></H2>
<A NAME="IDX4966"></A>
<A NAME="IDX4967"></A>
<A NAME="IDX4968"></A>
<A NAME="IDX4969"></A>
<A NAME="IDX4970"></A>
<P><STRONG>Purpose</STRONG>
<P>Sets the maximum quota for the volume containing a file or directory
<P><STRONG>Synopsis</STRONG>
<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>]
<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>]
<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>]
</PRE>
<P><STRONG>Description</STRONG>
<P>The <B>fs setquota</B> command sets the quota (maximum possible size)
of the read/write volume that contains the directory or file named by the
<B>-path</B> argument.
<P>To set the quota on multiple volumes at the same time, use the <B>fs
setvol</B> command.
<P>To display a volume's quota, use the <B>fs examine</B>, <B>fs
listquota</B> or <B>fs quota</B> command.
<P><STRONG>Options</STRONG>
<DL>
<P><DT><B>-path
</B><DD>Names the directory or file for which to set the host volume's
quota. Partial pathnames are interpreted relative to the current
working directory, which is also the default value if this argument is
omitted.
<P>Specify the read/write path to the file or directory, to avoid the failure
that results from attempting to change a read-only volume. By
convention, the read/write path is indicated by placing a period before the
cell name at the pathname's second level (for example,
<B>/afs/.abc.com</B>). For further discussion of the
concept of read/write and read-only paths through the filespace, see the
<B>fs mkmount</B> reference page.
<P><DT><B>-max
</B><DD>Sets the maximum amount of file server disk space the volume can
occupy. Specify the number of one-kilobyte blocks as a positive integer
(<B>1024</B> is one megabyte). A value of <B>0</B> sets an
unlimited quota, but the size of the disk partition that houses the volume
places an absolute limit on the volume's size.
<P>If the <B>-path</B> argument is omitted (to set the quota of the volume
housing the current working directory), the <B>-max</B> switch must be
included with this argument.
<P><DT><B>-help
</B><DD>Prints the online help for this command. All other valid options
are ignored.
</DL>
<P><STRONG>Examples</STRONG>
<P>The following command imposes a maximum quota of 3000 kilobytes on the
volume that houses the <B>/afs/abc.com/usr/smith</B>
directory:
<PRE> % <B>fs setquota -path /afs/abc.com/usr/smith -max 3000</B>
</PRE>
<P><STRONG>Privilege Required</STRONG>
<P>The issuer must belong to the <B>system:administrators</B>
group.
<P><STRONG>Related Information</STRONG>
<P><A HREF="auarf138.htm#HDRFS_EXAMINE">fs examine</A>
<P><A HREF="auarf150.htm#HDRFS_LISTQUOTA">fs listquota</A>
<P><A HREF="auarf155.htm#HDRFS_QUOTA">fs quota</A>
<P><A HREF="auarf153.htm#HDRFS_MKMOUNT">fs mkmount</A>
<P><A HREF="auarf163.htm#HDRFS_SETVOL">fs setvol</A>
<P>
<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>
<!-- Begin Footer Records ========================================== -->
<P><HR><B>
<br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A> All Rights Reserved
</B>
<!-- End Footer Records ============================================ -->
<A NAME="Bot_Of_Page"></A>
</BODY></HTML>