getrusage

(PHP 4, PHP 5, PHP 7)

getrusageRetourne 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