teach manpages about largefile's demise
[unleashed.git] / share / man / man8 / quotacheck.8
blob7e3fa35000efbdcdc11f337e0309888831f59c0f
1 '\" te
2 .\"  Copyright 1989 AT&T  Copyright (c) 1996, Sun Microsystems, Inc.  All Rights Reserved
3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
6 .TH QUOTACHECK 8 "Jul 31, 1998"
7 .SH NAME
8 quotacheck \- ufs file system quota consistency checker
9 .SH SYNOPSIS
10 .LP
11 .nf
12 \fBquotacheck\fR [\fB-fp\fR] [\fB-v\fR] \fIfilesystem\fR...
13 .fi
15 .LP
16 .nf
17 \fBquotacheck\fR \fB-a\fR [\fB-fpv\fR]
18 .fi
20 .SH DESCRIPTION
21 .sp
22 .LP
23 \fBquotacheck\fR examines each mounted ufs file system, builds a table of
24 current disk usage, and compares this table against the information stored in
25 the file system's disk quota file. If any inconsistencies are detected, both
26 the quota file and the current system copy of the incorrect quotas are updated.
27 .sp
28 .LP
29 \fIfilesystem\fR is either a file system mount point or the block device  on
30 which the file system resides.
31 .sp
32 .LP
33 \fBquotacheck\fR expects each file system to be checked to have a quota file
34 named \fBquotas\fR in the root directory. If none is present, \fBquotacheck\fR
35 will not check the file system.
36 .sp
37 .LP
38 \fBquotacheck\fR accesses the character special device in calculating the
39 actual disk usage for each user. Thus, the file systems that are checked should
40 be quiescent while \fBquotacheck\fR is running.
41 .SH OPTIONS
42 .sp
43 .LP
44 The following options are supported:
45 .sp
46 .ne 2
47 .na
48 \fB\fB-a\fR\fR
49 .ad
50 .RS 6n
51 Check the file systems which \fB/etc/mnttab\fR indicates are ufs file systems.
52 These file systems must be read-write mounted  with disk quotas enabled, and
53 have an \fBrq\fR entry in the \fBmntopts\fR field in \fB/etc/vfstab\fR.
54 .RE
56 .sp
57 .ne 2
58 .na
59 \fB\fB-f\fR\fR
60 .ad
61 .RS 6n
62 Force check on file systems with logging enabled. Use in combination with the
63 \fB-p\fR option.
64 .RE
66 .sp
67 .ne 2
68 .na
69 \fB\fB-p\fR\fR
70 .ad
71 .RS 6n
72 Check quotas of file systems in parallel. For file systems with logging
73 enabled, no check is performed unless the \fB-f\fR option is also specified.
74 .RE
76 .sp
77 .ne 2
78 .na
79 \fB\fB-v\fR\fR
80 .ad
81 .RS 6n
82 Indicate the calculated disk quotas for each user on a particular file system.
83 \fBquotacheck\fR normally reports only those quotas modified.
84 .RE
86 .SH FILES
87 .sp
88 .ne 2
89 .na
90 \fB\fB/etc/mnttab\fR\fR
91 .ad
92 .RS 15n
93 Mounted file systems
94 .RE
96 .sp
97 .ne 2
98 .na
99 \fB\fB/etc/vfstab\fR\fR
101 .RS 15n
102 List of default parameters for each file system
105 .SH SEE ALSO
108 \fBedquota\fR(8), \fBquota\fR(8), \fBquotaon\fR(8), \fBrepquota\fR(8),
109 \fBattributes\fR(5), \fBquotactl\fR(7I),
110 \fBmount_ufs\fR(8)