161826Sbostic.\" Copyright (c) 1983, 1990, 1993 261826Sbostic.\" The Regents of the University of California. All rights reserved. 318960Smckusick.\" 441429Smckusick.\" This code is derived from software contributed to Berkeley by 541429Smckusick.\" Robert Elz at The University of Melbourne. 641429Smckusick.\" 743822Strent.\" %sccs.include.redist.man% 818960Smckusick.\" 9*68942Sbostic.\" @(#)edquota.8 8.2 (Berkeley) 04/27/95 1034369Sbostic.\" 11*68942Sbostic.Dd "" 12*68942Sbostic.Dt EDQUOTA 8 13*68942Sbostic.Os 14*68942Sbostic.Sh NAME 15*68942Sbostic.Nm edquota 16*68942Sbostic.Nd edit user quotas 17*68942Sbostic.Sh SYNOPSIS 18*68942Sbostic.Nm edquota 19*68942Sbostic.Op Fl u 20*68942Sbostic.Op Fl p Ar proto-username 21*68942Sbostic.Ar username ... 22*68942Sbostic.Nm edquota 23*68942Sbostic.Fl g 24*68942Sbostic.Op Fl p Ar proto-groupname 25*68942Sbostic.Ar groupname ... 26*68942Sbostic.Nm edquota 27*68942Sbostic.Fl t 28*68942Sbostic.Op Fl u 29*68942Sbostic.Nm edquota 30*68942Sbostic.Fl t 31*68942Sbostic.Fl g 32*68942Sbostic.Sh DESCRIPTION 33*68942Sbostic.Nm Edquota 34*68942Sbosticis a quota editor. 35*68942SbosticBy default, or if the 36*68942Sbostic.Fl u 37*68942Sbosticflag is specified, 3841429Smckusickone or more users may be specified on the command line. 3918960SmckusickFor each user a temporary file is created 4018960Smckusickwith an ASCII representation of the current 4141429Smckusickdisk quotas for that user. 4241429SmckusickThe list of filesystems with user quotas is determined from 43*68942Sbostic.Pa /etc/fstab . 4441429SmckusickAn editor is invoked on the ASCII file. 4541429SmckusickThe editor invoked is 46*68942Sbostic.Xr vi 1 47*68942Sbosticunless the environment variable 48*68942Sbostic.Ev EDITOR 49*68942Sbosticspecifies otherwise. 50*68942Sbostic.Pp 5141429SmckusickThe quotas may then be modified, new quotas added, etc. 5241429SmckusickSetting a quota to zero indicates that no quota should be imposed. 5341429SmckusickSetting a hard limit to one indicates that no allocations should 5441429Smckusickbe permitted. 5541429SmckusickSetting a soft limit to one with a hard limit of zero 5641429Smckusickindicates that allocations should be permitted on 57*68942Sbosticonly a temporary basis (see 58*68942Sbostic.Fl t 59*68942Sbosticbelow). 6041429SmckusickThe current usage information in the file is for informational purposes; 6141429Smckusickonly the hard and soft limits can be changed. 62*68942Sbostic.Pp 6341429SmckusickOn leaving the editor, 64*68942Sbostic.Nm edquota 6518960Smckusickreads the temporary file and modifies the binary 6618960Smckusickquota files to reflect the changes made. 67*68942Sbostic.Pp 6818960SmckusickIf the 69*68942Sbostic.Fl p 70*68942Sbosticflag is specified, 71*68942Sbostic.Nm edquota 7218960Smckusickwill duplicate the quotas of the prototypical user 7341429Smckusickspecified for each user specified. 7441429SmckusickThis is the normal mechanism used to 7541429Smckusickinitialize quotas for groups of users. 76*68942Sbostic.Pp 77*68942SbosticIf the 78*68942Sbostic.Fl g 79*68942Sbosticflag is specified, 80*68942Sbostic.Nm edquota 8141429Smckusickis invoked to edit the quotas of 8241429Smckusickone or more groups specified on the command line. 83*68942SbosticThe 84*68942Sbostic.Fl p 85*68942Sbosticflag can be specified in conjunction with 86*68942Sbosticthe 87*68942Sbostic.Fl g 88*68942Sbosticflag to specify a prototypical group 8941429Smckusickto be duplicated among the listed set of groups. 90*68942Sbostic.Pp 9141429SmckusickUsers are permitted to exceed their soft limits 9241429Smckusickfor a grace period that may be specified per filesystem. 9341429SmckusickOnce the grace period has expired, 9441429Smckusickthe soft limit is enforced as a hard limit. 9541429SmckusickThe default grace period for a filesystem is specified in 96*68942Sbostic.Pa /usr/include/ufs/ufs/quota.h . 97*68942SbosticThe 98*68942Sbostic.Fl t 99*68942Sbosticflag can be used to change the grace period. 100*68942SbosticBy default, or when invoked with the 101*68942Sbostic.Fl u 102*68942Sbosticflag, the grace period is set for all the filesystems with user 10341429Smckusickquotas specified in 104*68942Sbostic.Pa /etc/fstab . 105*68942SbosticWhen invoked with the 106*68942Sbostic.Fl g 107*68942Sbosticflag the grace period is 10841429Smckusickset for all the filesystems with group quotas specified in 109*68942Sbostic.Pa /etc/fstab . 11041429SmckusickThe grace period may be specified in days, hours, minutes, or seconds. 11141429SmckusickSetting a grace period to zero indicates that the default 11241429Smckusickgrace period should be imposed. 11341429SmckusickSetting a grace period to one second indicates that no 11441429Smckusickgrace period should be granted. 115*68942Sbostic.Pp 11618960SmckusickOnly the super-user may edit quotas. 117*68942Sbostic.Sh FILES 118*68942Sbostic.Bl -tag -width 24n -compact 119*68942Sbostic.It Pa quota.user 120*68942Sbosticat the filesystem root with user quotas 121*68942Sbostic.It Pa quota.group 122*68942Sbosticat the filesystem root with group quotas 123*68942Sbostic.It Pa /etc/fstab 124*68942Sbosticto find filesystem names and locations 125*68942Sbostic.El 126*68942Sbostic.Sh SEE ALSO 127*68942Sbostic.Xr quota 1 , 128*68942Sbostic.Xr quotactl 2 , 129*68942Sbostic.Xr fstab 5 , 130*68942Sbostic.Xr quotacheck 8 , 131*68942Sbostic.Xr quotaon 8 , 132*68942Sbostic.Xr repquota 8 133*68942Sbostic.Sh DIAGNOSTICS 13418960SmckusickVarious messages about inaccessible files; self-explanatory. 135