unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



edquota(8)							   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 edi-
  tor 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)