man-page-fs-read-not-list-20080711
[openafs.git] / doc / man-pages / pod1 / fs_listquota.pod
index 1e133d2..eaee582 100644 (file)
@@ -1,14 +1,20 @@
 =head1 NAME
 
-fs listquota - Displays quota information for a volume
+fs_listquota - Displays quota information for a volume
 
 =head1 SYNOPSIS
 
-B<fs listquota> [B<-path> <I<dir/file path>>+] [B<-help>]
+=for html
+<div class="synopsis">
 
-B<fs listq> [B<-p> <I<dir/file path>>+] [B<-h>]
+B<fs listquota> S<<< [B<-path> <I<dir/file path>>+] >>> [B<-help>]
 
-B<fs lq> [B<-p> <I<dir/file path>>+] [B<-h>]
+B<fs listq> S<<< [B<-p> <I<dir/file path>>+] >>> [B<-h>]
+
+B<fs lq> S<<< [B<-p> <I<dir/file path>>+] >>> [B<-h>]
+
+=for html
+</div>
 
 =head1 DESCRIPTION
 
@@ -22,6 +28,17 @@ examine> command.
 
 To set volume quota, use the B<fs setquota> or B<fs setvol> command.
 
+=head1 CAUTIONS
+
+Currently, the maximum size of a volume is 2 terabytes (2^31 bytes)
+and the maximum size of a /vicepX partition on a fileserver is also 2
+terabytes. The fileserver will not report an error when it has access
+to a partition larger than 2 terabytes, but it will probably fail if
+the administrator attempts to use more than 2 terabytes of space. In
+addition, there are reports of erroneous disk usage numbers when
+B<vos partinfo> or other OpenAFS disk reporting tools are used with
+partitions larger than 2 terabytes.
+
 =head1 OPTIONS
 
 =over 4
@@ -80,15 +97,15 @@ back to the volume to fail even when the volume has not reached its quota.
 The following example shows the output for the volume C<user.smith>:
 
    % fs listquota -path /afs/abc.com/usr/smith
-   Volume Name     Quota    Used    % Used   Partition 
-   user.smith      15000    5071       34%         86%   
+   Volume Name     Quota    Used    % Used   Partition
+   user.smith      15000    5071       34%         86%
 
 =head1 PRIVILEGE REQUIRED
 
-The issuer must have the C<l> (lookup) permission on the ACL of the root
+The issuer must have the C<r> (read) permission on the ACL of the root
 directory of the volume that houses the file or directory named by the
-B<-path> argument, and on the ACL of each directory that precedes it in
-the pathname.
+B<-path> argument, and C<l> (list) permission on the ACL of each 
+directory that precedes it in the pathname.
 
 =head1 SEE ALSO