BSD 4_3_Reno release

[unix-history] / usr / src / sbin / quotacheck / quotacheck.8

diff --git a/usr/src/sbin/quotacheck/quotacheck.8 b/usr/src/sbin/quotacheck/quotacheck.8
index db9991e..1767171 100644 (file)
--- a/usr/src/sbin/quotacheck/quotacheck.8
+++ b/usr/src/sbin/quotacheck/quotacheck.8
@@ -1,95 +1,135 @@
-.\" Copyright (c) 1983 Regents of the University of California.
+.\" Copyright (c) 1983, 1990 Regents of the University of California.

 .\" All rights reserved.
 .\"
 .\" All rights reserved.
 .\"

-.\" Redistribution and use in source and binary forms are permitted
-.\" provided that this notice is preserved and that due credit is given
-.\" to the University of California at Berkeley. The name of the University
-.\" may not be used to endorse or promote products derived from this
-.\" software without specific prior written permission. This software
-.\" is provided ``as is'' without express or implied warranty.
+.\" This code is derived from software contributed to Berkeley by
+.\" Robert Elz at The University of Melbourne.

 .\"
 .\"

-.\"    @(#)quotacheck.8        6.3 (Berkeley) %G%
+.\" Redistribution and use in source and binary forms are permitted provided
+.\" that: (1) source distributions retain this entire copyright notice and
+.\" comment, and (2) distributions including binaries display the following
+.\" acknowledgement:  ``This product includes software developed by the
+.\" University of California, Berkeley and its contributors'' in the
+.\" documentation or other materials provided with the distribution and in
+.\" all advertising materials mentioning features or use of this software.
+.\" Neither the name of the University nor the names of its contributors may
+.\" be used to endorse or promote products derived from this software without
+.\" specific prior written permission.
+.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
+.\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
+.\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.

 .\"
 .\"

-.TH QUOTACHECK 8 ""
+.\"    @(#)quotacheck.8        6.6 (Berkeley) 6/24/90
+.\"
+.TH QUOTACHECK 8 "June 24, 1990"

 .UC 5
 .SH NAME
 .UC 5
 .SH NAME

-quotacheck \- file system quota consistency checker
+quotacheck \- filesystem quota consistency checker

 .SH SYNOPSIS
 .SH SYNOPSIS

-.B /etc/quotacheck
+.B quotacheck

 [
 [

-.B \-v
+.B \-g
+] [
+.B \-u

 ] [
 ] [

-.B \-p
+.B \-v

 ]
 ]

-filesystem...
+filesystem ...

 .br
 .br

-.B /etc/quotacheck
+.B quotacheck

 [
 [

-.B \-v
+.B \-g

 ] [
 ] [

-.B \-p
+.B \-u
+] [
+.B \-v

 ]
 .B \-a
 ]
 .B \-a

+.br

 .SH DESCRIPTION
 .I Quotacheck
 .SH DESCRIPTION
 .I Quotacheck

-examines each file system,
-builds a table of current disc usage,
-and compares this table against that stored
-in the disc quota file for the file system.
+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.

 If any inconsistencies are detected, both the
 quota file and the current system copy of the
 incorrect quotas are updated (the latter only
 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).
+occurs if an active filesystem is checked).
+By default both user and group quotas are checked.
+The optional \fI-g\fP flag specifies that only group quotas should be checked.
+The optional \fI-u\fP flag specifies that only user quotas should be checked.
+Specifying both \fI-g\fP and \fI-u\fP is equivalent to the default.

 .PP
 If the
 .B \-a
 .PP
 If the
 .B \-a

-flag is supplied in place of any file system
-names,
+flag is supplied in place of any filesystem names,

 .I quotacheck
 .I quotacheck

-will check all the file systems indicated in
+will check all the filesystems indicated in
+.I /etc/fstab
+to be read-write with disk quotas.
+By default only the types of quotas listed in
+.I /etc/fstab
+are checked.
+The optional \fI-g\fP flag specifies that only group quotas listed in

 .I /etc/fstab
 .I /etc/fstab

-to be read-write with disc quotas.
+should be checked.
+The optional \fI-u\fP flag specifies that only user quotas listed in
+.I /etc/fstab
+should be checked.
+Specifying both \fI-g\fP and \fI-u\fP is equivalent to the default.
+Parallel passes are run on the filesystems required,
+using the pass numbers in
+.I /etc/fstab
+in an identical fashion to
+.IR fsck (8).

 .PP
 Normally
 .I quotacheck
 .PP
 Normally
 .I quotacheck

-reports only those quotas modified.  If the
+operates silently.
+If the

 .B \-v
 option is supplied,
 .I quotacheck
 .B \-v
 option is supplied,
 .I quotacheck

-will indicate the calculated disc quotas for each
-user on a particular file system.
-.PP
-If the
-.B \-p
-flag is supplied then parallel passes will be run on
-the filesystems required, using the pass numbers in
-/etc/fstab in an identical fashion to
-.IR fsck (8).
+will report discrepancies between the
+calculated and recorded disk quotas.

 .PP
 .I Quotacheck
 .PP
 .I Quotacheck

-expects each file system to be checked to have a
-quota file named
-.I quotas
-in the root directory.  If none is present, 
+expects each filesystem to be checked to have a
+quota files named
+.I quota.user
+and
+.I quota.group
+which are located at the root of the associated file system.
+These defaults may be overridden in
+.I /etc/fstab .
+If a file is not present, 

 .I quotacheck
 .I quotacheck

-will ignore the file system.
+will create it.

 .PP
 .I Quotacheck 
 is normally run at boot time from the
 .I /etc/rc.local
 file, see
 .IR rc (8),
 .PP
 .I Quotacheck 
 is normally run at boot time from the
 .I /etc/rc.local
 file, see
 .IR rc (8),

-before enabling disc quotas with
+before enabling disk quotas with

 .IR quotaon (8).
 .PP
 .I Quotacheck
 accesses the raw device in calculating the actual
 .IR quotaon (8).
 .PP
 .I Quotacheck
 accesses the raw device in calculating the actual

-disc usage for each user.  Thus, the file systems
+disk usage for each user.
+Thus, the filesystems

 checked should be quiescent while
 .I quotacheck
 is running.
 .SH FILES
 .DT
 checked should be quiescent while
 .I quotacheck
 is running.
 .SH FILES
 .DT

-/etc/fstab     default file systems
+\fIquota.user\fP       at the filesystem root with user quotas
+.br
+\fIquota.group\fP      at the filesystem root with group quotas
+.br
+/etc/fstab     default filesystems

 .SH "SEE ALSO"
 .SH "SEE ALSO"

-quota(2), setquota(2), quotaon(8), fsck(8)
+quota(1),
+quotactl(2),
+fstab(5),
+edquota(8), fsck(8), quotaon(8), repquota(8)