edquota(1M) 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.
Page 1
edquota(1M) edquota(1M)
-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)
Page 2