(PHP 4, PHP 5, PHP 7)
getrusage — Gets the current resource usages
$who = 0
] )This is an interface to getrusage(2). It gets data returned from the system call.
who
If who is 1, getrusage will be called with
RUSAGE_CHILDREN.
Returns an associative array containing the data returned from the system call. All entries are accessible by using their documented field names.
Example #1 getrusage() example
<?php
$dat = getrusage();
echo $dat["ru_nswap"]; // number of swaps
echo $dat["ru_majflt"]; // number of page faults
echo $dat["ru_utime.tv_sec"]; // user time used (seconds)
echo $dat["ru_utime.tv_usec"]; // user time used (microseconds)
?>
| Version | Description |
|---|---|
| 7.0.0 | This function is now supported on Windows. |
Note:
On Windows getrusage() will only return the following members:
- "ru_stime.tv_sec"
- "ru_stime.tv_usec"
- "ru_utime.tv_sec"
- "ru_utime.tv_usec"
- "ru_majflt" (only if
whoisRUSAGE_SELF)- "ru_maxrss" (only if
whoisRUSAGE_SELF)If getrusage() is called with
whoset to 1 (RUSAGE_CHILDREN), then resource usage for threads are collected (meaning that internally the function is called withRUSAGE_THREAD).
Note:
on BeOS 2000, only the following members are returned:
- "ru_stime.tv_sec"
- "ru_stime.tv_usec"
- "ru_utime.tv_sec"
- "ru_utime.tv_usec"
getrusage() reports kernel counters that are updated only once application loses context and a switch to kernel space happens. For example on modern Linux server kernels that would mean that getrusage() calls would return information rounded at 10ms, desktop kernels - at 1ms.
getrusage() isn't usable for micro-measurements at all - and getmicrotime(true) might be much more valuable resource.
