|
|
1.1 ! root 1: .\" Copyright (c) 1980 Regents of the University of California. ! 2: .\" All rights reserved. The Berkeley software License Agreement ! 3: .\" specifies the terms and conditions for redistribution. ! 4: .\" ! 5: .\" @(#)vlimit.3 6.3 (Berkeley) 5/17/89 ! 6: .\" ! 7: .TH VLIMIT 3C "May 17, 1989" ! 8: .UC 4 ! 9: .SH NAME ! 10: vlimit \- control maximum system resource consumption ! 11: .SH SYNOPSIS ! 12: .B "#include <sys/vlimit.h>" ! 13: .PP ! 14: .B vlimit(resource, value) ! 15: .SH DESCRIPTION ! 16: .ft B ! 17: This interface is obsoleted by getrlimit(2). ! 18: .br ! 19: It is available from the compatibility library, libcompat. ! 20: .ft R ! 21: .PP ! 22: Limits the consumption by the current process and each process ! 23: it creates to not individually exceed ! 24: .I value ! 25: on the specified ! 26: .I resource. ! 27: If ! 28: .I value ! 29: is specified as \-1, then the current limit is returned and the ! 30: limit is unchanged. ! 31: The resources which are currently controllable are: ! 32: .TP 15 ! 33: LIM_NORAISE ! 34: A pseudo-limit; if set non-zero then the limits may not be raised. ! 35: Only the super-user may remove the \fInoraise\fR restriction. ! 36: .TP 15 ! 37: LIM_CPU ! 38: the maximum ! 39: number of cpu-seconds to be used by each process ! 40: .TP 15 ! 41: LIM_FSIZE ! 42: the largest single file which can be created ! 43: .TP 15 ! 44: LIM_DATA ! 45: the maximum growth of the data+stack region via ! 46: .IR sbrk (2) ! 47: beyond the end of the program text ! 48: .TP 15 ! 49: LIM_STACK ! 50: the maximum ! 51: size of the automatically-extended stack region ! 52: .TP 15 ! 53: LIM_CORE ! 54: the size of the largest core dump that will be created. ! 55: .TP 15 ! 56: LIM_MAXRSS ! 57: a soft limit for the amount of physical memory (in bytes) to be given ! 58: to the program. If memory is tight, the system will prefer to take memory ! 59: from processes which are exceeding their declared LIM_MAXRSS. ! 60: .PP ! 61: Because this information is stored in the per-process information ! 62: this system call must be executed directly by the shell if it ! 63: is to affect all future processes created by the shell; ! 64: .I limit ! 65: is thus a built-in command to ! 66: .IR csh (1). ! 67: .PP ! 68: The system refuses to extend the data or stack space when the limits ! 69: would be exceeded in the normal way; a ! 70: .I break ! 71: call fails if the data space limit is reached, or the process is ! 72: killed when the stack limit is reached (since the stack cannot be ! 73: extended, there is no way to send a signal!). ! 74: .PP ! 75: A file i/o operation which would create a file which is too large ! 76: will cause a signal SIGXFSZ to be generated, this normally terminates ! 77: the process, but may be caught. ! 78: When the cpu time limit is exceeded, a signal SIGXCPU is sent to the ! 79: offending process; to allow it time to process the signal it is ! 80: given 5 seconds grace by raising the cpu time limit. ! 81: .SH SEE ALSO ! 82: csh(1) ! 83: .SH BUGS ! 84: LIM_NORAISE no longer exists.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.