jimzah/openafs
1
0
Fork 0
mirror of https://git.openafs.org/openafs.git synced 2025-01-22 08:50:17 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
d7da1acc31
openafs/doc/html/AdminReference/auarf150.htm

114 lines
5.5 KiB
HTML
Raw Normal View History

initial-html-documentation-20010606 pull in all documentation from IBM
2001-06-06 20:09:07 +01:00
<!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="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>
<P>
<H2><A NAME="HDRFS_LISTQUOTA" HREF="auarf002.htm#ToC_164">fs listquota</A></H2>
<A NAME="IDX4869"></A>
<A NAME="IDX4870"></A>
<A NAME="IDX4871"></A>
<A NAME="IDX4872"></A>
<A NAME="IDX4873"></A>
<A NAME="IDX4874"></A>
<A NAME="IDX4875"></A>
<A NAME="IDX4876"></A>
<A NAME="IDX4877"></A>
<A NAME="IDX4878"></A>
<A NAME="IDX4879"></A>
<A NAME="IDX4880"></A>
<A NAME="IDX4881"></A>
<A NAME="IDX4882"></A>
<A NAME="IDX4883"></A>
<P><STRONG>Purpose</STRONG>
<P>Displays quota information for the volume containing a file or
directory.
<P><STRONG>Synopsis</STRONG>
<PRE><B>fs listquota</B> [<B>-path</B> &lt;<VAR>dir/file&nbsp;path</VAR>><SUP>+</SUP>] [<B>-help</B>]
<B>fs listq</B> [<B>-p</B> &lt;<VAR>dir/file&nbsp;path</VAR>><SUP>+</SUP>] [<B>-h</B>]
<B>fs lq</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 listquota</B> command displays information about the volume
containing each specified directory or file (its name, quota, and amount of
disk space used), along with an indicator of the percentage of space used on
the host partition.
<P>To display more information about the host partition, use the <B>fs
examine</B> command.
<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 a file or directory that resides in the volume about which to
produce output. 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 displays information about the volume that houses each specified
directory or file, in a tabular format that uses the following headers:
<DL>
<P><DT><B><TT>Volume Name</TT>
</B><DD>The name of the volume.
<P><DT><B><TT>Quota</TT>
</B><DD>The volume's quota in kilobytes, or the string <TT>no limit</TT> to
indicate an unlimited quota.
<P><DT><B><TT>Used</TT>
</B><DD>The number of kilobytes of quota used.
<P><DT><B><TT>% Used</TT>
</B><DD>The percentage of the volume's quota that is used (the
<TT>Used</TT> statistic divided by the <TT>Quota</TT> statistic, times
100).
<P><DT><B><TT>Partition</TT>
</B><DD>The percentage of space used on the partition that houses the
volume. Although not directly related to how much of the user's
quota is used, it is reported because a full partition can cause writing of
data back to the volume to fail even when the volume has not reached its
quota.
</DL>
<P><STRONG>Examples</STRONG>
<P>The following example shows the output for the volume
<B>user.smith</B>:
<PRE> %<B> fs listquota -path /afs/abc.com/usr/smith</B>
Volume Name Quota Used % Used Partition
user.smith 15000 5071 34% 86%
</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="auarf137.htm#HDRFS_DISKFREE">fs diskfree</A>
<P><A HREF="auarf138.htm#HDRFS_EXAMINE">fs examine</A>
<P><A HREF="auarf155.htm#HDRFS_QUOTA">fs quota</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="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>
<!-- 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>
Reference in New Issue Copy Permalink