bionic (8) quotacheck.8.gz

Provided by: quota_4.04-2ubuntu0.1_amd64 bug

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 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 happen after a system 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.  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=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)