quotacheck(8)quotacheck(8)NAMEquotacheck - Checks file system quota consistency
SYNOPSIS
/usr/sbin/quotacheck [-guv] filesystem...
/usr/sbin/quotacheck -a [-guv] [-l number] [-t [no]type]
OPTIONS
Checks all UFS and AdvFS file systems identified in the /etc/fstab file
as read/write with userquota and/or groupquota options specified, and a
pass number of 1 or greater. If -t option is specified, only the file
systems of the specified type will be checked. Alternatively, if type
is prefixed with no, then the valid file systems in the /etc/fstab file
that do not have that type will be checked. Checks group quotas only.
Specifies the maximum number of parallel quotacheck processes to run at
one time. Specifies the file system type. The supported file systems
are as follows: Advanced File System (AdvFS) UNIX File System (UFS)
See fstab(4) for a description of file system types. If the no
prefix is used, all of the above file types except the one spec‐
ified are checked. Note that the -t option is only valid when
used with the -a option. Checks user quotas only. Reports dis‐
crepancies between the calculated and recorded disk quotas.
OPERANDS
Specifies one or more file systems. Specify any file system by enter‐
ing its full path name. The full path name is the file system's mount
point in the /etc/fstab file. You can also specify a UFS file system
by entering the name of its device special file. For example:
/dev/disk/dsk3c. You can also specify an AdvFS fileset by entering the
name of the file domain, a pound sign (#), and the name of the fileset.
For example: root_domain#root.
DESCRIPTION
The quotacheck command examines each of the specified file systems,
building a table of current disk usage. It then compares this table
against the table stored in the disk quota file for the file system.
If any inconsistencies are detected, both the quota file and the cur‐
rent system copy of the incorrect quotas are updated.
The quotacheck-a command runs parallel passes on file systems using
the number specified in the /etc/fstab pass number field. The command
only checks file systems with pass number 1 or higher in the fsck
field. A file system with no pass number is not checked.
For both UFS file systems and AdvFS filesets, you should assign the
root file system a pass number of 1, and a value of 2 or higher to
other file systems. See fstab(4) for more information.
The quotacheck command checks only file systems that are mounted. UFS
file systems must also have userquota and/or groupquota options speci‐
fied in the /etc/fstab file. The userquota and groupquota options are
only needed for AdvFS file systems if quotas are actually going to be
enforced or if they are to be selected with the -a option.
By default, both user and group quotas listed in the /etc/fstab file
are checked. Use the -g option to specify that only group quotas be
checked; use the -u option to specify that only user quotas be checked.
The quotacheck command does not display activity information while
checking file systems. Use the -v option to report inconsistencies
found or procedures performed by the quotacheck command.
The file systems to be checked should be quiescent while the quotacheck
command is running, and no files should be open on the mount point. It
is recommended that system filesets /, /usr, /var be checked in single-
user mode, due to possible system background activity on these filesets
in multi-user mode.
NOTES
The term file system represents either a UFS file system or an AdvFS
fileset.
RESTRICTION
You must be the root user to run the quotacheck command.
FILES
Specifies the command path Contains user quotas for fileset Contains
group quotas for fileset Contains file system names and locations
SEE ALSO
Commands: edquota(8), fsck(8), quota(1), quotaon(8), repquota(8)
Functions: quotactl(2)
Files: fstab(4)quotacheck(8)