getrusage
(PHP 4, PHP 5, PHP 7, PHP 8)
getrusage — Retourne le niveau d'utilisation des ressources
Description
getrusage(int $mode
= 0): array|false
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é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)
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
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