quotacheck(8)                                            System Manager's Manual                                           quotacheck(8)

NAME
       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 omitted 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 which is not advised).  By default, only user quotas are checked.  quotacheck 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 automat‐
       ically (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 happen after a sys‐
       tem crash.

       It is strongly recommended to run 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 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, --backup
              Forces quotacheck to make backups of the quota file before writing the new data.

       -v, --verbose
              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).

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

       -u, --user
              Only user quotas listed in /etc/mtab or on the filesystems specified are to be checked.  This is the default action.

       -g, --group
              Only group quotas listed in /etc/mtab or on the filesystems specified are to be checked.

       -c, --create-files
              Don't read existing quota files. Just perform a new scan and save it to disk.  quotacheck also skips scanning of old quota
              files when they are not found.

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

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

       -m, --no-remount
              Don't try to remount filesystem read-only. See comment with option -M.

       -i, --interactive
              Interactive mode. By default quotacheck exits when it finds an error. In interactive mode user is asked for input instead.
              See option -n.

       -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.   Nor‐
              mally 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=format-name
              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: vfsold Original quota format with 16-bit UIDs /
              GIDs, vfsv0 Quota format with 32-bit UIDs / GIDs, 64-bit space usage, 32-bit inode usage and limits,  vfsv1  Quota  format
              with 64-bit quota limits and usage, rpc (quota over NFS), xfs (quota on XFS filesystem)

       -a, --all
              Check all mounted non-NFS filesystems in /etc/mtab

       -R, --exclude-root
              When used together with the -a option, all filesystems except for the root filesystem are checked for quotas.

NOTE
       quotacheck  should  only be run by super-user. Non-privileged 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>

                                                             Fri Jul 20 2001                                               quotacheck(8)

Utility for checking and repairing quota files.
quotacheck [-gucbfinvdmMR] [-F <quota-format>] filesystem|-a

-u, --user                check user files
-g, --group               check group files
-c, --create-files        create new quota files
-b, --backup              create backups of old quota files
-f, --force               force check even if quotas are enabled
-i, --interactive         interactive mode
-n, --use-first-dquot     use the first copy of duplicated structure
-v, --verbose             print more information
-d, --debug               print even more messages
-m, --no-remount          do not remount filesystem read-only
-M, --try-remount         try remounting filesystem read-only,
                          continue even if it fails
-R, --exclude-root        exclude root when checking all filesystems
-F, --format=formatname   check quota files of specific format
-a, --all                 check all filesystems
-h, --help                display this message and exit
-V, --version             display version information and exit

Bugs to jack@suse.cz