quota.1

   1 .TH QUOTA 1
   2 .SH NAME
   3 quota \- display disk usage and limits
   4 .SH SYNOPSIS
   5 .B quota
   6 [
   7 .B -F
   8 .I format-name
   9 ] [
  10 .B -guqvswi
  11 ] [
  12 .BR -l \ |
  13 [
  14 .BR -QAm
  15 ]]
  16 .br
  17 .B quota
  18 [
  19 .B -F
  20 .I format-name
  21 ] [
  22 .B -qvswi
  23 ] [
  24 .BR -l \ |
  25 [
  26 .BR -QAm
  27 ]]
  28 .B -u
  29 .IR user ...
  30 .br
  31 .B quota
  32 [
  33 .B -F
  34 .I format-name
  35 ] [
  36 .B -qvswi
  37 ] [
  38 .BR -l \ |
  39 [
  40 .BR -QAm
  41 ]]
  42 .B -g
  43 .IR group ...
  44 .br
  45 .B quota
  46 [
  47 .B -F
  48 .I format-name
  49 ] [
  50 .B -qvswugQm
  51 ]
  52 .B -f
  53 .IR filesystem ...
  54 .SH DESCRIPTION
  55 .B quota
  56 displays users' disk usage and limits.
  57 By default only the user quotas are printed.
  58 .PP
  59 .B quota
  60 reports the quotas of all the filesystems listed in
  61 .BR /etc/mtab .
  62 For filesystems that are NFS-mounted a call to the rpc.rquotad on
  63 the server machine is performed to get the information.
  64 .SH OPTIONS
  65 .TP
  66 .B -F, --format=\f2format-name\f1
  67 Show quota for specified format (ie. don't perform format autodetection).
  68 Possible format names are:
  69 .B vfsold
  70 Original quota format with 16-bit UIDs / GIDs,
  71 .B vfsv0
  72 Quota format with 32-bit UIDs / GIDs, 64-bit space usage, 32-bit inode usage and limits,
  73 .B vfsv1
  74 Quota format with 64-bit quota limits and usage,
  75 .B rpc
  76 (quota over NFS),
  77 .B xfs
  78 (quota on XFS filesystem)
  79 .TP
  80 .B -g, --group
  81 Print group quotas for the group
  82 of which the user is a member.
  83 The optional
  84 .B group
  85 argument(s) restricts the display to the specified group(s).
  86 .TP
  87 .B -u, --user
  88 flag is equivalent to the default.
  89 .TP
  90 .B -v, --verbose
  91 will display quotas on filesystems
  92 where no storage is allocated.
  93 .TP
  94 .B -s, --human-readable
  95 option will make
  96 .BR quota (1)
  97 try to choose units for showing limits, used space and used inodes.
  98 .TP
  99 .B -p, --raw-grace
 100 When user is in grace period, report time in seconds since epoch when his grace
 101 time runs out (or has run out). Field is '0' when no grace time is in effect.
 102 This is especially useful when parsing output by a script.
 103 .TP
 104 .B -i, --no-autofs
 105 ignore mountpoints mounted by automounter
 106 .TP
 107 .B -l, --local-only
 108 report quotas only on local filesystems (ie. ignore NFS mounted filesystems).
 109 .TP
 110 .B -A, --all-nfs
 111 report quotas for all NFS filesystems even if they report to be on the same
 112 device.
 113 .TP
 114 .B -m, --no-mixed-pathnames
 115 Currently, pathnames of NFSv4 mountpoints are sent without leading slash in the path.
 116 .BR rpc.rquotad
 117 uses this to recognize NFSv4 mounts and properly prepend pseudoroot of NFS filesystem
 118 to the path. If you specify this option,
 119 .BR setquota
 120 will always send paths with a trailing slash. This can be useful for legacy reasons but
 121 be aware that quota over RPC will stop working if you are using new
 122 .BR rpc.rquotad .
 123 .TP
 124 .B -q, --quiet
 125 Print a more terse message,
 126 containing only information
 127 on filesystems where usage is over quota.
 128 .TP
 129 .B -Q, --quiet-refuse
 130 Do not print error message if connection to
 131 .BR rpc.rquotad
 132 is refused (usually this happens when
 133 .BR rpc.rquotad
 134 is not running on the server).
 135 .TP
 136 .B -w, --no-wrap
 137 Do not wrap the line if the device name is too long. This can be useful when parsing
 138 the output of
 139 .BR quota (1)
 140 by a script.
 141 .LP
 142 Specifying both
 143 .B \-g
 144 and
 145 .B \-u
 146 displays both the user quotas and the group quotas (for
 147 the user).
 148 .LP
 149 Only the super-user may use the
 150 .B \-u
 151 flag and the optional
 152 .B user
 153 argument to view the limits of other users.
 154 Non-super-users can use the the
 155 .B \-g
 156 flag and optional
 157 .B group
 158 argument to view only the limits of groups of which they are members.
 159 .LP
 160 The
 161 .B \-q
 162 flag takes precedence over the
 163 .B \-v
 164 flag.
 165 .SH DIAGNOSTICS
 166 If
 167 .B quota
 168 exits with a non-zero status, one or more filesystems
 169 are over quota.
 170 .SH FILES
 171 .PD 0
 172 .TP 20
 173 .B aquota.user " or " aquota.group
 174 quota file at the filesystem root (version 2 quota, non-XFS filesystems)
 175 .TP 20
 176 .B quota.user " or " quota.group
 177 quota file at the filesystem root (version 1 quota, non-XFS filesystems)
 178 .TP
 179 .B /etc/mtab
 180 default filesystems
 181 .PD
 182 .SH SEE ALSO
 183 .BR quotactl (2),
 184 .BR fstab (5),
 185 .BR edquota (8),
 186 .BR quotacheck (8),
 187 .BR quotaon (8),
 188 .BR quota_nld (8),
 189 .BR repquota (8),
 190 .DR warnquota (8)