Retourne le niveau d'utilisation des ressources

# getrusage

(PHP 4, PHP 5, PHP 7)

getrusage — Retourne le niveau d'utilisation des ressources

### Description

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

C'est une interface à la fonction système getrusage(2). Elle retourne un tableau associatif contenant les informations renvoyées par cet appel système.

### Liste de paramètres

`who`

  Si `who` est égal à 1, getrusage() sera appelé avec le paramètre `RUSAGE_CHILDREN`.

### Valeurs de retour

Retourne un tableau associatif contenant les données retournées depuis l'appel système. Toutes les entrées sont accessibles en utilisant leurs noms de champs documentés.

### Exemples

Exemple #1 Exemple avec getrusage()

`<?php
$dat = getrusage();
echo $dat["ru_oublock"]; // nombre d'opération de block de sortie
echo $dat["ru_inblock"]; // nombre d'opération de block d'entrée
echo $dat["ru_msgsnd"]; // nombre de messages IPC envoyé
echo $dat["ru_msgrcv"]; // nombre de messages IPC reçu
echo $dat["ru_maxrss"]; // taille maximale du groupe de résidents
echo $dat["ru_ixrss"]; // taille de la mémoire partagée intégrale
echo $dat["ru_idrss"]; // taille intégrale des données non partagées
echo $dat["ru_minflt"]; // nombre de page récupéré (faute de page mineure)
echo $dat["ru_majflt"]; // nombre de défauts de page (faute de page majeure)
echo $dat["ru_nsignals"]; // nombre de signaux reçu
echo $dat["ru_nvcsw"]; // nombre de changement de contexte volontaire
echo $dat["ru_nivcsw"]; // nombre de changement de contexte involontaire
echo $dat["ru_nswap"]; // taille de la mémoire swap
echo $dat["ru_utime.tv_usec"]; // temps utilisateur utilisé (en microsecondes)
echo $dat["ru_utime.tv_sec"]; // temps utilisateur utilisé (en secondes)
echo $dat["ru_stime.tv_usec"]; // temps système utilisé (en microsecondes)
?>`

### Historique

Version | Description
--- | ---
7.0.0 | Cette fonction est maintenant supportée sous Windows.

### Notes

> Note:

> Sous Windows, la fonction getrusage() ne va retourner que les membres suivants :

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

> Si getrusage() est appelé avec le paramètre `who` vallant 1 (`RUSAGE_CHILDREN`), alors l'utilisation de la ressource pour les threads sont collectés (ce qui signifie que, en interne, la fonction est appelée avec `RUSAGE_THREAD`).

> Note:

> Sous BeOS 2000, seuls les membres suivants sont retournés :

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

### Voir aussi

- La page de manuel getrusage(2) de votre système