# getrusage

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

getrusage — Obtiene el uso de los recursos actuales

### Descripción

getrusage(int `$who` = 0): array

Esta es una interfaz de getrusage(2). Obtiene datos devueltos de la llamada al sistema.

### Parámetros

`who`

  Si el parámetro `who` es 1, getrusage será llamado con `RUSAGE_CHILDREN`.

### Valores devueltos

Devuelve un array asociativo que contiene los datos devueltos por la llamada al sistema. Todas las entradas son accesibles mediante el uso de sus nombres de campo documentado.

### Ejemplos

Ejemplo #1 getrusage() ejemplo

`<?php
$dat = getrusage();
echo $dat["ru_oublock"]; // número de operaciones de salida en bloque
echo $dat["ru_inblock"]; // número de operaciones de entrada de bloques
echo $dat["ru_msgsnd"]; // número de mensajes de IPC enviados
echo $dat["ru_msgrcv"]; // número de mensajes de IPC recibidos
echo $dat["ru_maxrss"]; // tamaño máximo de los conjuntos de residentes
echo $dat["ru_ixrss"]; // tamaño de memoria integral compartida
echo $dat["ru_idrss"]; // tamaño integral de los datos no compartidos
echo $dat["ru_minflt"]; // número de reivindicaciones de página (fallos suaves de página)
echo $dat["ru_majflt"]; // número de fallos de página (fallos duros de página)
echo $dat["ru_nsignals"]; // número de señales recibidas
echo $dat["ru_nvcsw"]; // número de cambios de contexto voluntarios
echo $dat["ru_nivcsw"]; // número de cambios de contexto involuntarios
echo $dat["ru_nswap"]; // número de intercambios
echo $dat["ru_utime.tv_usec"]; // tiempo de usuario utilizado (microsegundos)
echo $dat["ru_utime.tv_sec"]; // tiempo de usuario utilizado (segundos)
echo $dat["ru_stime.tv_usec"]; // tiempo del sistema utilizado (microsegundos)
?>`

### Historial de cambios

Versión | Descripción
--- | ---
7.0.0 | Esta función ahora está soportada en Windows

### Notas

> Nota:

> En Windows, getrusage() solamente devolverá los siguientes miembros:

> - `"ru_stime.tv_sec"`
> - `"ru_stime.tv_usec"`
> - `"ru_utime.tv_sec"`
> - `"ru_utime.tv_usec"`
> - `"ru_majflt"` (solo si `who` es `RUSAGE_SELF`)
> - `"ru_maxrss"` (solo si `who` es `RUSAGE_SELF`)

> Si a getrusage() se le llama con `who` establecido a `1` (`RUSAGE_CHILDREN`), se recopilan los usos de recursos para los hilos (lo que significa que la función es llamada internamente con `RUSAGE_THREAD`).

> Nota:

> En BeOS 2000, solamente se devuelven los siguientes miembros:

> - `"ru_stime.tv_sec"`
> - `"ru_stime.tv_usec"`
> - `"ru_utime.tv_sec"`
> - `"ru_utime.tv_usec"`

### Ver también

- Página principal de sistema sobre getrusage(2)