Index Index for
Section 8
Index Alphabetical
listing for Q
Bottom of page Bottom of
page

quotacheck(8)

NAME

quotacheck - Checks file system quota consistency

SYNOPSIS

/usr/sbin/quotacheck [-guv] filesystem... /usr/sbin/quotacheck -a [-guv] [-l number] [-t [no]type]

OPTIONS

-a 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. -g Checks 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: advfs Advanced File System (AdvFS) ufs 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 specified are checked. Note that the -t option is only valid when used with the -a option. -u Checks user quotas only. -v Reports 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)

Index Index for
Section 8
Index Alphabetical
listing for Q
Top of page Top of
page