Annotation of 43BSDReno/sbin/quotacheck/quotacheck.8, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1983, 1990 Regents of the University of California.
                      2: .\" All rights reserved.
                      3: .\"
                      4: .\" This code is derived from software contributed to Berkeley by
                      5: .\" Robert Elz at The University of Melbourne.
                      6: .\"
                      7: .\" Redistribution and use in source and binary forms are permitted provided
                      8: .\" that: (1) source distributions retain this entire copyright notice and
                      9: .\" comment, and (2) distributions including binaries display the following
                     10: .\" acknowledgement:  ``This product includes software developed by the
                     11: .\" University of California, Berkeley and its contributors'' in the
                     12: .\" documentation or other materials provided with the distribution and in
                     13: .\" all advertising materials mentioning features or use of this software.
                     14: .\" Neither the name of the University nor the names of its contributors may
                     15: .\" be used to endorse or promote products derived from this software without
                     16: .\" specific prior written permission.
                     17: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
                     18: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
                     19: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
                     20: .\"
                     21: .\"    @(#)quotacheck.8        6.6 (Berkeley) 6/24/90
                     22: .\"
                     23: .TH QUOTACHECK 8 "June 24, 1990"
                     24: .UC 5
                     25: .SH NAME
                     26: quotacheck \- filesystem quota consistency checker
                     27: .SH SYNOPSIS
                     28: .B quotacheck
                     29: [
                     30: .B \-g
                     31: ] [
                     32: .B \-u
                     33: ] [
                     34: .B \-v
                     35: ]
                     36: filesystem ...
                     37: .br
                     38: .B quotacheck
                     39: [
                     40: .B \-g
                     41: ] [
                     42: .B \-u
                     43: ] [
                     44: .B \-v
                     45: ]
                     46: .B \-a
                     47: .br
                     48: .SH DESCRIPTION
                     49: .I Quotacheck
                     50: examines each filesystem,
                     51: builds a table of current disk usage,
                     52: and compares this table against that recorded
                     53: in the disk quota file for the filesystem.
                     54: If any inconsistencies are detected, both the
                     55: quota file and the current system copy of the
                     56: incorrect quotas are updated (the latter only
                     57: occurs if an active filesystem is checked).
                     58: By default both user and group quotas are checked.
                     59: The optional \fI-g\fP flag specifies that only group quotas should be checked.
                     60: The optional \fI-u\fP flag specifies that only user quotas should be checked.
                     61: Specifying both \fI-g\fP and \fI-u\fP is equivalent to the default.
                     62: .PP
                     63: If the
                     64: .B \-a
                     65: flag is supplied in place of any filesystem names,
                     66: .I quotacheck
                     67: will check all the filesystems indicated in
                     68: .I /etc/fstab
                     69: to be read-write with disk quotas.
                     70: By default only the types of quotas listed in
                     71: .I /etc/fstab
                     72: are checked.
                     73: The optional \fI-g\fP flag specifies that only group quotas listed in
                     74: .I /etc/fstab
                     75: should be checked.
                     76: The optional \fI-u\fP flag specifies that only user quotas listed in
                     77: .I /etc/fstab
                     78: should be checked.
                     79: Specifying both \fI-g\fP and \fI-u\fP is equivalent to the default.
                     80: Parallel passes are run on the filesystems required,
                     81: using the pass numbers in
                     82: .I /etc/fstab
                     83: in an identical fashion to
                     84: .IR fsck (8).
                     85: .PP
                     86: Normally
                     87: .I quotacheck
                     88: operates silently.
                     89: If the
                     90: .B \-v
                     91: option is supplied,
                     92: .I quotacheck
                     93: will report discrepancies between the
                     94: calculated and recorded disk quotas.
                     95: .PP
                     96: .I Quotacheck
                     97: expects each filesystem to be checked to have a
                     98: quota files named
                     99: .I quota.user
                    100: and
                    101: .I quota.group
                    102: which are located at the root of the associated file system.
                    103: These defaults may be overridden in
                    104: .I /etc/fstab .
                    105: If a file is not present, 
                    106: .I quotacheck
                    107: will create it.
                    108: .PP
                    109: .I Quotacheck 
                    110: is normally run at boot time from the
                    111: .I /etc/rc.local
                    112: file, see
                    113: .IR rc (8),
                    114: before enabling disk quotas with
                    115: .IR quotaon (8).
                    116: .PP
                    117: .I Quotacheck
                    118: accesses the raw device in calculating the actual
                    119: disk usage for each user.
                    120: Thus, the filesystems
                    121: checked should be quiescent while
                    122: .I quotacheck
                    123: is running.
                    124: .SH FILES
                    125: .DT
                    126: \fIquota.user\fP       at the filesystem root with user quotas
                    127: .br
                    128: \fIquota.group\fP      at the filesystem root with group quotas
                    129: .br
                    130: /etc/fstab     default filesystems
                    131: .SH "SEE ALSO"
                    132: quota(1),
                    133: quotactl(2),
                    134: fstab(5),
                    135: edquota(8), fsck(8), quotaon(8), repquota(8)

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.