1.\" Copyright (c) 1983, 1990, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" This code is derived from software contributed to Berkeley by 5.\" Robert Elz at The University of Melbourne. 6.\" 7.\" %sccs.include.redist.man% 8.\" 9.\" @(#)edquota.8 8.2 (Berkeley) 04/27/95 10.\" 11.Dd "" 12.Dt EDQUOTA 8 13.Os 14.Sh NAME 15.Nm edquota 16.Nd edit user quotas 17.Sh SYNOPSIS 18.Nm edquota 19.Op Fl u 20.Op Fl p Ar proto-username 21.Ar username ... 22.Nm edquota 23.Fl g 24.Op Fl p Ar proto-groupname 25.Ar groupname ... 26.Nm edquota 27.Fl t 28.Op Fl u 29.Nm edquota 30.Fl t 31.Fl g 32.Sh DESCRIPTION 33.Nm Edquota 34is a quota editor. 35By default, or if the 36.Fl u 37flag is specified, 38one or more users may be specified on the command line. 39For each user a temporary file is created 40with an ASCII representation of the current 41disk quotas for that user. 42The list of filesystems with user quotas is determined from 43.Pa /etc/fstab . 44An editor is invoked on the ASCII file. 45The editor invoked is 46.Xr vi 1 47unless the environment variable 48.Ev EDITOR 49specifies otherwise. 50.Pp 51The quotas may then be modified, new quotas added, etc. 52Setting a quota to zero indicates that no quota should be imposed. 53Setting a hard limit to one indicates that no allocations should 54be permitted. 55Setting a soft limit to one with a hard limit of zero 56indicates that allocations should be permitted on 57only a temporary basis (see 58.Fl t 59below). 60The current usage information in the file is for informational purposes; 61only the hard and soft limits can be changed. 62.Pp 63On leaving the editor, 64.Nm edquota 65reads the temporary file and modifies the binary 66quota files to reflect the changes made. 67.Pp 68If the 69.Fl p 70flag is specified, 71.Nm edquota 72will duplicate the quotas of the prototypical user 73specified for each user specified. 74This is the normal mechanism used to 75initialize quotas for groups of users. 76.Pp 77If the 78.Fl g 79flag is specified, 80.Nm edquota 81is invoked to edit the quotas of 82one or more groups specified on the command line. 83The 84.Fl p 85flag can be specified in conjunction with 86the 87.Fl g 88flag to specify a prototypical group 89to be duplicated among the listed set of groups. 90.Pp 91Users are permitted to exceed their soft limits 92for a grace period that may be specified per filesystem. 93Once the grace period has expired, 94the soft limit is enforced as a hard limit. 95The default grace period for a filesystem is specified in 96.Pa /usr/include/ufs/ufs/quota.h . 97The 98.Fl t 99flag can be used to change the grace period. 100By default, or when invoked with the 101.Fl u 102flag, the grace period is set for all the filesystems with user 103quotas specified in 104.Pa /etc/fstab . 105When invoked with the 106.Fl g 107flag the grace period is 108set for all the filesystems with group quotas specified in 109.Pa /etc/fstab . 110The grace period may be specified in days, hours, minutes, or seconds. 111Setting a grace period to zero indicates that the default 112grace period should be imposed. 113Setting a grace period to one second indicates that no 114grace period should be granted. 115.Pp 116Only the super-user may edit quotas. 117.Sh FILES 118.Bl -tag -width 24n -compact 119.It Pa quota.user 120at the filesystem root with user quotas 121.It Pa quota.group 122at the filesystem root with group quotas 123.It Pa /etc/fstab 124to find filesystem names and locations 125.El 126.Sh SEE ALSO 127.Xr quota 1 , 128.Xr quotactl 2 , 129.Xr fstab 5 , 130.Xr quotacheck 8 , 131.Xr quotaon 8 , 132.Xr repquota 8 133.Sh DIAGNOSTICS 134Various messages about inaccessible files; self-explanatory. 135