7.4 Resources usage and limits

The following bindings are exported by (vicare posix) and reexported by (vicare linux).

make-struct-rlimit      struct-rlimit?
struct-rlimit-rlim_cur  set-struct-rlimit-rlim_cur!
struct-rlimit-rlim_max  set-struct-rlimit-rlim_max!
RLIM_INFINITY

Function: prlimit pid resource

Function: prlimit pid resource new-rlim

Function: prlimit pid resource new-rlim old-rlim

Interface to the C function prlimit(), see the manual page prlimit(2). Get and/or set the resource limits of an arbitrary process; if successful return old-rlim, else raise an exception.

pid must be a fixnum representing the process identifier of the target process. resource must be an exact integer representing the value of a RLIMIT_ constant.

The optional new-rlim must be #f or an instance of struct-rlimit; when #f: no new value is set and the function only retrieves the current resources usage values; when a structure instance: its fields are used to set new resource usage limits.

The optional old-rlim must an instance of struct-rlimit: it is filled with the previous values for the resource usage limits and returned; when not given: a new instance is built, filled and returned.