openafs/doc/html/AdminReference/auarf155.htm

91 lines
4.5 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="auarf154.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="auarf156.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_QUOTA" HREF="auarf002.htm#ToC_169">fs quota</A></H2>
<A NAME="IDX4913"></A>
<A NAME="IDX4914"></A>
<A NAME="IDX4915"></A>
<A NAME="IDX4916"></A>
<A NAME="IDX4917"></A>
<P><STRONG>Purpose</STRONG>
<P>Displays the percentage of quota used in the volume containing a directory
or file
<P><STRONG>Synopsis</STRONG>
<PRE><B>fs quota</B> [<B>-path</B> &lt;<VAR>dir/file&nbsp;path</VAR>><SUP>+</SUP>] [<B>-help</B>]
<B>fs q</B> [<B>-p</B> &lt;<VAR>dir/file&nbsp;path</VAR>><SUP>+</SUP>] [<B>-h</B>]
</PRE>
<P><STRONG>Description</STRONG>
<P>The <B>fs quota</B> command displays the percent of quota consumed in
the volume that contains each specified directory or file.
<P>To display more detailed information about the volume and the partition it
resides on, use the <B>fs examine</B> and <B>fs listquota</B>
commands.
<P>To set volume quota, use the <B>fs setquota</B> or <B>fs setvol</B>
command.
<P><STRONG>Options</STRONG>
<DL>
<P><DT><B>-path
</B><DD>Names each file or directory for which to display the quota consumed in
its parent volume. Partial pathnames are interpreted relative to the
current working directory, which is also the default value if this argument is
omitted.
<P><DT><B>-help
</B><DD>Prints the online help for this command. All other valid options
are ignored.
</DL>
<P><STRONG>Output</STRONG>
<P>The output reports the percent of volume quota used, in the following
format:
<PRE> <VAR>percent</VAR>% of quota used.
</PRE>
<P><STRONG>Examples</STRONG>
<P>The following command lists the percent quota used of the volume housing
the current working directory:
<PRE> %<B> fs quota</B>
17% of quota used.
</PRE>
<P>The following command lists the percent quota used of both the volume
housing the current working directory's parent directory and the volume
housing the directory <B>/afs/abc.com/usr/smith</B>:
<PRE> % <B>fs quota -path .. /afs/abc.com/usr/smith</B>
43% of quota used.
92% of quota used.
</PRE>
<P><STRONG>Privilege Required</STRONG>
<P>The issuer must have the <B>l</B> (<B>lookup</B>) permission on the
ACL of the root directory of the volume that houses the file or directory
named by the <B>-path</B> argument, and on the ACL of each directory that
precedes it in the pathname.
<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="auarf161.htm#HDRFS_SETQUOTA">fs setquota</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="auarf154.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="auarf156.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>