noble (1) quota.1.gz

Provided by: quota_4.06-1build6_amd64 bug

NAME

       quota - display disk usage and limits

SYNOPSIS

       quota [ -F format-name ] [ -guqvswi ] [ -l | [ -QAm ]]
       quota [ -F format-name ] [ -qvswi ] [ -l | [ -QAm ]] -u user...
       quota [ -F format-name ] [ -qvswi ] [ -l | [ -QAm ]] -g group...
       quota [ -F format-name ] [ -qvswi ] [ -l | [ -QAm ]] -P project...
       quota [ -F format-name ] [ -qvswugQm ] -f filesystem...

DESCRIPTION

       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).

       quota reports the quotas of all the filesystems listed in  /etc/mtab.   For  filesystems  that  are  NFS-
       mounted a call to the rpc.rquotad on the server machine is performed to get the information.

OPTIONS

       -F, --format=format-name
              Show  quota  for specified format (ie. don't perform format autodetection).  Possible format names
              are: vfsold Original quota format with 16-bit UIDs / GIDs, vfsv0 Quota format with 32-bit  UIDs  /
              GIDs,  64-bit  space  usage,  32-bit  inode usage and limits, vfsv1 Quota format with 64-bit quota
              limits and usage, rpc (quota over NFS), xfs (quota on XFS filesystem)

       -g, --group
              Print group quotas for the group of which the user is a member.  The  optional  group  argument(s)
              restricts the display to the specified group(s).

       -u, --user
              flag is equivalent to the default.

       -P, --project
              Print project quotas for the specified project.

       -v, --verbose
              will display quotas on filesystems where no storage is allocated.

       -s, --human-readable[=units]
              option  will  make  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 [ kgt ],[  kgt  ]  where
              the first character specifies space units and the second character specifies inode units.

       --always-resolve
              Always  try  to  translate  user  / group name to uid / gid even if the name is composed of digits
              only.

       -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.

       -i, --no-autofs
              ignore mountpoints mounted by automounter

       -l, --local-only
              report quotas only on local filesystems (ie. ignore NFS mounted filesystems).

       -A, --all-nfs
              report quotas for all NFS filesystems even if they report to be on the same device.

       -f, --filesystem-list
              report quotas only for filesystems specified on command line.

       --filesystem=path
              report quotas only for filesystem path.  This option can be specified  multiple  types  and  quota
              will  be  reported  for each specified filesystem. Unlike command line option -f remaining command
              like arguments are still treated as user / group / project names to report.

       -m, --no-mixed-pathnames
              Currently, pathnames of NFSv4 mountpoints are sent without leading slash in the path.  rpc.rquotad
              uses this to recognize NFSv4 mounts and properly prepend pseudoroot of NFS filesystem to the path.
              If you specify this option, 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
              rpc.rquotad.

       -q, --quiet
              Print a more terse message, containing only information on filesystems where usage is over quota.

       -Q, --quiet-refuse
              Do not print error message if connection to rpc.rquotad is  refused  (usually  this  happens  when
              rpc.rquotad is not running on the server).

       -w, --no-wrap
              Do not wrap the line if the device name is too long. This can be useful when parsing the output of
              quota(1) by a script.

       --show-mntpoint
              Show also mount point as a filesystem identification.

       --hide-device
              Do not show device name in a filesystem identification.

       Specifying both -g and -u displays both the user quotas and the group quotas (for the user).

       Only the super-user may use the -u flag and the optional 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 -g flag and optional group argument to view only the limits of groups of which they are members.

       The -q flag takes precedence over the -v flag.

DIAGNOSTICS

       If quota exits with a non-zero status, one or more filesystems are over quota.

FILES

       aquota.user  or  aquota.group
                           quota file at the filesystem root (version 2 quota, non-XFS filesystems)
       quota.user  or  quota.group
                           quota file at the filesystem root (version 1 quota, non-XFS filesystems)
       /etc/mtab           default filesystems

SEE ALSO

       quotactl(2), fstab(5), edquota(8), quotacheck(8), quotaon(8),  quota_nld(8),  repquota(8),  warnquota(8),
       setquota(8)

                                                                                                        QUOTA(1)