Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
QUOTACHECK(8)		     System Manager's Manual		   QUOTACHECK(8)

NAME
     quotacheck -- file system quota consistency checker

SYNOPSIS
     quotacheck [-guv] [-c 32 | 64] [-l maxrun] -a
     quotacheck [-guv] [-c 32 | 64] filesystem ...

DESCRIPTION
     The quotacheck utility examines each file system, builds a table of current
     disk usage, and compares this table against that recorded in the disk quota
     file  for	the  file system.  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 file system is checked).  By default
     both user and group quotas are checked.

     The following options are available:

     -a      If supplied in place of any  file	system	names,	quotacheck  will
	     check all the file systems indicated in /etc/fstab to be read-write
	     with  disk  quotas.   By default only the types of quotas listed in
	     /etc/fstab are checked.

     -c 32 | 64
	     Before performing its checks, quotacheck  will  convert  the  quota
	     file  to the specified word size.	A conversion size of 64 is given
	     to request conversion to the new 64-bit quota file format.  A  con-
	     version  size  of 32 is given to request conversion back to the old
	     32-bit quota file format.	The original  quota  file  is  left  un-
	     changed and moved aside with an underscore and its format size plus
	     a	.orig  extension  added  to its name.  Thus, the original 32-bit
	     quota.user quota file converted to the  64-bit  format  quota  file
	     will be renamed to quota.user_32.orig.

     -g      Only group quotas listed in /etc/fstab are to be checked.

     -l maxrun
	     Specifies the maximum number of concurrent file systems to check in
	     parallel.	 If this option is omitted, or if maxrun is zero, paral-
	     lel passes are run as per fsck(8).  This option is  deprecated  and
	     parallel passes are always run as per fsck(8).

     -u      Only user quotas listed in /etc/fstab are to be checked.

     -v      Report  discrepancies between the calculated and recorded disk quo-
	     tas and other additional diagnostic messages.

     Specifying both -g and -u is equivalent to the  default.	Parallel  passes
     are  run on the file systems required, using the pass numbers in /etc/fstab
     in an identical fashion to fsck(8).

     Normally, quotacheck operates silently.

     The quotacheck utility expects each file system to be  checked  to  have  a
     quota  files named quota.user and quota.group which are located at the root
     of the associated	file  system.	These  defaults  may  be  overridden  in
     /etc/fstab.   If  a  file is not present, quotacheck will create it.  These
     files should be edited with the edquota(8) utility.

     The quotacheck utility is normally run at boot time from the /etc/rc  file.
     The  rc  startup  procedure  is  controlled  by  the  /etc/rc.conf variable
     check_quotas.  Note that to enable this functionality in /etc/rc  you  also
     need  to enable startup quota procedures with the variable enable_quotas in
     /etc/rc.conf.  The kernel must also be built with options QUOTA.

     The quotacheck utility accesses the raw device in	calculating  the  actual
     disk  usage for each user.  Thus, the file systems checked should be quies-
     cent while quotacheck is running.

FILES
     quota.user   at the file system root with user quotas
     quota.group  at the file system root with group quotas
     /etc/fstab   default file systems

SEE ALSO
     quota(1), quotactl(2),  fstab(5),	rc.conf(5),  edquota(8),  fsck(8),  quo-
     taon(8), repquota(8)

HISTORY
     The quotacheck utility appeared in 4.2BSD.

BUGS
     The quota system will ignore UIDs or GIDs that would be negative when eval-
     uated  as	a  signed value.  Typically those types of ids can appear in the
     file system from NFS mounts or archive files from other operating	systems.
     Extremely	large UIDs or GIDs will cause quotacheck to run for an unreason-
     able amount of time and also produce extremely large quota data files.

FreeBSD ports 15.quarterly	January 25, 2007		   QUOTACHECK(8)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=quotacheck&sektion=8&manpath=FreeBSD+15.1-RELEASE+and+Ports.quarterly>

home | help