Annotation of 43BSDReno/usr.sbin/edquota/edquota.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: .\"    @(#)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.

unix.superglobalmegacorp.com

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