NAME    [Toc]    [Back]

     ulimit -- get and set process limits

LIBRARY    [Toc]    [Back]

     Standard C Library (libc, -lc)

SYNOPSIS    [Toc]    [Back]

     #include <ulimit.h>

     long
     ulimit(int cmd, ...);

DESCRIPTION    [Toc]    [Back]

     The ulimit() function will get and set process limits.  Currently this is
     limited to the maximum file size.	The cmd argument is one of the following:


     UL_GETFSIZE  will return the maximum file size in units of 512 blocks of
		  the current process.

     UL_SETFSIZE  will attempt to set the maximum file size of the current
		  process and its children with the second argument expressed
		  as a long.

RETURN VALUES    [Toc]    [Back]

     Upon successful completion, ulimit() returns the value requested; otherwise
 the value -1 is returned and the global variable errno is set to
     indicate the error.

ERRORS    [Toc]    [Back]

     The ulimit() function will fail if:

     [EINVAL]		The command specified was invalid.

     [EPERM]		The limit specified to ulimit() would have raised the
			maximum limit value, and the caller is not the superuser.

SEE ALSO    [Toc]    [Back]

     getrlimit(2)

STANDARDS    [Toc]    [Back]

     The ulimit() function conforms to IEEE Std 1003.1-2001 (``POSIX.1'').

HISTORY    [Toc]    [Back]

     The ulimit() function first appeared in FreeBSD 5.0.

BUGS    [Toc]    [Back]

     The ulimit() function provides limited precision for setting and retrieving
 process limits.  If there is a need for greater precision than the
     type long provides, the getrlimit(2) and setrlimit(2) functions should be
     considered.


FreeBSD 5.2.1			January 4, 2003 		 FreeBSD 5.2.1