mirror of
https://git.openafs.org/openafs.git
synced 2025-01-19 23:40:13 +00:00
e3dfba8e6c
This is the initial conversion of the AFS Adminstrators Reference into POD for use as man pages. The man pages are now generated via pod2man from regen.sh so that only those working from CVS have to have pod2man available. The Makefile only installs. The pages have also been sorted out into pod1, pod5, and pod8 directories, making conversion to the right section of man page easier without maintaining a separate list and allowing for names to be duplicated between pod5 and pod1 or pod8 (which will likely be needed in a few cases). This reconversion is done with a new script based on work by Chas Williams. In some cases, the output is worse than the previous POD pages, but this is a more comprehensive conversion. This is only the first step, and this initial conversion has various problems. In addition, the file man pages that didn't have simple names have not been converted in this pass and will be added later. Some of the man pages have syntax problems and all of them have formatting errors. The next editing pass, coming shortly, will clean up most of the remaining mess.
91 lines
2.6 KiB
Plaintext
91 lines
2.6 KiB
Plaintext
=head1 NAME
|
|
|
|
fs setquota - Sets the maximum quota for the volume containing a file or directory
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
B<fs setquota> [B<-path> <I<dir/file path>>] B<-max> <I<max quota in kbytes>> [-help]
|
|
|
|
B<fs setq> [B<-p> <I<dir/file path>>] B<-m> <I<max quota in kbytes>> [-h]
|
|
|
|
B<fs sq> [B<-p> <I<dir/file path>>] B<-m> <I<max quota in kbytes>> [-h]
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
The fs setquota command sets the quota (maximum possible size)
|
|
of the read/write volume that contains the directory or file named by the
|
|
B<-path> argument.
|
|
|
|
To set the quota on multiple volumes at the same time, use the fs
|
|
setvol command.
|
|
|
|
To display a volume's quota, use the B<fs examine>, fs
|
|
listquota or B<fs quota> command.
|
|
|
|
=head1 OPTIONS
|
|
|
|
=over 4
|
|
|
|
=item -path
|
|
|
|
Names the directory or file for which to set the host volume's
|
|
quota. Partial pathnames are interpreted relative to the current
|
|
working directory, which is also the default value if this argument is
|
|
omitted.
|
|
|
|
Specify the read/write path to the file or directory, to avoid the failure
|
|
that results from attempting to change a read-only volume. By
|
|
convention, the read/write path is indicated by placing a period before the
|
|
cell name at the pathname's second level (for example,
|
|
B</afs/.abc.com>). For further discussion of the
|
|
concept of read/write and read-only paths through the filespace, see the
|
|
B<fs mkmount> reference page.
|
|
|
|
=item -max
|
|
|
|
Sets the maximum amount of file server disk space the volume can
|
|
occupy. Specify the number of one-kilobyte blocks as a positive integer
|
|
(B<1024> is one megabyte). A value of B<0> sets an
|
|
unlimited quota, but the size of the disk partition that houses the volume
|
|
places an absolute limit on the volume's size.
|
|
|
|
If the -path argument is omitted (to set the quota of the volume
|
|
housing the current working directory), the B<-max> switch must be
|
|
included with this argument.
|
|
|
|
=item -help
|
|
|
|
Prints the online help for this command. All other valid options
|
|
are ignored.
|
|
|
|
=back
|
|
|
|
=head1 EXAMPLES
|
|
|
|
The following command imposes a maximum quota of 3000 kilobytes on the
|
|
volume that houses the B</afs/abc.com/usr/smith>
|
|
directory:
|
|
|
|
% fs setquota -path /afs/abc.com/usr/smith -max 3000
|
|
|
|
=head1 PRIVILEGE REQUIRED
|
|
|
|
The issuer must belong to the system:administrators
|
|
group.
|
|
|
|
=head1 SEE ALSO
|
|
|
|
L<fs_examine(1)>,
|
|
L<fs_listquota(1)>,
|
|
L<fs_quota(1)>,
|
|
L<fs_mkmount(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.
|