doc/html/AdminReference/auarf150.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="auarf149.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="auarf151.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_LISTQUOTA" HREF="auarf002.htm#ToC_164">fs listquota</A></H2>
  19 <A NAME="IDX4869"></A>
  20 <A NAME="IDX4870"></A>
  21 <A NAME="IDX4871"></A>
  22 <A NAME="IDX4872"></A>
  23 <A NAME="IDX4873"></A>
  24 <A NAME="IDX4874"></A>
  25 <A NAME="IDX4875"></A>
  26 <A NAME="IDX4876"></A>
  27 <A NAME="IDX4877"></A>
  28 <A NAME="IDX4878"></A>
  29 <A NAME="IDX4879"></A>
  30 <A NAME="IDX4880"></A>
  31 <A NAME="IDX4881"></A>
  32 <A NAME="IDX4882"></A>
  33 <A NAME="IDX4883"></A>
  34 <P><STRONG>Purpose</STRONG>
  35 <P>Displays quota information for the volume containing a file or
  36 directory.
  37 <P><STRONG>Synopsis</STRONG>
  38 <PRE><B>fs listquota</B> [<B>-path</B> &lt;<VAR>dir/file&nbsp;path</VAR>><SUP>+</SUP>]  [<B>-help</B>]
  39
  40 <B>fs listq</B> [<B>-p</B> &lt;<VAR>dir/file&nbsp;path</VAR>><SUP>+</SUP>]  [<B>-h</B>]
  41
  42 <B>fs lq</B> [<B>-p</B> &lt;<VAR>dir/file&nbsp;path</VAR>><SUP>+</SUP>]  [<B>-h</B>]
  43 </PRE>
  44 <P><STRONG>Description</STRONG>
  45 <P>The <B>fs listquota</B> command displays information about the volume
  46 containing each specified directory or file (its name, quota, and amount of
  47 disk space used), along with an indicator of the percentage of space used on
  48 the host partition.
  49 <P>To display more information about the host partition, use the <B>fs
  50 examine</B> command.
  51 <P>To set volume quota, use the <B>fs setquota</B> or <B>fs setvol</B>
  52 command.
  53 <P><STRONG>Options</STRONG>
  54 <DL>
  55 <P><DT><B>-path
  56 </B><DD>Names a file or directory that resides in the volume about which to
  57 produce output. Partial pathnames are interpreted relative to the
  58 current working directory, which is also the default value if this argument is
  59 omitted.
  60 <P><DT><B>-help
  61 </B><DD>Prints the online help for this command. All other valid options
  62 are ignored.
  63 </DL>
  64 <P><STRONG>Output</STRONG>
  65 <P>The output displays information about the volume that houses each specified
  66 directory or file, in a tabular format that uses the following headers:
  67 <DL>
  68 <P><DT><B><TT>Volume Name</TT>
  69 </B><DD>The name of the volume.
  70 <P><DT><B><TT>Quota</TT>
  71 </B><DD>The volume's quota in kilobytes, or the string <TT>no limit</TT> to
  72 indicate an unlimited quota.
  73 <P><DT><B><TT>Used</TT>
  74 </B><DD>The number of kilobytes of quota used.
  75 <P><DT><B><TT>% Used</TT>
  76 </B><DD>The percentage of the volume's quota that is used (the
  77 <TT>Used</TT> statistic divided by the <TT>Quota</TT> statistic, times
  78 100).
  79 <P><DT><B><TT>Partition</TT>
  80 </B><DD>The percentage of space used on the partition that houses the
  81 volume. Although not directly related to how much of the user's
  82 quota is used, it is reported because a full partition can cause writing of
  83 data back to the volume to fail even when the volume has not reached its
  84 quota.
  85 </DL>
  86 <P><STRONG>Examples</STRONG>
  87 <P>The following example shows the output for the volume
  88 <B>user.smith</B>:
  89 <PRE>   %<B> fs listquota -path /afs/abc.com/usr/smith</B>
  90    Volume Name     Quota    Used    % Used   Partition
  91    user.smith      15000    5071       34%         86%
  92
  93 </PRE>
  94 <P><STRONG>Privilege Required</STRONG>
  95 <P>The issuer must have the <B>l</B> (<B>lookup</B>) permission on the
  96 ACL of the root directory of the volume that houses the file or directory
  97 named by the <B>-path</B> argument, and on the ACL of each directory that
  98 precedes it in the pathname.
  99 <P><STRONG>Related Information</STRONG>
 100 <P><A HREF="auarf137.htm#HDRFS_DISKFREE">fs diskfree</A>
 101 <P><A HREF="auarf138.htm#HDRFS_EXAMINE">fs examine</A>
 102 <P><A HREF="auarf155.htm#HDRFS_QUOTA">fs quota</A>
 103 <P><A HREF="auarf161.htm#HDRFS_SETQUOTA">fs setquota</A>
 104 <P><A HREF="auarf163.htm#HDRFS_SETVOL">fs setvol</A>
 105 <P>
 106 <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="auarf149.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="auarf151.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>
 107 <!-- Begin Footer Records  ========================================== -->
 108 <P><HR><B>
 109 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
 110 </B>
 111 <!-- End Footer Records  ============================================ -->
 112 <A NAME="Bot_Of_Page"></A>
 113 </BODY></HTML>