quotacheck - scan a filesystem for disk usage, create,
check and repair quota files
SYNOPSIS
quotacheck [ -gubcfinvdMmR ] [ -F quota-format ] -a |
filesystem
DESCRIPTION
quotacheck examines each filesystem, builds a table of
current disk usage, and compares this table against that
recorded in the disk quota file for the filesystem (this
step is ommitted if option -c is specified). If any
inconsistencies are detected, both the quota file and the
current system copy of the incorrect quotas are updated
(the latter only occurs if an active filesystem is
checked). By default, only user quotas are checked. quo
tacheck expects each filesystem to be checked to have
quota files named [a]quota.user and [a]quota.group located
at the root of the associated filesystem. If a file is
not present, quotacheck will create it.
If the quota file is corrupted, quotacheck tries to save
as much data as possible. Rescuing data may need user
intervention. With no additional options quotacheck will
simply exit in such a situation. When in interactive mode
(option -i) , the user is asked for advice. Advice can
also be provided from command line (see option -n) , which
is useful when quotacheck is run automatically (ie. from
script) and failure is unacceptable.
quotacheck should be run each time the system boots and
mounts non-valid filesystems. This is most likely to hap
pen after a system crash.
It is strongly recommended to run quotacheck with quotas
turned off on for the filesystem. Otherwise, possible dam
age or loss to data in the quota files can result. It is
also unwise to run quotacheck on a live filesystem as
actual usage may change during the scan. To prevent this,
quotacheck tries to remount the filesystem read-only
before starting the scan. After the scan is done it
remounts the filesystem read-write. You can disable this
with option -m. You can also make quotacheck ignore the
failure to remount the filesystem read-only with option
-M.
OPTIONS
-b Forces quotacheck to make backups of the quota file
before writing the new data.
-v quotacheck reports its operation as it progresses.
Normally it operates silently.
information which can be used in debugging the pro
gram. The output is very verbose and the scan will
be slow.
-u Only user quotas listed in /etc/mtab or on the
filesystems specified are to be checked. This is
the default action.
-g Only group quotas listed in /etc/mtab or on the
filesystems specified are to be checked.
-c Don't read existing quota files. Just perform a new
scan and save it to disk.
-f Forces checking of filesystems with quotas enabled.
This is not recommended as the created quota files
may be out of sync.
-M This flag forces checking of filesystem in read-
write mode if a remount fails. Do this only when
you are sure no process will write to a filesystem
while scanning.
-m Don't try to remount filesystem read-only. See com
ment with option -M.
-i Interactive mode. By default quotacheck exits when
it finds an error. In interactive mode user is
asked for input instead. See option -n.
-n If the quota files become corrupted, it is possible
for duplicate entries for a single user or group ID
to exist. Normally in this case, quotacheck exits
or asks user for input. When this option is set,
the first entry found is always used (this option
works in interactive mode too).
-F format-name
Check quota quota for specified format (ie. don't
perform format auto-detection). This is recommended
as detection might not work well on corrupted quota
files. Possible format names are: vfsold (version
1 quota), vfsv0 (version 2 quota), rpc (quota over
NFS), xfs (quota on XFS filesystem)
-a Check all mounted non-NFS filesystems in /etc/mtab
-R When used together with the -a option, all filesys
tems except for the root filesystem are checked for
quotas.
quotacheck should only be run by super-user. Non-privi
leged users are presumably not allowed to read all the
directories on the given filesystem.
SEE ALSO
quota(1), quotactl(2), fstab(5), quotaon(8), repquota(8),
convertquota(8), setquota(8), edquota(8), fsck(8),
efsck(8), e2fsck(8), xfsck(8)
FILES
aquota.user or aquota.group
located at filesystem root with quotas
(version 2 quota, non-XFS filesystems)
quota.user or quota.group
located at filesystem root with quotas
(version 1 quota, non-XFS filesystems)
/etc/mtab names and locations of mounted filesystems
AUTHOR
Jan Kara <jack@suse.cz>
Based on old quotacheck by:
Edvard Tuinder <ed@elm.net>
Marco van Wieringen <mvw@planets.elm.net>
Man(1) output converted with
man2html