Index for Section 8

Alphabetical listing for E

Bottom of page

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
  proto_username, proto_groupname
      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.

  proto_userID, proto_groupID
      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
  -g	    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.

  -G	    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.

  -p proto_username | proto_groupname
	    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.

  -P proto_userID | proto_groupID
	    Initializes the specified quotas by duplicating 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.

  -t	    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.

  -u	    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.

  -U	    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 specified
	    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 limits 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 specified 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
  /usr/sbin/edquota
	    Specifies the command path

  [filesystem_root]/quota.user
	    Contains user quotas for file systems

  [filesystem_root]/quota.group
	    Contains group quotas for file systems

  /etc/fstab
	    Contains file system names and locations

RELATED INFORMATION
  quota(1), quotacheck(8), quotaon(8), quotactl(2), fstab(4).

Index for Section 8

Alphabetical listing for E

Top of page