NAME

quotacheck − Checks file system quota consistency

SYNOPSIS

/usr/sbin/quotacheck [−guv] filesystem...

/usr/sbin/quotacheck −a [−guv] [−l number] [−t [no]type]

OPTIONS

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

−gChecks group quotas only. 

−l number
Specifies the maximum number of parallel quotacheck processes to run at one time. 

−t   [no]type
Specifies the file system type.  The supported file systems are as follows:

advfsAdvanced File System (AdvFS)

ufsUNIX 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 specified are checked. Note that the −t option is only valid when used with the −a option. 

−uChecks user quotas only. 

−vReports discrepancies between the calculated and recorded disk quotas. 

OPERANDS

filesystem
Specifies one or more file systems.  Specify any file system by entering 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 current 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 specified 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

/usr/sbin/quotacheck
Specifies the command path

[fileset_root]/quota.user
Contains user quotas for fileset

[fileset_root]/quota.group
Contains group quotas for fileset

/etc/fstab
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)