Retourne le niveau d'utilisation des ressources

# getrusage

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

getrusage — Retourne le niveau d'utilisation des ressources

### Description

function getrusage(int `$mode` = 0): array|false

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

`mode`

  Si `mode` 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. Retourne `false` en cas d'échec.

### Exemples

Exemple #1 Exemple avec getrusage()

    <?php
    $dat = getrusage();
    echo $dat["ru_oublock"];       // nombre d'opérations de bloc de sortie
    echo $dat["ru_inblock"];       // nombre d'opérations de bloc d'entrée
    echo $dat["ru_msgsnd"];        // nombre de messages IPC envoyés
    echo $dat["ru_msgrcv"];        // nombre de messages IPC reçus
    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 pages récupérées (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çus
    echo $dat["ru_nvcsw"];         // nombre de changements de contexte volontaires
    echo $dat["ru_nivcsw"];        // nombre de changements de contexte involontaires
    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)
    echo $dat["ru_stime.tv_sec"]; // temps système utilisé (en secondes)
    ?>

### 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 `mode` vaut `RUSAGE_SELF`)
> - `"ru_maxrss"` (seulement si `mode` vaut `RUSAGE_SELF`)

> Si getrusage() est appelé avec le paramètre `mode` valant `1` (`RUSAGE_CHILDREN`), alors l'utilisation de la ressource pour les threads est collectée (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) du système

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open