Skip site navigation (1)Skip section navigation (2)

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
EDQUOTA(8)		FreeBSD	System Manager's Manual		    EDQUOTA(8)

NAME
     edquota --	edit user quotas

SYNOPSIS
     edquota [-u] [-f fspath] [-p proto-username] username ...
     edquota [-u] -e fspath[:bslim[:bhlim[:islim[:ihlim]]]] [-e	...] username
	     ...
     edquota -g	[-f fspath] [-p	proto-groupname] groupname ...
     edquota -g	-e fspath[:bslim[:bhlim[:islim[:ihlim]]]] [-e ...] groupname
	     ...
     edquota -t	[-u] [-f fspath]
     edquota -t	-g [-f fspath]

DESCRIPTION
     The edquota utility is a quota editor.  By	default, or if the -u flag is
     specified,	one or more users may be specified on the command line.	 For
     each user a temporary file	is created with	an ASCII representation	of the
     current disk quotas for that user.	 The list of file systems with user
     quotas is determined from /etc/fstab.  An editor is invoked on the	ASCII
     file.  The	editor invoked is vi(1)	unless the environment variable	EDITOR
     specifies otherwise.

     The quotas	may then be modified, new quotas added,	etc.  Setting a	quota
     to	zero indicates that no quota should be imposed.	 Setting a hard	limit
     to	one indicates that no allocations should be permitted.	Setting	a soft
     limit to one with a hard limit of zero indicates that allocations should
     be	permitted only on a temporary basis (see -t below).  The current usage
     information in the	file is	for informational purposes; only the hard and
     soft limits can be	changed.

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

     If	the -p option is specified, edquota will 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.  If the user
     given to assign quotas to is a numerical uid range	(e.g. 1000-2000), then
     edquota will duplicate the	quotas of the prototypical user	for each uid
     in	the range specified.  This allows for easy setup of default quotas for
     a group of	users.	The uids in question do	not have to be currently
     assigned in /etc/passwd.

     If	one or more -e fspath[:bslim[:bhlim[:islim[:ihlim]]]] options are
     specified,	edquota	will non-interactively set quotas defined by bslim,
     bhlim, islim, and ihlim on	each particular	file system referenced by
     fspath.  Here bslim is the	soft limit on the number of blocks, bslim is
     the hard limit on the number of blocks, islim is the soft limit on	the
     number of files, and ihlim	is the hard limit on the number	of files.  If
     any of the	bslim, bhlim, islim, and ihlim values is omitted, it is
     assumed to	be zero, therefore indicating that no particular quota should
     be	imposed.

     If	invoked	with the -f option, edquota will read and modify quotas	on the
     file system specified by fspath only.  The	fspath argument	may be either
     a special device or a file	system mount point.  The primary purpose of
     this option is to set the scope for the -p	option,	which would overwrite
     quota records on every file system	with quotas otherwise.

     If	the -g flag is specified, edquota is invoked to	edit the quotas	of one
     or	more groups specified on the command line.  The	-p flag	can be speci-
     fied in conjunction with the -g flag to specify a prototypical group to
     be	duplicated among the listed set	of groups.  Similarly, -e flag can be
     specified in conjunction with the -g flag to non-interactively set-up
     quotas on the listed set of groups.

     Users are permitted to exceed their soft limits for a grace period	that
     may be specified per file system.	Once the grace period has expired, the
     soft limit	is enforced as a hard limit.  The default grace	period for a
     file system is specified in <ufs/ufs/quota.h>.  The -t flag can be	used
     to	change the grace period.  By default, or when invoked with the -u
     flag, the grace period is set for all the file systems with user quotas
     specified in /etc/fstab.  When invoked with the -g	flag the grace period
     is	set for	all the	file systems with group	quotas specified in
     /etc/fstab.  The grace period may be specified in days, hours, minutes,
     or	seconds.  Setting a grace period to zero indicates that	the default
     grace period should be imposed.  Setting a	grace period to	one second
     indicates that no grace period should be granted.

     Only the super-user may edit quotas.

FILES
     quota.user	  at the file system root with user quotas
     quota.group  at the file system root with group quotas
     /etc/fstab	  to find file system names and	locations

SEE ALSO
     quota(1), quotactl(2), fstab(5), quotacheck(8), quotaon(8), repquota(8)

DIAGNOSTICS
     Various messages about inaccessible files;	self-explanatory.

FreeBSD	9.3			 June 6, 1993			   FreeBSD 9.3

NAME | SYNOPSIS | DESCRIPTION | FILES | SEE ALSO | DIAGNOSTICS

Want to link to this manual page? Use this URL:
<http://www.freebsd.org/cgi/man.cgi?query=edquota&sektion=8&manpath=FreeBSD+5.2-RELEASE>

home | help