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 -g	[-f fspath] [-p	proto-groupname] groupname ...
     edquota -t	[-u] [-f fspath]
     edquota -t	-g [-f fspath]

DESCRIPTION
     Edquota 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 filesystems 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	invoked	with the -f option, edquota will read and modify quotas	on the
     filesystem	specified by fspath only.  The fspath argument may be either a
     special device or a filesystem mount point.  The primary purpose of this
     option is to set the scope	for the	-p option, which would overwrite quota
     records on	every filesystem 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.

     Users are permitted to exceed their soft limits for a grace period	that
     may be specified per filesystem.  Once the	grace period has expired, the
     soft limit	is enforced as a hard limit.  The default grace	period for a
     filesystem	is specified in	/usr/include/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 filesystems with user	quotas
     specified in /etc/fstab.  When invoked with the -g	flag the grace period
     is	set for	all the	filesystems 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 filesystem root with user quotas
     quota.group  at the filesystem root with group quotas
     /etc/fstab	  to find filesystem 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.2			 June 6, 1993			   FreeBSD 9.2

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+4.5-RELEASE>

home | help