summaryrefslogtreecommitdiffstats
path: root/upstream/opensuse-leap-15-6/man1/quota.1
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-15 19:43:11 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-15 19:43:11 +0000
commitfc22b3d6507c6745911b9dfcc68f1e665ae13dbc (patch)
treece1e3bce06471410239a6f41282e328770aa404a /upstream/opensuse-leap-15-6/man1/quota.1
parentInitial commit. (diff)
downloadmanpages-l10n-fc22b3d6507c6745911b9dfcc68f1e665ae13dbc.tar.xz
manpages-l10n-fc22b3d6507c6745911b9dfcc68f1e665ae13dbc.zip
Adding upstream version 4.22.0.upstream/4.22.0
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'upstream/opensuse-leap-15-6/man1/quota.1')
-rw-r--r--upstream/opensuse-leap-15-6/man1/quota.1229
1 files changed, 229 insertions, 0 deletions
diff --git a/upstream/opensuse-leap-15-6/man1/quota.1 b/upstream/opensuse-leap-15-6/man1/quota.1
new file mode 100644
index 00000000..81668535
--- /dev/null
+++ b/upstream/opensuse-leap-15-6/man1/quota.1
@@ -0,0 +1,229 @@
+.TH QUOTA 1
+.SH NAME
+quota \- display disk usage and limits
+.SH SYNOPSIS
+.B quota
+[
+.B -F
+.I format-name
+] [
+.B -guqvswi
+] [
+.BR -l \ |
+[
+.BR -QAm
+]]
+.br
+.B quota
+[
+.B -F
+.I format-name
+] [
+.B -qvswi
+] [
+.BR -l \ |
+[
+.BR -QAm
+]]
+.B -u
+.IR user ...
+.br
+.B quota
+[
+.B -F
+.I format-name
+] [
+.B -qvswi
+] [
+.BR -l \ |
+[
+.BR -QAm
+]]
+.B -g
+.IR group ...
+.br
+.B quota
+[
+.B -F
+.I format-name
+] [
+.B -qvswi
+] [
+.BR -l \ |
+[
+.BR -QAm
+]]
+.B -P
+.IR project ...
+.br
+.B quota
+[
+.B -F
+.I format-name
+] [
+.B -qvswugQm
+]
+.B -f
+.IR filesystem ...
+.SH DESCRIPTION
+.B quota
+displays users' disk usage and limits.
+By default only the user quotas are printed. By default space usage and limits
+are shown in kbytes (and are named blocks for historical reasons).
+.PP
+.B quota
+reports the quotas of all the filesystems listed in
+.BR /etc/mtab .
+For filesystems that are NFS-mounted a call to the rpc.rquotad on
+the server machine is performed to get the information.
+.SH OPTIONS
+.TP
+.B -F, --format=\f2format-name\f1
+Show quota for specified format (ie. don't perform format autodetection).
+Possible format names are:
+.B vfsold
+Original quota format with 16-bit UIDs / GIDs,
+.B vfsv0
+Quota format with 32-bit UIDs / GIDs, 64-bit space usage, 32-bit inode usage and limits,
+.B vfsv1
+Quota format with 64-bit quota limits and usage,
+.B rpc
+(quota over NFS),
+.B xfs
+(quota on XFS filesystem)
+.TP
+.B -g, --group
+Print group quotas for the group
+of which the user is a member.
+The optional
+.B group
+argument(s) restricts the display to the specified group(s).
+.TP
+.B -u, --user
+flag is equivalent to the default.
+.TP
+.B -P, --project
+Print project quotas for the specified project.
+.TP
+.B -v, --verbose
+will display quotas on filesystems
+where no storage is allocated.
+.TP
+.B -s, --human-readable[=\f2units\f1]
+option will make
+.BR quota (1)
+try to choose units for showing limits, used space and used inodes. Units can
+be also specified explicitely by an optional argument in format [
+.BR kgt
+],[
+.BR kgt
+] where the first character specifies space units and the second character
+specifies inode units.
+.TP
+.B --always-resolve
+Always try to translate user / group name to uid / gid even if the name
+is composed of digits only.
+.TP
+.B -p, --raw-grace
+When user is in grace period, report time in seconds since epoch when his grace
+time runs out (or has run out). Field is '0' when no grace time is in effect.
+This is especially useful when parsing output by a script.
+.TP
+.B -i, --no-autofs
+ignore mountpoints mounted by automounter
+.TP
+.B -l, --local-only
+report quotas only on local filesystems (ie. ignore NFS mounted filesystems).
+.TP
+.B -A, --all-nfs
+report quotas for all NFS filesystems even if they report to be on the same
+device.
+.TP
+.B -f, --filesystem-list
+report quotas only for filesystems specified on command line.
+.TP
+.B -m, --no-mixed-pathnames
+Currently, pathnames of NFSv4 mountpoints are sent without leading slash in the path.
+.BR rpc.rquotad
+uses this to recognize NFSv4 mounts and properly prepend pseudoroot of NFS filesystem
+to the path. If you specify this option,
+.BR quota
+will always send paths with a leading slash. This can be useful for legacy reasons but
+be aware that quota over RPC will stop working if you are using new
+.BR rpc.rquotad .
+.TP
+.B -q, --quiet
+Print a more terse message,
+containing only information
+on filesystems where usage is over quota.
+.TP
+.B -Q, --quiet-refuse
+Do not print error message if connection to
+.BR rpc.rquotad
+is refused (usually this happens when
+.BR rpc.rquotad
+is not running on the server).
+.TP
+.B -w, --no-wrap
+Do not wrap the line if the device name is too long. This can be useful when parsing
+the output of
+.BR quota (1)
+by a script.
+.TP
+.B --show-mntpoint
+Show also mount point as a filesystem identification.
+.TP
+.B --hide-device
+Do not show device name in a filesystem identification.
+.LP
+Specifying both
+.B \-g
+and
+.B \-u
+displays both the user quotas and the group quotas (for
+the user).
+.LP
+Only the super-user may use the
+.B \-u
+flag and the optional
+.B user
+argument to view the limits of other users. Also viewing of project quota
+usage and limits is limited to super-user only.
+Non-super-users can use the
+.B \-g
+flag and optional
+.B group
+argument to view only the limits of groups of which they are members.
+.LP
+The
+.B \-q
+flag takes precedence over the
+.B \-v
+flag.
+.SH DIAGNOSTICS
+If
+.B quota
+exits with a non-zero status, one or more filesystems
+are over quota.
+.SH FILES
+.PD 0
+.TP 20
+.B aquota.user " or " aquota.group
+quota file at the filesystem root (version 2 quota, non-XFS filesystems)
+.TP 20
+.B quota.user " or " quota.group
+quota file at the filesystem root (version 1 quota, non-XFS filesystems)
+.TP
+.B /etc/mtab
+default filesystems
+.PD
+.SH SEE ALSO
+.BR quotactl (2),
+.BR fstab (5),
+.BR edquota (8),
+.BR quotacheck (8),
+.BR quotaon (8),
+.BR quota_nld (8),
+.BR repquota (8),
+.BR warnquota (8),
+.BR setquota (8)