2005-12-08 12:14:33 +00:00
|
|
|
=head1 NAME
|
|
|
|
|
2007-11-11 22:54:56 +00:00
|
|
|
fs_quota - Displays the quota used in the volume containing a directory or file
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
|
2006-03-01 05:02:29 +00:00
|
|
|
=for html
|
|
|
|
<div class="synopsis">
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2006-03-01 05:02:29 +00:00
|
|
|
B<fs quota> S<<< [B<-path> <I<dir/file path>>+] >>> [B<-help>]
|
|
|
|
|
|
|
|
B<fs q> S<<< [B<-p> <I<dir/file path>>+] >>> [B<-h>]
|
|
|
|
|
|
|
|
=for html
|
|
|
|
</div>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
|
2005-12-09 14:48:56 +00:00
|
|
|
The B<fs quota> command displays the percent of quota consumed in the
|
|
|
|
volume that contains each specified directory or file.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
To display more detailed information about the volume and the partition it
|
2005-12-09 14:48:56 +00:00
|
|
|
resides on, use the B<fs examine> and B<fs listquota> commands.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-09 14:48:56 +00:00
|
|
|
To set volume quota, use the B<fs setquota> or B<fs setvol> command.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2008-02-19 15:25:17 +00:00
|
|
|
=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.
|
|
|
|
|
2005-12-08 12:14:33 +00:00
|
|
|
=head1 OPTIONS
|
|
|
|
|
|
|
|
=over 4
|
|
|
|
|
2005-12-09 14:48:56 +00:00
|
|
|
=item B<-path> <I<dir/file path>>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
Names each file or directory for which to display the quota consumed in
|
|
|
|
its parent volume. Partial pathnames are interpreted relative to the
|
2005-12-09 14:48:56 +00:00
|
|
|
current working directory, which is also the default value if this
|
|
|
|
argument is omitted.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-09 14:48:56 +00:00
|
|
|
=item B<-help>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-09 14:48:56 +00:00
|
|
|
Prints the online help for this command. All other valid options are
|
|
|
|
ignored.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=back
|
|
|
|
|
|
|
|
=head1 OUTPUT
|
|
|
|
|
|
|
|
The output reports the percent of volume quota used, in the following
|
|
|
|
format:
|
|
|
|
|
2005-12-09 14:48:56 +00:00
|
|
|
<percent>% of quota used.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=head1 EXAMPLES
|
|
|
|
|
|
|
|
The following command lists the percent quota used of the volume housing
|
|
|
|
the current working directory:
|
|
|
|
|
|
|
|
% fs quota
|
|
|
|
17% of quota used.
|
|
|
|
|
|
|
|
The following command lists the percent quota used of both the volume
|
|
|
|
housing the current working directory's parent directory and the volume
|
2005-12-09 14:48:56 +00:00
|
|
|
housing the directory F</afs/abc.com/usr/smith>:
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-09 14:48:56 +00:00
|
|
|
% fs quota -path .. /afs/abc.com/usr/smith
|
2005-12-08 12:14:33 +00:00
|
|
|
43% of quota used.
|
|
|
|
92% of quota used.
|
|
|
|
|
|
|
|
=head1 PRIVILEGE REQUIRED
|
|
|
|
|
2008-07-12 07:54:58 +01:00
|
|
|
The issuer must have the C<r> (read) permission on the ACL of the root
|
2005-12-09 14:48:56 +00:00
|
|
|
directory of the volume that houses the file or directory named by the
|
2008-07-12 07:54:58 +01:00
|
|
|
B<-path> argument, and C<l> (list) permission on the ACL of each
|
|
|
|
directory that precedes it in the pathname.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=head1 SEE ALSO
|
|
|
|
|
|
|
|
L<fs_examine(1)>,
|
|
|
|
L<fs_listquota(1)>,
|
|
|
|
L<fs_setquota(1)>,
|
|
|
|
L<fs_setvol(1)>
|
|
|
|
|
|
|
|
=head1 COPYRIGHT
|
|
|
|
|
|
|
|
IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
|
|
|
|
|
|
|
|
This documentation is covered by the IBM Public License Version 1.0. It was
|
|
|
|
converted from HTML to POD by software written by Chas Williams and Russ
|
|
|
|
Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.
|