edquota(1M)edquota(1M)NAMEedquota - 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
DESCRIPTIONedquota 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) ).
Page 1
edquota(1M)edquota(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.
Page 2
edquota(1M)edquota(1M)SEE ALSO
quota (1), vi (1), quotactl (2), quotacheck (1M), quotaon (1M), repquota
(1M), jot (1G)
Page 3
