Return to edquota.8 CVS log

Up to [cvs.NetBSD.org] / src / usr.sbin / edquota

Annotation of src/usr.sbin/edquota/edquota.8, Revision 1.5

1.4       mycroft     1: .\" Copyright (c) 1983, 1990, 1993
                      2: .\"    The Regents of the University of California.  All rights reserved.
1.1       cgd         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, with or without
                      8: .\" modification, are permitted provided that the following conditions
                      9: .\" are met:
                     10: .\" 1. Redistributions of source code must retain the above copyright
                     11: .\"    notice, this list of conditions and the following disclaimer.
                     12: .\" 2. Redistributions in binary form must reproduce the above copyright
                     13: .\"    notice, this list of conditions and the following disclaimer in the
                     14: .\"    documentation and/or other materials provided with the distribution.
                     15: .\" 3. All advertising materials mentioning features or use of this software
                     16: .\"    must display the following acknowledgement:
                     17: .\"    This product includes software developed by the University of
                     18: .\"    California, Berkeley and its contributors.
                     19: .\" 4. Neither the name of the University nor the names of its contributors
                     20: .\"    may be used to endorse or promote products derived from this software
                     21: .\"    without specific prior written permission.
                     22: .\"
                     23: .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
                     24: .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
                     25: .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
                     26: .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
                     27: .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
                     28: .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
                     29: .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
                     30: .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
                     31: .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
                     32: .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
                     33: .\" SUCH DAMAGE.
                     34: .\"
1.5     ! mikel      35: .\"    from: @(#)edquota.8     8.2 (Berkeley) 4/27/95
        !            36: .\"    $NetBSD$
1.1       cgd        37: .\"
1.5     ! mikel      38: .Dd "April 27, 1995"
1.3       jtc        39: .Dt EDQUOTA 8
                     40: .Os
                     41: .Sh NAME
                     42: .Nm edquota
                     43: .Nd edit user quotas
                     44: .Sh SYNOPSIS
                     45: .Nm edquota
                     46: .Op Fl u
                     47: .Op Fl p Ar proto-username
                     48: .Ar username ...
                     49: .Nm edquota
                     50: .Fl g
                     51: .Op Fl p Ar proto-groupname
                     52: .Ar groupname ...
                     53: .Nm edquota
                     54: .Fl t
                     55: .Op Fl u
                     56: .Nm edquota
                     57: .Fl t
                     58: .Fl g
                     59: .Sh DESCRIPTION
                     60: .Nm Edquota
                     61: is a quota editor.
                     62: By default, or if the
                     63: .Fl u
                     64: flag is specified,
1.1       cgd        65: one or more users may be specified on the command line.
                     66: For each user a temporary file is created
                     67: with an ASCII representation of the current
                     68: disk quotas for that user.
                     69: The list of filesystems with user quotas is determined from
1.3       jtc        70: .Pa /etc/fstab .
1.1       cgd        71: An editor is invoked on the ASCII file.
                     72: The editor invoked is
1.3       jtc        73: .Xr vi 1
                     74: unless the environment variable
                     75: .Ev EDITOR
                     76: specifies otherwise.
                     77: .Pp
1.1       cgd        78: The quotas may then be modified, new quotas added, etc.
                     79: Setting a quota to zero indicates that no quota should be imposed.
                     80: Setting a hard limit to one indicates that no allocations should
                     81: be permitted.
                     82: Setting a soft limit to one with a hard limit of zero
                     83: indicates that allocations should be permitted on
1.3       jtc        84: only a temporary basis (see
                     85: .Fl t
                     86: below).
1.1       cgd        87: The current usage information in the file is for informational purposes;
                     88: only the hard and soft limits can be changed.
1.3       jtc        89: .Pp
1.1       cgd        90: On leaving the editor,
1.5     ! mikel      91: .Nm
1.1       cgd        92: reads the temporary file and modifies the binary
                     93: quota files to reflect the changes made.
1.3       jtc        94: .Pp
1.1       cgd        95: If the
1.3       jtc        96: .Fl p
                     97: flag is specified,
1.5     ! mikel      98: .Nm
1.1       cgd        99: will duplicate the quotas of the prototypical user
                    100: specified for each user specified.
                    101: This is the normal mechanism used to
                    102: initialize quotas for groups of users.
1.3       jtc       103: .Pp
                    104: If the
                    105: .Fl g
                    106: flag is specified,
1.5     ! mikel     107: .Nm
1.1       cgd       108: is invoked to edit the quotas of
                    109: one or more groups specified on the command line.
1.3       jtc       110: The
                    111: .Fl p
                    112: flag can be specified in conjunction with
                    113: the
                    114: .Fl g
                    115: flag to specify a prototypical group
1.1       cgd       116: to be duplicated among the listed set of groups.
1.3       jtc       117: .Pp
1.1       cgd       118: Users are permitted to exceed their soft limits
                    119: for a grace period that may be specified per filesystem.
                    120: Once the grace period has expired,
                    121: the soft limit is enforced as a hard limit.
                    122: The default grace period for a filesystem is specified in
1.4       mycroft   123: .Pa /usr/include/ufs/ufs/quota.h .
1.3       jtc       124: The
                    125: .Fl t
                    126: flag can be used to change the grace period.
                    127: By default, or when invoked with the
                    128: .Fl u
                    129: flag, the grace period is set for all the filesystems with user
1.1       cgd       130: quotas specified in
1.3       jtc       131: .Pa /etc/fstab .
                    132: When invoked with the
                    133: .Fl g
                    134: flag the grace period is
1.1       cgd       135: set for all the filesystems with group quotas specified in
1.3       jtc       136: .Pa /etc/fstab .
1.1       cgd       137: The grace period may be specified in days, hours, minutes, or seconds.
                    138: Setting a grace period to zero indicates that the default
                    139: grace period should be imposed.
                    140: Setting a grace period to one second indicates that no
                    141: grace period should be granted.
1.3       jtc       142: .Pp
1.1       cgd       143: Only the super-user may edit quotas.
1.3       jtc       144: .Sh FILES
                    145: .Bl -tag -width 24n -compact
                    146: .It Pa quota.user
                    147: at the filesystem root with user quotas
                    148: .It Pa quota.group
                    149: at the filesystem root with group quotas
                    150: .It Pa /etc/fstab
                    151: to find filesystem names and locations
                    152: .El
                    153: .Sh SEE ALSO
                    154: .Xr quota 1 ,
                    155: .Xr quotactl 2 ,
                    156: .Xr fstab 5 ,
                    157: .Xr quotacheck 8 ,
                    158: .Xr quotaon 8 ,
                    159: .Xr repquota 8
                    160: .Sh DIAGNOSTICS
1.1       cgd       161: Various messages about inaccessible files; self-explanatory.