Annotation of 43BSDTahoe/man/man2/setquota.2, revision 1.1

1.1     ! root        1: .\" Copyright (c) 1983 Regents of the University of California.
        !             2: .\" All rights reserved.
        !             3: .\"
        !             4: .\" Redistribution and use in source and binary forms are permitted
        !             5: .\" provided that the above copyright notice and this paragraph are
        !             6: .\" duplicated in all such forms and that any documentation,
        !             7: .\" advertising materials, and other materials related to such
        !             8: .\" distribution and use acknowledge that the software was developed
        !             9: .\" by the University of California, Berkeley.  The name of the
        !            10: .\" University may not be used to endorse or promote products derived
        !            11: .\" from this software without specific prior written permission.
        !            12: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
        !            13: .\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
        !            14: .\" WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
        !            15: .\"
        !            16: .\"    @(#)setquota.2  6.6 (Berkeley) 7/9/88
        !            17: .\"
        !            18: .TH SETQUOTA 2 "July 9, 1988"
        !            19: .UC 5
        !            20: .SH NAME
        !            21: setquota \- enable/disable quotas on a file system
        !            22: .SH SYNOPSIS
        !            23: .nf
        !            24: .B setquota(special, file)
        !            25: .B char *special, *file;
        !            26: .fi
        !            27: .SH DESCRIPTION
        !            28: Disc quotas are enabled or disabled with the
        !            29: .I setquota
        !            30: call.
        !            31: .I Special
        !            32: indicates a block special device on which a
        !            33: mounted file system exists.
        !            34: If
        !            35: .I file
        !            36: is nonzero, it specifies a file in that
        !            37: file system from which to take the quotas.  If
        !            38: .I file
        !            39: is 0, then quotas are disabled on the file system.
        !            40: The quota file must exist; it is normally created
        !            41: with the 
        !            42: .IR quotacheck (8)
        !            43: program.
        !            44: .PP
        !            45: Only the super-user may turn quotas on or off.
        !            46: .SH "SEE ALSO"
        !            47: quota(2), quotacheck(8), quotaon(8)
        !            48: .SH "RETURN VALUE"
        !            49: A 0 return value indicates a successful call.  A value
        !            50: of \-1 is returned when an error occurs and 
        !            51: .I errno
        !            52: is set to indicate the reason for failure.
        !            53: .SH ERRORS
        !            54: .I Setquota
        !            55: will fail when one of the following occurs:
        !            56: .TP 15
        !            57: [ENOTDIR]
        !            58: A component of either path prefix is not a directory.
        !            59: .TP 15
        !            60: [EINVAL]
        !            61: Either pathname contains a character with the high-order bit set.
        !            62: .TP 15
        !            63: [EINVAL]
        !            64: The kernel has not been compiled with the QUOTA option.
        !            65: .TP 15
        !            66: [ENAMETOOLONG]
        !            67: A component of either pathname exceeded 255 characters,
        !            68: or the entire length of either path name exceeded 1023 characters.
        !            69: .TP 15
        !            70: [ENODEV]
        !            71: .I Special
        !            72: does not exist.
        !            73: .TP 15
        !            74: [ENOENT]
        !            75: .I File
        !            76: does not exist.
        !            77: .TP 15
        !            78: [ELOOP]
        !            79: Too many symbolic links were encountered in translating either pathname.
        !            80: .TP 15
        !            81: [EPERM]
        !            82: The caller is not the super-user.
        !            83: .TP 15
        !            84: [ENOTBLK]
        !            85: .I Special
        !            86: is not a block device.
        !            87: .TP 15
        !            88: [ENXIO]
        !            89: The major device number of 
        !            90: .I special
        !            91: is out of range (this indicates no device driver exists
        !            92: for the associated hardware).
        !            93: .TP 15
        !            94: [EROFS]
        !            95: .I File
        !            96: resides on a read-only file system.
        !            97: .TP 15
        !            98: [EACCES]
        !            99: Search permission is denied for a component of either path prefix.
        !           100: .TP 15
        !           101: [EACCES]
        !           102: .I File
        !           103: resides on a file system different from
        !           104: .IR special .
        !           105: .TP 15
        !           106: [EACCES]
        !           107: .I File
        !           108: is not a plain file.
        !           109: .TP 15
        !           110: [EIO]
        !           111: An I/O error occurred while reading from or writing to the file containing
        !           112: the quotas.
        !           113: .TP 15
        !           114: [EFAULT]
        !           115: .I Special
        !           116: or \fIpath\fP points outside the process's allocated address space.
        !           117: .SH BUGS
        !           118: The error codes are in a state of disarray; too many errors
        !           119: appear to the caller as one value.

unix.superglobalmegacorp.com

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