.\" a permission notice identical to this one.
.\"
.\" Since the Linux kernel and libraries are constantly changing, this
-.\" manual page may be incorrect or out-of-date. The author(s) assume.
-.\" no responsibility for errors or omissions, or for damages resulting.
-.\" from the use of the information contained herein. The author(s) may.
-.\" not have taken the same level of care in the production of this.
-.\" manual, which is licensed free of charge, as they might when working.
+.\" manual page may be incorrect or out-of-date. The author(s) assume
+.\" no responsibility for errors or omissions, or for damages resulting
+.\" from the use of the information contained herein. The author(s) may
+.\" not have taken the same level of care in the production of this
+.\" manual, which is licensed free of charge, as they might when working
.\" professionally.
.\"
.\" Formatted or processed versions of this manual, if unaccompanied by
.SH DESCRIPTION
.LP
The quota system can be used to set per-user and per-group limits on the
-amount of disk space used on a file system.
+amount of disk space used on a filesystem.
For each user and/or group,
-a soft limit and a hard limit can be set for each file system.
+a soft limit and a hard limit can be set for each filesystem.
The hard limit can't be exceeded.
The soft limit can be exceeded, but warnings will ensue.
Moreover, the user can't exceed the soft limit for more than one week
The
.I special
argument is a pointer to a null-terminated string containing the pathname
-of the (mounted) block special device for the file system being manipulated.
+of the (mounted) block special device for the filesystem being manipulated.
The
.I addr
value is one of the following:
.TP 8
.B Q_QUOTAON
-Turn on quotas for a file system.
+Turn on quotas for a filesystem.
The
.I id
argument is the identification number of the quota format to be used.
The
.IR addr
argument points to the pathname of a file containing the quotas for
-the file system.
+the filesystem.
The quota file must exist; it is normally created with the
.BR quotacheck (8)
program.
.RB ( CAP_SYS_ADMIN ).
.TP 8
.B Q_QUOTAOFF
-Turn off quotas for a file system.
+Turn off quotas for a filesystem.
The
.I addr
and
# define IIF_BGRACE 1
# define IIF_IGRACE 2
# define IIF_FLAGS 4
-# define IIF_ALL (IIF_BGRACE | IIF_IGRACE | IIF_FLAGS)
+# define IIF_ALL (IIF_BGRACE | IIF_IGRACE | IIF_FLAGS)
.fi
.in
.RB ( CAP_SYS_ADMIN ).
.TP
.B Q_GETFMT
-Get quota format used on the specified file system.
+Get quota format used on the specified filesystem.
The
.I addr
argument should be a pointer to a 4-byte buffer
where the format number will be stored.
.TP
.B Q_SYNC
-Update the on-disk copy of quota usages for a file system.
+Update the on-disk copy of quota usages for a filesystem.
If
.I special
-is NULL, then all file systems with active quotas are sync'ed.
+is NULL, then all filesystems with active quotas are sync'ed.
The
.I addr
and
.I dqstats
structure in which data should be stored.
This structure is defined in
-.IR <sys/quota.h>.
+.IR <sys/quota.h> .
The
.I special
and
.I /proc/sys/fs/quota/
carry the information instead.
.PP
-For XFS file systems making use of the XFS Quota Manager (XQM),
+For XFS filesystems making use of the XFS Quota Manager (XQM),
the above commands are bypassed and the following commands are used:
.TP 8
.B Q_XQUOTAON
-Turn on quotas for an XFS file system.
+Turn on quotas for an XFS filesystem.
XFS provides the ability to turn on/off quota limit enforcement
with quota accounting.
Therefore, XFS expects
.RB ( CAP_SYS_ADMIN ).
.TP
.B Q_XQUOTAOFF
-Turn off quotas for an XFS file system.
+Turn off quotas for an XFS filesystem.
As with
.BR Q_QUOTAON ,
-XFS file systems expect a pointer to an
+XFS filesystems expect a pointer to an
.I "unsigned int"
that specifies whether quota accounting and/or limit enforcement need
to be turned off.
.B Q_XGETQSTAT
Returns an
.I fs_quota_stat
-structure containing XFS file system specific quota information.
+structure containing XFS filesystem-specific quota information.
This is useful for finding out how much space is used to store quota
information, and also to get quotaon/off status of a given local XFS
-file system.
+filesystem.
.TP
.B Q_XQUOTARM
Free the disk space taken by disk quotas.
.B Q_SYNC
for XFS since
.BR sync (1)
-writes quota information to disk (in addition to the other file system
+writes quota information to disk (in addition to the other filesystem
metadata that it writes out).
-.SH RETURN VALUES
+.SH RETURN VALUE
.LP
On success,
.BR quotactl ()
.TP
.B ESRCH
No disk quota is found for the indicated user.
-Quotas have not been turned on for this file system.
+Quotas have not been turned on for this filesystem.
.LP
If
.I cmd
exists, but is not a regular file; or,
the quota file pointed to by
.I addr
-exists, but is not on the file system pointed to by
+exists, but is not on the filesystem pointed to by
.IR special .
.TP
.B EBUSY
.BR getrlimit (2),
.BR quotacheck (8),
.BR quotaon (8)
+.SH COLOPHON
+This page is part of release 3.79 of the Linux
+.I man-pages
+project.
+A description of the project,
+information about reporting bugs,
+and the latest version of this page,
+can be found at
+\%http://www.kernel.org/doc/man\-pages/.