.\" Copyright (c) 1983 Regents of the University of California.
.\" All rights reserved. The Berkeley software License Agreement
.\" specifies the terms and conditions for redistribution.
.\" @(#)quota.2 6.7 (Berkeley) 5/15/86
.TH QUOTA 2 "May 15, 1986"
quota \- manipulate disk quotas
.B #include <sys/quota.h>
.B quota(cmd, uid, arg, addr)
call manipulates disk quotas for file systems
that have had quotas enabled with
parameter indicates a command to be applied to
is a command specific argument and
is the address of an optional, command specific, data structure
that is copied in or out of the system. The interpretation of
is given with each command below.
Set disc quota limits and current usage for the user with ID
is a major-minor device indicating a particular file system.
is a pointer to a struct dqblk structure (defined in
This call is restricted to the super-user.
Get disc quota limits and current usage for the user with ID
The remaining parameters are as for Q_SETDLIM.
Set disc usage limits for the user with ID
is a major-minor device indicating a particular file system.
is a pointer to a struct dqusage structure (defined in
This call is restricted to the super-user.
Update the on-disc copy of quota usages.
is a major-minor device indicating the file system to be sync'ed.
parameter is specified as NODEV, all file systems that have
disc quotas will be sync'ed.
The \fIuid\fP and \fIaddr\fP parameters are ignored.
Change the calling process's quota limits to those of the
parameters are ignored. This call is restricted to the super-user.
Alter the disc usage warning limits for the user with ID
is a major-minor device indicating a particular file system.
is a pointer to a struct dqwarn structure (defined in
This call is restricted to the super-user.
Warn the user with user ID
about excessive disc usage.
This call causes the system to check its current disc usage
information and print a message on the terminal of
the caller for each file system on which the user is over quota.
If the user is under quota, his warning count is reset to MAX_*_WARN
parameter is specified as NODEV, all file systems that have
disc quotas will be checked. Otherwise,
indicates a specific major-minor device to be checked.
This call is restricted to the super-user.
A successful call returns 0,
otherwise the value \-1 is returned and the global variable
indicates the reason for the failure.
A \fIquota\fP call will fail when one of the following occurs:
The kernel has not been compiled with the QUOTA option.
No disc quota is found for the indicated user.
The call is priviledged and the caller was not the super-user.
parameter is being interpreted as a major-minor
device and it indicates an unmounted file system.
is supplied; the associated structure could not be copied in or out
setquota(2), quotaon(8), quotacheck(8)
There should be some way to integrate this call with the resource
limit interface provided by
The Australian spelling of
is used throughout the quota facilities in honor of