doc/html/AdminReference/auarf155.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="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>
  17 <P>
  18 <H2><A NAME="HDRFS_QUOTA" HREF="auarf002.htm#ToC_169">fs quota</A></H2>
  19 <A NAME="IDX4913"></A>
  20 <A NAME="IDX4914"></A>
  21 <A NAME="IDX4915"></A>
  22 <A NAME="IDX4916"></A>
  23 <A NAME="IDX4917"></A>
  24 <P><STRONG>Purpose</STRONG>
  25 <P>Displays the percentage of quota used in the volume containing a directory
  26 or file
  27 <P><STRONG>Synopsis</STRONG>
  28 <PRE><B>fs quota</B> [<B>-path</B> &lt;<VAR>dir/file&nbsp;path</VAR>><SUP>+</SUP>]  [<B>-help</B>]
  29
  30 <B>fs q</B> [<B>-p</B> &lt;<VAR>dir/file&nbsp;path</VAR>><SUP>+</SUP>]  [<B>-h</B>]
  31 </PRE>
  32 <P><STRONG>Description</STRONG>
  33 <P>The <B>fs quota</B> command displays the percent of quota consumed in
  34 the volume that contains each specified directory or file.
  35 <P>To display more detailed information about the volume and the partition it
  36 resides on, use the <B>fs examine</B> and <B>fs listquota</B>
  37 commands.
  38 <P>To set volume quota, use the <B>fs setquota</B> or <B>fs setvol</B>
  39 command.
  40 <P><STRONG>Options</STRONG>
  41 <DL>
  42 <P><DT><B>-path
  43 </B><DD>Names each file or directory for which to display the quota consumed in
  44 its parent volume. Partial pathnames are interpreted relative to the
  45 current working directory, which is also the default value if this argument is
  46 omitted.
  47 <P><DT><B>-help
  48 </B><DD>Prints the online help for this command. All other valid options
  49 are ignored.
  50 </DL>
  51 <P><STRONG>Output</STRONG>
  52 <P>The output reports the percent of volume quota used, in the following
  53 format:
  54 <PRE>   <VAR>percent</VAR>% of quota used.
  55
  56 </PRE>
  57 <P><STRONG>Examples</STRONG>
  58 <P>The following command lists the percent quota used of the volume housing
  59 the current working directory:
  60 <PRE>   %<B> fs quota</B>
  61    17% of quota used.
  62
  63 </PRE>
  64 <P>The following command lists the percent quota used of both the volume
  65 housing the current working directory's parent directory and the volume
  66 housing the directory <B>/afs/abc.com/usr/smith</B>:
  67 <PRE>   % <B>fs quota -path  ..  /afs/abc.com/usr/smith</B>
  68    43% of quota used.
  69    92% of quota used.
  70
  71 </PRE>
  72 <P><STRONG>Privilege Required</STRONG>
  73 <P>The issuer must have the <B>l</B> (<B>lookup</B>) permission on the
  74 ACL of the root directory of the volume that houses the file or directory
  75 named by the <B>-path</B> argument, and on the ACL of each directory that
  76 precedes it in the pathname.
  77 <P><STRONG>Related Information</STRONG>
  78 <P><A HREF="auarf138.htm#HDRFS_EXAMINE">fs examine</A>
  79 <P><A HREF="auarf150.htm#HDRFS_LISTQUOTA">fs listquota</A>
  80 <P><A HREF="auarf161.htm#HDRFS_SETQUOTA">fs setquota</A>
  81 <P><A HREF="auarf163.htm#HDRFS_SETVOL">fs setvol</A>
  82 <P>
  83 <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>
  84 <!-- Begin Footer Records  ========================================== -->
  85 <P><HR><B>
  86 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
  87 </B>
  88 <!-- End Footer Records  ============================================ -->
  89 <A NAME="Bot_Of_Page"></A>
  90 </BODY></HTML>