edquota(8)						      System Manager's Manual							edquota(8)

NAME

       edquota - edits quotas

SYNOPSIS

       /usr/sbin/edquota [-gGuU] -t

       /usr/sbin/edquota [-p proto_username] [-u] username ...

       /usr/sbin/edquota [-P proto_userID] -U userID ...

       /usr/sbin/edquota [-P proto_userID] [-u] username ...

       /usr/sbin/edquota [-p proto_username] -U userID ...

       /usr/sbin/edquota [-p proto_groupname] -g groupname ...

       /usr/sbin/edquota [-P proto_groupID] -G groupID	...

       /usr/sbin/edquota [-P proto_groupID] -g groupname  ...

       /usr/sbin/edquota [-p proto_groupname] -G groupID ...

PARAMETERS

       Specifies  a  prototypical  user or group by the user name or group name.  A prototypical user or group has previously-defined, valid quota
       files that you want to duplicate for other user or group quota files.  Specifies a prototypical user or group by the user id or	group  id.
       A prototypical user or group has previously-defined, valid quota files that you want to duplicate for other user or group quota files.

FLAGS

       Edits  the quotas of one or more groups, specified by groupname on the command line.  When used with the -t flag, sets or changes the grace
       period for all file systems with group quotas specified in the /etc/fstab file.	Edits the quotas of  one  or  more  groups,  specified	by
       groupID on the command line.  When used with the -t flag, sets or changes the grace period for all file systems with group quotas specified
       in the /etc/fstab file.	Initializes the specified quotas by duplicating the established quotas of the prototypical user's name (when  used
       with the -u flag, the -U flag, or no other flags) or the prototypical group's name (when used with the -g or -G flags).	The proto_username
       or proto_groupname must have a valid quota file.  Establishing quotas for one user or group and then using the -p flag to  duplicate  these
       quotas for other users is the normal mechanism for initializing quotas for a group of users.  Initializes the specified quotas by duplicat-
       ing the established quotas of the prototypical user's id (when used with the -U flag or the -u flag) or the prototypical group's  id  (when
       used  with  the -G flag or the -g flag).  The proto_userID or proto_groupID must have a valid quota file.  Establishing quotas for one user
       or group and then using the -P flag to duplicate these quotas for other users is the normal mechanism for initializing quotas for  a  group
       of  users.  Sets or changes the default grace period for which users may exceed their soft limits.  By default, or when you specify -t with
       the -u flag, the grace period is set for all file systems with user quotas specified in the /etc/fstab file.  When you specify -t with  the
       -g  flag,  the grace period is set for all of the file systems with group quotas specified in the /etc/fstab file.  Edits the quotas of one
       or more users, specified by username ... on the command line.  The -u flag is the default.  The -u flag, used with the -t flag, changes the
       grace  period  for all file systems with user quotas specified in the /etc/fstab file.  Edits the quotas of one or more users, specified by
       userID ...  on the command line.  The -U flag used with the -t flag, changes the grace period for all file systems with user quotas  speci-
       fied in the /etc/fstab file.

DESCRIPTION

       The  edquota command is a quota editor that allows you to add and modify user and group quotas and modify file system  quota grace periods.
       Use the quota command to display the existing quota information.  Note that disk quotas are displayed as 1 kilobyte blocks.

       For each user or group specified, the edquota command creates a temporary file with an ASCII representation of the current quotas for  that
       user  or  group,  then  invokes	an editor to allow you to modify the file.  The vi editor is invoked by default.  To override the default,
       specify a different editor for the EDITOR environment variable in your login file.

       Setting a hard limit to 0 (zero) indicates that no quota should be imposed.  Setting a hard limit to 1 (one) indicates that no  allocations
       should  be permitted.  Setting a soft limit to 1 (one) with a hard limit of 0 (zero) indicates that allocations should be permitted on only
       a temporary basis (see the -t flag).  The current usage information in the file is for informational purposes; only the hard and soft  lim-
       its can be changed.

       For  each  file system, the edquota command creates a temporary file with an ASCII representation of the current grace period for that user
       or group, then invokes an editor to allow you to modify the grace period.  The grace period may be specified in days,  hours,  minutes,	or
       seconds.  Setting a grace period to 0 (zero) indicates that the default grace period should be imposed.	Setting a grace period to 1 second
       indicates that no grace period should be granted.  When you exit the editor, edquota reads the temporary file and modifies  the	quota.user
       and quota.group files for the target file system to reflect the changes made.

       Changes	in  grace periods take effect immediately unless a grace period is currently in effect.  For example, assume a user exceeds a soft
       limit and receives a grace period of 7 days.  A subsequent change to a grace period of 1 day will not  affect  the  user's  already-invoked
       grace  period,  unless the user drops below the soft limit and exceeds it once again.  The default grace period for a file system is speci-
       fied in the quota.user and quota.group files for the target file system.

RESTRICTIONS

       You can use the edquota command to edit only those file systems that are in the /etc/fstab file and have userquota and groupquota entries.

       You must be the root user to edit quotas.

NOTES

       The term file system represents either a UFS file system or an AdvFS fileset.

       The root user can exceed user and group quotas.	The fileset grace period is equal to the group grace period.  When  you  use  the  edquota
       command to set the group grace period for a fileset causes that same value to be used for the fileset grace period.

EXAMPLES

       To apply the existing quotas of the user named user1 to the user named user2:

       /usr/sbin/edquota -p user1 -u user2

       To apply the existing quotas of the user named user1 to the user named user2, using the default:

       /usr/sbin/edquota -p user1 user2

       To apply the existing quotas of the user with the user id 361 to the user with the user id 382:

       /usr/sbin/edquota -P 361 -U 382

       To apply the existing quotas of the user named user1 to the user with the user id 382:

       /usr/sbin/edquota -p user1 -U 382

FILES

       Specifies  the  command	path  Contains	user quotas for file systems Contains group quotas for file systems Contains file system names and
       locations

RELATED INFORMATION

       quota(1), quotacheck(8), quotaon(8), quotactl(2), fstab(4).  delim off

																	edquota(8)