getrusage

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

    getrusage — Retourne le niveau d'utilisation des ressources

    Description

    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.

    Historique

    VersionDescription
    7.0.0 Cette fonction est maintenant supportée sous Windows.

    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
    To Top