View Source: getrlimit(2) - Waikato Linux Users Group

Edit PageHistory Diff Info LikePages

!!NAME
getrlimit - get resource limits
!!SYNOPSIS

 __#include <sys/time.h>__
 __#include <sys/resource.h>__
 __#include <unistd.h>__

 __int getrlimit (int__ ''resource''__, struct rlimit *__''rlim''__);__
!!DESCRIPTION
getrlimit(2) get resource limits respectively. ''resource'' should be one of:

 __RLIMIT_CPU__ /* CPU time in seconds */
 __RLIMIT_FSIZE__ /* Maximum filesize */
 __RLIMIT_DATA__ /* max data size */
 __RLIMIT_STACK__ /* max stack size */
 __RLIMIT_CORE__ /* max core file size */
 __RLIMIT_RSS__ /* max resident set size */
 __RLIMIT_NPROC__ /* max number of processes */
 __RLIMIT_NOFILE__ /* max number of open files */
 __RLIMIT_MEMLOCK__ /* max locked-in-memory address space*/
 __RLIMIT_AS__ /* address space (virtual memory) limit */

A resource may unlimited if you set the limit to __RLIM_INFINITY__. __RLIMIT_OFILE__ is the BSD name for __RLIMIT_NOFILE__.

The __rlimit__ structure is defined as follows:

 struct rlimit {
  rlim_t    rlim_cur;
  rlim_t    rlim_max;
 };

 __getrusage__ returns the current resource usages, for a ''who'' of either __RUSAGE_SELF__ or __RUSAGE_CHILDREN.__

 struct rusage {
  struct timeval ru_utime; /* user time used */
  struct timeval ru_stime; /* system time used */
  long ru_maxrss;          /* maximum resident set size */
  long ru_ixrss;      /* integral shared memory size */
  long ru_idrss;      /* integral unshared data size */
  long ru_isrss;      /* integral unshared stack size */
  long ru_minflt;          /* page reclaims */
  long ru_majflt;          /* page faults */
  long ru_nswap;      /* swaps */
  long ru_inblock;         /* block input operations */
  long ru_oublock;         /* block output operations */
  long ru_msgsnd;          /* messages sent */
  long ru_msgrcv;          /* messages received */
  long ru_nsignals;        /* signals received */
  long ru_nvcsw;      /* voluntary context switches */
  long ru_nivcsw;          /* involuntary context switches */
 };
!!RETURN VALUE


On success, zero is returned. On error, -1 is returned, and ''errno'' is set appropriately.

!!ERRORS
;[EFAULT]: ''rlim'' points outside the accessible address space.
;[EINVAL]: getrlimit(2) is called with a bad ''resource''
!!CONFORMING TO
SVr4, BSD 4.3
!!NOTE
Including ''<sys/time.h>'' is not required these days, but increases portability. (Indeed, ''struct timeval'' is defined in ''<sys/time.h>''.)

The above struct was taken from BSD 4.3 Reno. Not all fields are meaningful under Linux. Right now (Linux 2.4) only the fields __ru_utime__, __ru_stime__, __ru_minflt__, __ru_majflt__, and __ru_nswap__ are maintained.

!!SEE ALSO
quotactl(2), ulimit(3)

6 pages link to getrlimit(2):

This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.

Last edited on Tuesday, December 31, 2002 2:00:14 am by PerryLorier

Edit PageHistory Diff Info LikePages