quotacheck(8)

NAME
quotacheck - scan a file system for disk usages

SYNOPSIS
quotacheck [-g] [-u] [-v] -a
quotacheck [-g] [-u] [-v] filesys ...

DESCRIPTION
Quotacheck performs a filesystems scan for usage of files and directories, used by either user or group. The output is the quota file for the corresponding filesystem. By default the names for these files are:
- A user scan: quota.user
- A group scan: quota.group

The resulting file consist of a struct dqblk for each possible id up to the highest existing uid or gid and contains the values for the disk file and block usage and possibly excess time for these values. ( for definitions of struct dqblk see <linux/quota.h> )

Quotacheck should be run each time the system boots and mounts non-valid file systems. This is most likely to happen after a system crash.

The speed of the scan decrease with the amount of directories increasing. The time needed doubles when disk usage is doubled as well. A 100 MB partition used for 94% is scanned in 1 minute, the same partition used for 50% is done in 25 seconds.

OPTIONS

-v  This way the program will give some usefull information about what it is doing, plus some fancy stuff.

-d  This means debug. It will result in a lot of information which can be used in debugging the program. The output is very verbose and the scan will not be fast.

-u  This flag tells the program to scan the disk and to count the files and directories used by a certain uid. This is the default action.

-g  This flag forces the program to count the the files and directories used by a certain gid.

-a  Check all of the quotas for the filesystems mentioned in /etc/fstab. Both user and group quotas are checked as indictated by the /etc/fstab options.

-R  When used in conjunction with -a, all filesystems except the root filesystem are checked for quotas.

NOTE
Quotacheck should only be run as Super User. Non-privilidged users are presumably not allowed to read all the directories on the given file system.

SEE ALSO
quota(1), quotactl(2), fstab(5), quotaon(8), quotaoff(8), edquota(8), repquota(8), fsck(8), efsck(8), e2fsck(8), xfsck(8)

FILES
quota.user, quota.group, /etc/fstab

AUTHOR
Edvard Tuinder <ed@elm.net>
Marco van Wieringen <mvw@planets.elm.net>