![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to quota.2 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSDTahoe / man / man2|
Return to quota.2 CVS log | Up to [CSRG BSD Unix] / 43BSDTahoe / man / man2 |
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: .\" @(#)quota.2 6.9 (Berkeley) 7/9/88 ! 17: .\" ! 18: .TH QUOTA 2 "July 9, 1988" ! 19: .UC 5 ! 20: .SH NAME ! 21: quota \- manipulate disk quotas ! 22: .SH SYNOPSIS ! 23: .nf ! 24: .B #include <sys/quota.h> ! 25: .PP ! 26: .B quota(cmd, uid, arg, addr) ! 27: .B int cmd, uid, arg; ! 28: .B char *addr; ! 29: .fi ! 30: .SH DESCRIPTION ! 31: The ! 32: .I quota ! 33: call manipulates disk quotas for file systems ! 34: that have had quotas enabled with ! 35: .IR setquota (2). ! 36: The ! 37: .I cmd ! 38: parameter indicates a command to be applied to ! 39: the user ID ! 40: .IR uid . ! 41: .I Arg ! 42: is a command specific argument and ! 43: .I addr ! 44: is the address of an optional, command specific, data structure ! 45: that is copied in or out of the system. The interpretation of ! 46: .I arg ! 47: and ! 48: .I addr ! 49: is given with each command below. ! 50: .TP ! 51: Q_SETDLIM ! 52: Set disc quota limits and current usage for the user with ID ! 53: .IR uid . ! 54: .I Arg ! 55: is a major-minor device indicating a particular file system. ! 56: .I Addr ! 57: is a pointer to a struct dqblk structure (defined in ! 58: .RI < sys/quota.h >). ! 59: This call is restricted to the super-user. ! 60: .TP ! 61: Q_GETDLIM ! 62: Get disc quota limits and current usage for the user with ID ! 63: .IR uid . ! 64: The remaining parameters are as for Q_SETDLIM. ! 65: .TP ! 66: Q_SETDUSE ! 67: Set disc usage limits for the user with ID ! 68: .IR uid . ! 69: .I Arg ! 70: is a major-minor device indicating a particular file system. ! 71: .I Addr ! 72: is a pointer to a struct dqusage structure (defined in ! 73: .RI < sys/quota.h >). ! 74: This call is restricted to the super-user. ! 75: .TP ! 76: Q_SYNC ! 77: Update the on-disc copy of quota usages. ! 78: .I Arg ! 79: is a major-minor device indicating the file system to be sync'ed. ! 80: If the ! 81: .I arg ! 82: parameter is specified as NODEV, all file systems that have ! 83: disc quotas will be sync'ed. ! 84: The \fIuid\fP and \fIaddr\fP parameters are ignored. ! 85: .TP ! 86: Q_SETUID ! 87: Change the calling process's quota limits to those of the ! 88: user with ID ! 89: .IR uid . ! 90: The ! 91: .I arg ! 92: and ! 93: .I addr ! 94: parameters are ignored. This call is restricted to the super-user. ! 95: .TP ! 96: Q_SETWARN ! 97: Alter the disc usage warning limits for the user with ID ! 98: .IR uid . ! 99: .I Arg ! 100: is a major-minor device indicating a particular file system. ! 101: .I Addr ! 102: is a pointer to a struct dqwarn structure (defined in ! 103: .RI < sys/quota.h >). ! 104: This call is restricted to the super-user. ! 105: .TP ! 106: Q_DOWARN ! 107: Warn the user with user ID ! 108: .I uid ! 109: about excessive disc usage. ! 110: This call causes the system to check its current disc usage ! 111: information and print a message on the terminal of ! 112: the caller for each file system on which the user is over quota. ! 113: If the user is under quota, his warning count is reset to MAX_*_WARN ! 114: (defined in ! 115: .RI < sys/quota.h >). ! 116: If the ! 117: .I arg ! 118: parameter is specified as NODEV, all file systems that have ! 119: disc quotas will be checked. Otherwise, ! 120: .I arg ! 121: indicates a specific major-minor device to be checked. ! 122: This call is restricted to the super-user. ! 123: .SH "RETURN VALUE" ! 124: A successful call returns 0, ! 125: otherwise the value \-1 is returned and the global variable ! 126: .I errno ! 127: indicates the reason for the failure. ! 128: .SH ERRORS ! 129: A \fIquota\fP call will fail when one of the following occurs: ! 130: .TP 15 ! 131: [EINVAL] ! 132: The kernel has not been compiled with the QUOTA option. ! 133: .TP 15 ! 134: [EINVAL] ! 135: .I Cmd ! 136: is invalid. ! 137: .TP 15 ! 138: [ESRCH] ! 139: No disc quota is found for the indicated user. ! 140: .TP 15 ! 141: [EPERM] ! 142: The call is priviledged and the caller was not the super-user. ! 143: .TP 15 ! 144: [ENODEV] ! 145: The ! 146: .I arg ! 147: parameter is being interpreted as a major-minor ! 148: device and it indicates an unmounted file system. ! 149: .TP 15 ! 150: [EFAULT] ! 151: An invalid ! 152: .I addr ! 153: is supplied; the associated structure could not be copied in or out ! 154: of the kernel. ! 155: .TP 15 ! 156: [EUSERS] ! 157: The quota table is full. ! 158: .SH "SEE ALSO" ! 159: setquota(2), quotaon(8), quotacheck(8) ! 160: .SH BUGS ! 161: There should be some way to integrate this call with the resource ! 162: limit interface provided by ! 163: .IR setrlimit (2) ! 164: and ! 165: .IR getrlimit (2). ! 166: .PP ! 167: The Australian spelling of ! 168: .I disk ! 169: is used throughout the quota facilities in honor of ! 170: the implementors.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.