Return to edquota.8 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / usr.sbin / edquota

Annotation of 43BSDReno/usr.sbin/edquota/edquota.8, revision 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: .\"    @(#)edquota.8   6.6 (Berkeley) 6/24/90
        !            22: .\"
        !            23: .TH EDQUOTA 8 "June 24, 1990"
        !            24: .UC 5
        !            25: .SH NAME
        !            26: edquota \- edit user quotas
        !            27: .SH SYNOPSIS
        !            28: .B edquota
        !            29: [
        !            30: .I \-u
        !            31: ] [
        !            32: .I \-p
        !            33: proto-username
        !            34: ]
        !            35: username ...
        !            36: .br
        !            37: .B edquota
        !            38: .I \-g
        !            39: [
        !            40: .I \-p
        !            41: proto-groupname
        !            42: ]
        !            43: groupname ...
        !            44: .br
        !            45: .B edquota
        !            46: .I -t
        !            47: [
        !            48: .I -u
        !            49: ]
        !            50: .br
        !            51: .B edquota
        !            52: .I -t
        !            53: .I -g
        !            54: .br
        !            55: .SH DESCRIPTION
        !            56: .I Edquota
        !            57: is a quota editor.
        !            58: By default, or if the \fI-u\fP flag is specified,
        !            59: one or more users may be specified on the command line.
        !            60: For each user a temporary file is created
        !            61: with an ASCII representation of the current
        !            62: disk quotas for that user.
        !            63: The list of filesystems with user quotas is determined from
        !            64: .IR /etc/fstab .
        !            65: An editor is invoked on the ASCII file.
        !            66: The editor invoked is 
        !            67: .IR vi (1)
        !            68: unless the environment variable EDITOR specifies otherwise.
        !            69: .PP
        !            70: The quotas may then be modified, new quotas added, etc.
        !            71: Setting a quota to zero indicates that no quota should be imposed.
        !            72: Setting a hard limit to one indicates that no allocations should
        !            73: be permitted.
        !            74: Setting a soft limit to one with a hard limit of zero
        !            75: indicates that allocations should be permitted on
        !            76: only a temporary basis (see \fI-t\fP below).
        !            77: The current usage information in the file is for informational purposes;
        !            78: only the hard and soft limits can be changed.
        !            79: .PP
        !            80: On leaving the editor,
        !            81: .I edquota
        !            82: reads the temporary file and modifies the binary
        !            83: quota files to reflect the changes made.
        !            84: .PP
        !            85: If the 
        !            86: .B \-p
        !            87: option is specified,
        !            88: .I edquota
        !            89: will duplicate the quotas of the prototypical user
        !            90: specified for each user specified.
        !            91: This is the normal mechanism used to
        !            92: initialize quotas for groups of users.
        !            93: .PP
        !            94: If the \fI-g\fP flag is specified,
        !            95: .I edquota
        !            96: is invoked to edit the quotas of
        !            97: one or more groups specified on the command line.
        !            98: The \fI-p\fP flag can be specified in conjunction with
        !            99: the \fI-g\fP flag to specify a prototypical group
        !           100: to be duplicated among the listed set of groups.
        !           101: .PP
        !           102: Users are permitted to exceed their soft limits
        !           103: for a grace period that may be specified per filesystem.
        !           104: Once the grace period has expired,
        !           105: the soft limit is enforced as a hard limit.
        !           106: The default grace period for a filesystem is specified in
        !           107: .IR /usr/include/ufs/quota.h .
        !           108: The \fi-t\fP flag can be used to change the grace period.
        !           109: By default, or when invoked with the \fI-u\fP flag,
        !           110: the grace period is set for all the filesystems with user
        !           111: quotas specified in
        !           112: .IR /etc/fstab .
        !           113: When invoked with the \fI-g\fP flag the grace period is
        !           114: set for all the filesystems with group quotas specified in
        !           115: .IR /etc/fstab .
        !           116: The grace period may be specified in days, hours, minutes, or seconds.
        !           117: Setting a grace period to zero indicates that the default
        !           118: grace period should be imposed.
        !           119: Setting a grace period to one second indicates that no
        !           120: grace period should be granted.
        !           121: .PP
        !           122: Only the super-user may edit quotas.
        !           123: .SH FILES
        !           124: .DT
        !           125: \fIquota.user\fP       at the filesystem root with user quotas
        !           126: .br
        !           127: \fIquota.group\fP      at the filesystem root with group quotas
        !           128: .br
        !           129: /etc/fstab     to find filesystem names and locations
        !           130: .SH SEE ALSO
        !           131: quota(1),
        !           132: quotactl(2),
        !           133: fstab(5),
        !           134: quotacheck(8), quotaon(8), repquota(8)
        !           135: .SH DIAGNOSTICS
        !           136: Various messages about inaccessible files; self-explanatory.

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