posix_getrlimit

(PHP 4, PHP 5, PHP 7, PHP 8)

posix_getrlimit — Return info about system resource limits

Description

posix_getrlimit(?int $resource = null): array|false

posix_getrlimit() returns an array of information about the current resource's soft and hard limits.

Each resource has an associated soft and hard limit. The soft limit is the value that the kernel enforces for the corresponding resource. The hard limit acts as a ceiling for the soft limit. An unprivileged process may only set its soft limit to a value from 0 to the hard limit, and irreversibly lower its hard limit.

Parameters

resource: If null all resource limits will be fetched. Otherwise, the only limits of the resource type provided will be returned.

Return Values

Returns an associative array of elements for each limit that is defined. Each limit has a soft and a hard limit.

**List of possible limits returned**
Limit name	Limit description
core	The maximum size of the core file. When 0, not core files are created. When core files are larger than this size, they will be truncated at this size.
totalmem	The maximum size of the memory of the process, in bytes.
virtualmem	The maximum size of the virtual memory for the process, in bytes.
data	The maximum size of the data segment for the process, in bytes.
stack	The maximum size of the process stack, in bytes.
rss	The maximum number of virtual pages resident in RAM
maxproc	The maximum number of processes that can be created for the real user ID of the calling process.
memlock	The maximum number of bytes of memory that may be locked into RAM.
cpu	The amount of time the process is allowed to use the CPU.
filesize	The maximum size of the data segment for the process, in bytes.
openfiles	One more than the maximum number of open file descriptors.

The function returns false on failure.

Changelog

Version	Description
8.3.0	The optional `resource` parameter has been added.

Examples

Example #1 Example use of posix_getrlimit()

<?php

$limits = posix_getrlimit();

print_r($limits);
?>

The above example will output something similar to:

Array
(
    [soft core] => 0
    [hard core] => unlimited
    [soft data] => unlimited
    [hard data] => unlimited
    [soft stack] => 8388608
    [hard stack] => unlimited
    [soft totalmem] => unlimited
    [hard totalmem] => unlimited
    [soft rss] => unlimited
    [hard rss] => unlimited
    [soft maxproc] => unlimited
    [hard maxproc] => unlimited
    [soft memlock] => unlimited
    [hard memlock] => unlimited
    [soft cpu] => unlimited
    [hard cpu] => unlimited
    [soft filesize] => unlimited
    [hard filesize] => unlimited
    [soft openfiles] => 1024
    [hard openfiles] => 1024
)

Improve This Page

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 1 note

down

petert at tebault dot org ¶

24 years ago

The array returned (on a RH6.2 box) is:

     soft core = 0

     hard core = unlimited

     soft data = unlimited

     hard data = unlimited

     soft stack = 8388608

     hard stack = unlimited

     soft totalmem = unlimited

     hard totalmem = unlimited

     soft rss = unlimited

     hard rss = unlimited

     soft maxproc = 2048

     hard maxproc = 2048

     soft memlock = unlimited

     hard memlock = unlimited

     soft cpu = unlimited

     hard cpu = unlimited

     soft filesize = unlimited

     hard filesize = unlimited

     soft openfiles = 1024

     hard openfiles = 1024