format changes and other fixes
[unix-history] / usr / src / sbin / quotacheck / quotacheck.8
CommitLineData
22a407fe
KM
1.\" Copyright (c) 1983 Regents of the University of California.
2.\" All rights reserved. The Berkeley software License Agreement
3.\" specifies the terms and conditions for redistribution.
4.\"
15a0b930 5.\" @(#)quotacheck.8 6.2 (Berkeley) %G%
22a407fe 6.\"
9d270264 7.TH QUOTACHECK 8 ""
22a407fe
KM
8.UC 5
9.SH NAME
10quotacheck \- file system quota consistency checker
11.SH SYNOPSIS
12.B /etc/quotacheck
13[
14.B \-v
15a0b930
S
15] [
16.B \-p
22a407fe
KM
17]
18filesystem...
19.br
20.B /etc/quotacheck
21[
22.B \-v
15a0b930
S
23] [
24.B \-p
22a407fe
KM
25]
26.B \-a
27.SH DESCRIPTION
28.I Quotacheck
29examines each file system,
30builds a table of current disc usage,
31and compares this table against that stored
32in the disc quota file for the file system.
33If any inconsistencies are detected, both the
34quota file and the current system copy of the
35incorrect quotas are updated (the latter only
36occurs if an active file system is checked).
37.PP
38If the
39.B \-a
40flag is supplied in place of any file system
41names,
42.I quotacheck
43will check all the file systems indicated in
44.I /etc/fstab
45to be read-write with disc quotas.
46.PP
47Normally
48.I quotacheck
49reports only those quotas modified. If the
50.B \-v
51option is supplied,
52.I quotacheck
53will indicate the calculated disc quotas for each
54user on a particular file system.
55.PP
15a0b930
S
56If the
57.B \-p
58flag is supplied then parallel passes will be run on
59the filesystems required, using the pass numbers in
60/etc/fstab in an identical fashion to
61.IR fsck (8).
62.PP
22a407fe
KM
63.I Quotacheck
64expects each file system to be checked to have a
65quota file named
66.I quotas
67in the root directory. If none is present,
68.I quotacheck
69will ignore the file system.
70.PP
71.I Quotacheck
72is normally run at boot time from the
73.I /etc/rc.local
74file, see
75.IR rc (8),
76before enabling disc quotas with
77.IR quotaon (8).
78.PP
79.I Quotacheck
80accesses the raw device in calculating the actual
81disc usage for each user. Thus, the file systems
82checked should be quiescent while
83.I quotacheck
84is running.
85.SH FILES
86.DT
87/etc/fstab default file systems
88.SH "SEE ALSO"
15a0b930 89quota(2), setquota(2), quotaon(8), fsck(8)