edquota(1M)                                                        edquota(1M)


NAME
     edquota - edit user or project quotas

SYNOPSIS
     /usr/etc/edquota [ -n ] [ -j|-g ] names...

     /usr/etc/edquota [ -n ] [ -j|-g ] [ -p proto-name ] names...

     /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 ] [ -j|-g ] -i inputfile

DESCRIPTION
     edquota is a quota editor.  When used with the -j option all operations
     are performed on project quotas and command line names are project names.
     When used with the -g option all operations are performed on group quotas
     and command line names are group names. Without the -j or -g option all
     operations are performed on user quotas and command line names are user
     names.  One or more users, group or project names 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, group or project 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 to have quotas already turned on before setting quota limits
     using edquota.  XFS also supports the notion of filesystem wide default
     limits - the soft and hard limits for the root user (ID zero) are used as
     defaults, if set, and are inherited by each new user/group/project or
     anyone that has their limits reset to zero.

     All disk limits are given in 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.

     -j   Project quotas.  Any name specified on the command line is
          considered a project name.  When used with the -i option, IDs in the
          inputfile are considered project IDs.

     -g   Group quotas. Any name specified on the command line is considered a
          group name.  when used with the -i option, IDs in the inputfile are
          considered group IDs.

     -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=UID|projid=PRID|gid=GID],bsoft=val,bhard=val,isoft=val,ihard=val
          where the vals 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 -j do not work on EFS filesystems.


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


                                                                        Page 3