From 8c82de96cd23e4823a2d29eb2de2295c0866b0c9 Mon Sep 17 00:00:00 2001 From: Yang Lin Date: Wed, 30 May 2012 19:43:21 +0800 Subject: Initial commit to Gerrit --- quotacheck.8 | 197 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 197 insertions(+) create mode 100644 quotacheck.8 (limited to 'quotacheck.8') diff --git a/quotacheck.8 b/quotacheck.8 new file mode 100644 index 0000000..ed23e73 --- /dev/null +++ b/quotacheck.8 @@ -0,0 +1,197 @@ +.TH quotacheck 8 "Fri Jul 20 2001" +.SH NAME +quotacheck \- scan a filesystem for disk usage, create, check and repair quota files +.SH SYNOPSIS +.B quotacheck +[ +.B \-gubcfinvdMmR +] [ +.B \-F +.I quota-format +] +.B \-a +| +.I filesystem +.br +.SH DESCRIPTION +.B 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 +.B -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 which is not advised). +By default, only user quotas are checked. +.B quotacheck +expects each filesystem to be checked to have quota files named +.I [a]quota.user +and +.I [a]quota.group +located at the root of the associated filesystem. If a file is not +present, +.B quotacheck +will create it. +.PP +If the quota file is corrupted, +.B quotacheck +tries to save as much data as possible. Rescuing data may need user +intervention. With no additional options +.B quotacheck +will simply exit in such a situation. When in interactive mode (option +.BR -i ) +, the user is asked for advice. Advice can also be provided from command +line (see option +.BR -n ) +, which is useful when +.B quotacheck +is run automatically (ie. from script) and failure is unacceptable. +.PP +.B quotacheck +should be run each time the system boots and mounts non-valid filesystems. +This is most likely to happen after a system crash. +.PP +It is strongly recommended to run +.B quotacheck +with quotas turned off for the filesystem. Otherwise, possible damage +or loss to data in the quota files can result. It is also unwise to +run +.B quotacheck +on a live filesystem as actual usage may change during the scan. To +prevent this, +.B 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 +.BR \-m . +You can also make +.B quotacheck +ignore the failure to remount the filesystem read-only with option +.BR \-M . +.SH OPTIONS +.TP +.B -b, --backup +Forces +.B quotacheck +to make backups of the quota file before writing the new data. +.TP +.B -v, --verbose +.B quotacheck +reports its operation as it progresses. Normally it operates silently. +If the option is specified twice, also the current directory is printed (note +that printing can slow down the scan measurably). +.TP +.B -d, --debug +Enable debugging mode. 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 be slow. +.TP +.B -u, --user +Only user quotas listed in +.I /etc/mtab +or on the filesystems specified are to be checked. This is the default action. +.TP +.B -g, --group +Only group quotas listed in +.I /etc/mtab +or on the filesystems specified are to be checked. +.TP +.B -c, --create-files +Don't read existing quota files. Just perform a new scan and save it to disk. +.B quotacheck +also skips scanning of old quota files when they are not found. +.TP +.B -f, --force +Forces checking and writing of new quota files on filesystems with quotas +enabled. This is not recommended as the created quota files may be out of sync. +.TP +.B -M, --try-remount +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. +.TP +.B -m, --no-remount +Don't try to remount filesystem read-only. See comment with option +.BR \-M . +.TP +.B -i, --interactive +Interactive mode. By default +.B quotacheck +exits when it finds an error. In interactive mode user is asked for +input instead. See option +.BR \-n . +.TP +.B -n, --use-first-dquot +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, +.B 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). +.TP +.B -F, --format=\f2format-name\f1 +Check and fix quota files of 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: +.B vfsold +Original quota format with 16-bit UIDs / GIDs, +.B vfsv0 +Quota format with 32-bit UIDs / GIDs, 64-bit space usage, 32-bit inode usage and limits, +.B vfsv1 +Quota format with 64-bit quota limits and usage, +.B rpc +(quota over NFS), +.B xfs +(quota on XFS filesystem) +.TP +.B -a, --all +Check all mounted non-NFS filesystems in +.B /etc/mtab +.TP +.B -R, --exclude-root +When used together with the +.B \-a +option, all filesystems except for the root filesystem are checked for +quotas. + +.SH NOTE +.B quotacheck +should only be run by super-user. Non-privileged users are presumably +not allowed to read all the directories on the given filesystem. + +.SH "SEE ALSO" +.BR quota (1), +.BR quotactl (2), +.BR fstab (5), +.BR quotaon (8), +.BR repquota (8), +.BR convertquota (8), +.BR setquota (8), +.BR edquota (8), +.BR fsck (8), +.BR efsck (8), +.BR e2fsck (8), +.BR xfsck (8) + +.SH FILES +.PD 0 +.TP 15 +.B aquota.user or aquota.group +located at filesystem root with quotas (version 2 quota, non-XFS +filesystems) +.TP 15 +.B quota.user or quota.group +located at filesystem root with quotas (version 1 quota, non-XFS +filesystems) +.TP +.B /etc/mtab +names and locations of mounted filesystems +.SH AUTHOR +Jan Kara \ +.br +Based on old +.B quotacheck +by: +.br +Edvard Tuinder \ +.br +Marco van Wieringen \ -- cgit v1.2.3