NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS | CONFORMING TO | SEE ALSO | COLOPHON

ULIMIT(3)                 Linux Programmer's Manual                ULIMIT(3)

NAME         top

       ulimit - get and set user limits

SYNOPSIS         top

       #include <ulimit.h>

       long ulimit(int cmd, long newlimit);

DESCRIPTION         top

       Warning: This routine is obsolete.  Use getrlimit(2), setrlimit(2),
       and sysconf(3) instead.  For the shell command ulimit(), see bash(1).

       The ulimit() call will get or set some limit for the calling process.
       The cmd argument can have one of the following values.

       UL_GETFSIZE
              Return the limit on the size of a file, in units of 512 bytes.

       UL_SETFSIZE
              Set the limit on the size of a file.

       3      (Not implemented for Linux.)  Return the maximum possible
              address of the data segment.

       4      (Implemented but no symbolic constant provided.)  Return the
              maximum number of files that the calling process can open.

RETURN VALUE         top

       On success, ulimit() returns a nonnegative value.  On error, -1 is
       returned, and errno is set appropriately.

ERRORS         top

       EPERM  A unprivileged process tried to increase a limit.

CONFORMING TO         top

       SVr4, POSIX.1-2001.  POSIX.1-2008 marks ulimit() as obsolete.

SEE ALSO         top

       bash(1), getrlimit(2), setrlimit(2), sysconf(3)

COLOPHON         top

       This page is part of release 3.71 of the Linux man-pages project.  A
       description of the project, information about reporting bugs, and the
       latest version of this page, can be found at
       http://www.kernel.org/doc/man-pages/.

Linux                            2008-08-06                        ULIMIT(3)