getrlimitusage(2) manual page

Manual Pages — GETRLIMITUSAGE

NAME

getrlimitusage – Query usage of the current process' limited resources

LIBRARY

Standard C Library (libc, -lc)

SYNOPSIS

#include <sys/resource.h>

int
getrlimitusage(unsigned which, int flags, rlim_t *res);

DESCRIPTION

The getrlimitusage system call allows the process to query current consumption of the resources limited by the setrlimit(2) call.

The which argument specifies the resource, same as for getrlimit(2) and setrlimit(2) calls, see their man page for the list of enforced resource types.

The flags argument modifies the behavior of the call in the following ways:

GETRLIMITUSAGE_EUID

Query the resource usage for user identified by effective UID of the process, instead of the real UID (which is default for accounting).

RETURN VALUES

Upon successful completion, the value 0 is returned; otherwise the value -1 is returned and the global variable errno is set to indicate the error.

ERRORS

The getrlimitusage() system call will fail if:

[`EFAULT`]
	The address specified for res is invalid.
[`EINVAL`]
	The resource specified to `getrlimitusage()` in the which argument is unknown.
[`ENXIO`]
	The resource specified to `getrlimitusage()` in the which argument is not accounted, but only enforced in specific situations. Examples of such resources are RLIMIT_FSIZE and RLIMIT_CORE.

HISTORY

The getrlimitusage() system call appeared in BSD 15.0 .

GETRLIMITUSAGE (2)

September 27, 2024

Please direct any comments about this manual page service to Ben Bullock. Privacy policy.

“	Unix’s “power tools” are more like power switchblades that slice off the operator’s fingers quickly and efficiently.	”
— The Unix Haters' handbook