edquota(1M)

NAME
     edquota - edit user quotas

SYNOPSIS
     /usr/etc/edquota [ -n ] usernames...

     /usr/etc/edquota [ -n ] [ -p proto-user ] usernames...

     /usr/etc/edquota [ -n ] -t

     /usr/etc/edquota [ -n ] [ -f filesystem [ -l subopt=value ... ] ]

     /usr/etc/edquota [ -n ] [ -a [ -l subopt=value ... ] ]

     /usr/etc/edquota [ -n ] -i inputfile

DESCRIPTION
     edquota is a quota editor.  One or more users may be specified on the
     command line.  When used without the -f and -l options, a temporary file
     is created with an ASCII representation of the current disk quotas for
     each user and an editor is then invoked on that file.  The quotas may
     then be modified, new quotas added, etc.  Upon leaving the editor,
     edquota reads the temporary file and reflects the changes in the quota
     system using the quotactl(2) system call.

     The editor invoked is vi(1) unless the EDITOR environment variable
     specifies otherwise.  If a non-default editor is used, the editor must
     start itself in the foreground, otherwise the editor will see an empty
     file instead of quota data.  In particular, jot(1G) will not work as
     EDITOR without its -f option set.

     Only the super-user may edit quotas. Only quotas for local filesystems
     may be edited.  In order for quotas to be established on an EFS
     filesystem, the root directory of the filesystem must contain a file,
     owned by root, called quotas. XFS has no such restriction (see
     quotaon(1M) and quotas(4) for details). However, target XFS filesystems
     are required have quotas already turned on before setting quota limits
     using edquota.

     All disk limits are in given kilobytes. All disk limits are rounded off
     to the next multiple of filesystem block size (see mkfs_xfs(1M) ).

OPTIONS
     -n   Dry run. No actual modifications will be performed. The command will
          instead display what may have happened. This is useful in making a
          large number of changes as with the -i option.

     -p   Duplicate the quotas of the prototypical user specified for each
          user specified.  This is the normal mechanism used to initialize
          quotas for a small groups of users.
     -t   Edit the soft time limits for each file system.  If the time limits
          are zero, the default time limits in <sys/quota.h> are used.  Time
          units of sec(onds), min(utes), hour(s), day(s), week(s) and month(s)
          are understood.  Time limits are printed in the greatest possible
          time unit such that the value is greater than or equal to one.

     -i   Read in the limits from the file inputfile that was generated by
          repquota(1M).  This option is very useful in recreating the limits
          of a large number of users. Applies only to XFS filesystems.

     -f   Used only in conjunction with the -l option. This option is used to
          restrict the scope of the subsequent -l options to a single
          filesystem.  filesystem can be the block device or the name of the
          directory the XFS filesystem is mounted on. It is possible to have
          multiple -f options with any number of -l options in between.

     -a   Used only in conjunction with the -l option.  This option extends
          the scope of the subsequent -l options to all XFS filesystems that
          have quotas turned on.

     -l   uid=userid,bsoft=value,bhard=value,isoft=value,ihard=value where the
          values are the softlimits and hardlimits on disk blocks and files.
          Disk block limits are always specified in kilobytes.

     Example:
     /usr/etc/edquota -f /myxfsfilesys -l uid=998,bhard=1500,bsoft=1000

FILES
     quotas              quota file at the EFS file system root
     /etc/mtab           mounted file systems

BUGS
     Options -i, -f, -a, -l do not work on EFS filesystems.

SEE ALSO
     quota (1), vi (1), quotactl (2), quotacheck (1M), quotaon (1M), repquota
     (1M), jot (1G)