4.4BSD/usr/share/man/cat8/edquota.0

EDQUOTA(8)         BSD System Manager's Manual         EDQUOTA(8)


NNAAMMEE
       edquota - edit user quotas

SSYYNNOOPPSSIISS
       eeddqquuoottaa [ _-_u ] [ _-_p proto-username ] username ...
       eeddqquuoottaa _-_g [ _-_p proto-groupname ] groupname ...
       eeddqquuoottaa _-_t [ _-_u ]
       eeddqquuoottaa _-_t _-_g

DDEESSCCRRIIPPTTIIOONN
       _E_d_q_u_o_t_a  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 _/_e_t_c_/_f_s_t_a_b.  An editor  is  invoked  on
       the  ASCII  file.   The editor invoked is _v_i(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  on  only  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, _e_d_q_u_o_t_a reads  the  temporary  file
       and modifies the binary quota files to reflect the changes
       made.

       If the --pp option is specified, _e_d_q_u_o_t_a will duplicate  the
       quotas  of  the  prototypical user specified for each user
       specified.  This is the normal mechanism used to  initial-
       ize quotas for groups of users.

       If  the  _-_g  flag is specified, _e_d_q_u_o_t_a is invoked to edit
       the quotas of one or more groups specified on the  command
       line.   The  _-_p  flag can be specified in conjunction with
       the _-_g flag to specify a prototypical group to  be  dupli-
       cated 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  filesys-
       tem is specified in _/_u_s_r_/_i_n_c_l_u_d_e_/_u_f_s_/_q_u_o_t_a_._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



4.2 Berkeley Distribution  June 6, 1993                         1








EDQUOTA(8)         BSD System Manager's Manual         EDQUOTA(8)


       all  the  filesystems  with  user  quotas   specified   in
       _/_e_t_c_/_f_s_t_a_b.   When  invoked  with  the  _-_g  flag the grace
       period is set for all the filesystems  with  group  quotas
       specified  in  _/_e_t_c_/_f_s_t_a_b.  The grace period may be speci-
       fied 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.

FFIILLEESS
       _q_u_o_t_a_._u_s_e_r     at the filesystem root with user quotas
       _q_u_o_t_a_._g_r_o_u_p    at the filesystem root with group quotas
       /etc/fstab     to find filesystem names and locations

SSEEEE AALLSSOO
       quota(1),   quotactl(2),   fstab(5),  quotacheck(8),  quo-
       taon(8), repquota(8)

DDIIAAGGNNOOSSTTIICCSS
       Various   messages   about   inaccessible   files;   self-
       explanatory.































4.2 Berkeley Distribution  June 6, 1993                         2