logo

Manual Pages

Table of Contents

NAME

quota - control filer disk quotas

SYNOPSIS

quota [ on | off | resize ] [ volume ]

quota report [ path ]

DESCRIPTION

A quota limits the amount of disk space and the number of files that a particular user or group can consume. A quota can also restrict the total space and files used in a qtree, or the usage of users and groups within a qtree. A request that would cause a user or group to exceed an applicable quota fails with a ``disk quota exceeded'' error. A request that would cause the number of blocks or files in a qtree to exceed the qtree's limit fails with an ``out of disk space'' error.

User and group quotas do not apply to the root user; tree quotas, however, do apply even to root.

The quota command controls quotas, and the /etc/quotas file describes the quotas to impose. All quotas are established on a per-volume basis. For further information on the format of the /etc/quotas file, refer to the na_quotas(5) man page.

With no arguments, the quota command indicates whether quotas are on or off in each volume. The following list describes how to use the various quota commands:

quota on volume activates quotas in the specified volume based on the contents of /etc/quotas. The volume name may be omitted if the system has only one volume. Changing /etc/quotas has no effect until the next time quota on or quota resize is executed. The filer remembers whether quotas are on or off even after a reboot, so quota on should not be added to /etc/rc. When quotas are first turned on, the filer scans the file system to determine current file and space usage for each user and group with a quota. This may take several minutes during which quotas are not in effect, although the file system is still accessible. Executing quota with no arguments during this period indicates that quotas are initializing and reports how much of the initialization process has completed.

quota off volume turns quotas off on the specified volume. The volume name may be omitted if the system has only one volume.

quota resize volume
adjusts currently active quotas in the specified volume to reflect changes in the /etc/quotas file. For instance, if you edit an entry in /etc/quotas to increase a user's quota, quota resize will cause the change to take effect. The volume name may be omitted if the system has only one volume. quota resize can be used only when quotas are already on. Because it does not rescan the file system to compute usage, quota resize is faster than turning quotas off and then on again. quota resize will apply all updated entries in /etc/quotas; however, it will generally ignore newly added entries. A newly added entry will only take effect if the corresponding user or group has an active quota as a result of updating a file subject to default quotas.

quota report
prints the current file and space consumption for each user or group with a quota and for each qtree. With a path argument, quota report displays information about all quotas that apply to the file.

FILES

/etc/quotas
quota configuration file

SEE ALSO

na_rc(5), na_rquotad(8), na_qtree(1)

DIAGNOSTICS

If /etc/quotas is incorrectly formatted, or if a specified file doesn't exist, then quota on prints a warning and does not turn quotas on.

BUGS

Quotas do not count space consumed by snapshots. Doing so could put users into a state where they couldn't create any new files until all snapshots containing their old files expired, which could take a week or more. That seems like a worse bug.

It is possible for a quota to exceed its limit if files were created before quotas were turned on or during quota initialization.

Table of Contents