NAME

       edquota - edit user quotas

SYNOPSIS

       edquota [ -p protoname ] [ -u | -g ] [ -rm ] [ -F format-name ] [ -f filesystem ] username...

       edquota [ -u | -g ] [ -F format-name ] [ -f filesystem ] -t

       edquota [ -u | -g ] [ -F format-name ] [ -f filesystem ] -T username | groupname...

DESCRIPTION

       edquota is a quota editor.  One or more users or groups may be specified on the command line. If a number
       is given in the place of user/group name it is treated as an UID/GID. For each user or group a  temporary
       file  is  created  with  an ASCII representation of the current disk quotas for that user or group and an
       editor is then invoked on the file.  The quotas may then be modified, new quotas added, etc.   Setting  a
       quota to zero indicates that no quota should be imposed.

       Block  usage  and  limits  are  reported and interpereted as multiples of kibibyte (1024 bytes) blocks by
       default. Symbols K, M, G, and T can be  appended  to  numeric  value  to  express  kibibytes,  mebibytes,
       gibibytes, and tebibytes.

       Inode usage and limits are interpreted literally. Symbols k, m, g, and t can be appended to numeric value
       to express multiples of 10^3, 10^6, 10^9, and 10^12 inodes.

       Users are permitted to exceed their soft limits for a grace period that may be specified per  filesystem.
       Once the grace period has expired, the soft limit is enforced as a hard limit.

       The  current  usage  information in the file is for informational purposes; only the hard and soft limits
       can be changed.

       Upon leaving the editor, edquota reads the temporary file and modifies the binary quota files to  reflect
       the changes made.

       The  editor  invoked  is  editor(1) unless either the EDITOR or the VISUAL environment variable specifies
       otherwise.

       Only the super-user may edit quotas.

OPTIONS

       -r, --remote
              Edit also non-local quota use rpc.rquotad on remote server to set quota.  This option is available
              only if quota tools were compiled with enabled support for setting quotas over RPC.  The -n option
              is equivalent, and is maintained for backward compatibility.

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

       -u, --user
              Edit the user quota. This is the default.

       -g, --group
              Edit the group quota.

       -p, --prototype=protoname
              Duplicate the quotas of the prototypical user specified for each  user  specified.   This  is  the
              normal mechanism used to initialize quotas for groups of users.

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

       -F, --format=format-name
              Edit 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)

       -f, --filesystem filesystem
              Perform  specified  operations only for given filesystem (default is to perform operations for all
              filesystems with quota).

       -t, --edit-period
              Edit the soft time limits for each filesystem.  In old quota format if the time limits  are  zero,
              the  default  time  limits  in  <linux/quota.h>  are used. In new quota format time limits must be
              specified (there is no default value set in kernel). Time units of 'seconds', 'minutes',  'hours',
              and  'days'  are  understood. Time limits are printed in the greatest possible time unit such that
              the value is greater than or equal to one.

       -T, --edit-times
              Edit time for the user/group when softlimit is enforced. Possible values are 'unset' or number and
              unit. Units are the same as in -t option.

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           mounted filesystems table

SEE ALSO

       quota(1), editor(1), quotactl(2), quotacheck(8), quotaon(8), repquota(8), setquota(8)

                                                                                                      EDQUOTA(8)