xref: /illumos-gate/usr/src/man/man8/edquota.8 (revision bbf21555)
te
Copyright 1989 AT&T Copyright (c) 2003 Sun Microsystems, Inc. All Rights Reserved.
The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
EDQUOTA 8 "Feb 14, 2003"
NAME
edquota - edit user quotas for ufs file system
SYNOPSIS

edquota [-p proto_user] username...

edquota -t
DESCRIPTION

edquota is a quota editor. 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 for each mounted ufs file system that has a quotas file, and an editor is then invoked on the file. The quotas may then be modified, new quotas added, etc. Upon leaving the editor, edquota reads the temporary file and modifies the binary quota files to reflect the changes made.

The editor invoked is vi(1) unless the EDITOR environment variable specifies otherwise.

Only the super-user may edit quotas. In order for quotas to be established on a file system, the root directory of the file system must contain a file, owned by root, called quotas. (See quotaon(8).)

proto_user and username can be numeric, corresponding to the UID of a user. Unassigned UIDs may be specified; unassigned names may not. In this way, default quotas can be established for users who are later assigned a UID.

If no options are specified, the temporary file created will have one or more lines of the format, where a block is considered to be a 1024 byte (1K) block:

fs mount_point blocks (soft =number, \e
 hard =number ) inodes (soft =number, \e
 hard =number)

The number fields may be modified to reflect desired values.

OPTIONS

The following options are supported: -p

Duplicate the quotas of the proto_user specified for each username specified. This is the normal mechanism used to initialize quotas for groups of users.

-t

Edit the soft time limits for each file system. If the time limits are zero, the default time limits in /usr/include/sys/fs/ufs_quota.h are used. The temporary file created will have one or more lines of the form fs mount_point blocks time limit = number tmunit, files time limit = number tmunit

tmunit may be one of ``month'', ``week'', ``day'', ``hour'', ``min'' or ``sec''; characters appended to these keywords are ignored, so you may write ``months'' or ``minutes'' if you prefer. The number and tmunit fields may be modified to set desired values. Time limits are printed in the greatest possible time unit such that the value is greater than or equal to one. If ``default'' is printed after the tmunit, this indicates that the value shown is zero (the default).

USAGE

See largefile(7) for the description of the behavior of edquota when encountering files greater than or equal to 2 Gbyte ( 2^31 bytes).

FILES
quotas

quota file at the file system root

/etc/mnttab

table of mounted file systems

SEE ALSO

vi (1), quotactl (4I), attributes (7), largefile (7), quota (8), quotacheck (8), quotaon (8), repquota (8)

NOTES

All UIDs can be assigned quotas.