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

OPTIONS
  -g  Edits the quotas of one or more groups, specified by groupname on the
      command line.  When used with the -t option, 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 option, 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 option, the -U
      option, or no other options) or the prototypical group's name (when
      used with the -g or -G options).	The proto_username or proto_groupname
      must have a valid quota file. Establishing quotas for one user or group
      and then using the -p option 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 option or the -u
      option) or the prototypical group's id (when used with the -G option or
      the -g option).  The proto_userID or proto_groupID must have a valid
      quota file. Establishing quotas for one user or group and then using
      the -P option 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
      option, 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
      option, 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 option is the default.  The -u option, used with
      the -t option, 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 option used with the -t option, changes the grace
      period for all file systems with user quotas specified in the
      /etc/fstab file.

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

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 option). 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.

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.

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.

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.

SEE ALSO
  Commands: quota(1), quotacheck(8), quotaon(8)

  Functions: quotactl(2)

  Files: fstab(4)

Index for Section 8

Alphabetical listing for E

Top of page