getrusage

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

    getrusage — Liefert den aktuellen Wert der Ressourcenauslastung

    Beschreibung

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

    Dies ist eine Schnittstelle zu getrusage(2). Sie gibt die Daten des Systemaufrufs zurück.

    Parameter-Liste

    mode

    Ist mode 1, wird getrusage mit RUSAGE_CHILDREN aufgerufen.

    Rückgabewerte

    Gibt ein assoziatives Array mit den Daten zurück, die der Systemaufruf ausgibt. Alle Elemente sind unter Verwendung ihres dokumentierten Feldnamens zugreifbar.

    Changelog

    VersionBeschreibung
    7.0.0 Diese Funktion wird nun unter Windows unterstützt.

    Beispiele

    Beispiel #1 getrusage()-Beispiel

    <?php
    $dat     = getrusage();
    echo     $dat["ru_oublock"]; // Anzahl der Blockausgabeoperationen
    echo $dat["ru_inblock"]; // Anzahl der Blockeingabeoperationen
    echo $dat["ru_msgsnd"]; // Anzahl der gesendeten IPC-Nachrichten
    echo $dat["ru_msgrcv"]; // Anzahl der empfangenen IPC-Nachrichten
    echo $dat["ru_maxrss"]; // maximale Größe des residenten Speichers im RAM
    echo $dat["ru_ixrss"]; // Gesamtgröße des gemeinsam genutzen Speichers
    echo $dat["ru_idrss"]; // Gesamtgröße der nicht gemeinsam genutzten Daten
    echo $dat["ru_minflt"]; // Anzahl der wiederhergestellten Seiten (Soft Page Faults)
    echo $dat["ru_majflt"]; // Anzahl der Seitenfehler (Hard Page Faults)
    echo $dat["ru_nsignals"]; // Anzahl der empfangenen Signale
    echo $dat["ru_nvcsw"]; // Anzahl der freiwilligen Kontextwechsel
    echo $dat["ru_nivcsw"]; // Anzahl der unfreiwilligen Kontextwechsel
    echo $dat["ru_nswap"]; // Anzahl der Auslagerungen (Swaps)
    echo $dat["ru_utime.tv_usec"]; // verwendete Benutzerzeit (Mikrosekunden)
    echo $dat["ru_utime.tv_sec"]; // verwendete Benutzerzeit (Sekunden)
    echo $dat["ru_stime.tv_usec"]; // verwendete Systemzeit (Mikrosekunden)
    echo $dat["ru_stime.tv_sec"]; // verwendete Systemzeit (Sekunden)
    ?>

    Anmerkungen

    Hinweis:

    Unter Windows gibt getrusage() nur folgende Elemente zurück:

    • "ru_stime.tv_sec"
    • "ru_stime.tv_usec"
    • "ru_utime.tv_sec"
    • "ru_utime.tv_usec"
    • "ru_majflt" (nur wenn modeRUSAGE_SELF ist).
    • "ru_maxrss" (nur wenn modeRUSAGE_SELF ist).

    Wird getrusage() mit mode als 1 (RUSAGE_CHILDREN) aufgerufen, dann wird der Ressourcenverbrauch der Threads zusammengefasst (was bedeutet, dass die Funktion intern mit RUSAGE_THREAD aufgerufen wird).

    Hinweis:

    Unter BeOS 2000 werden nur folgende Element zurückgegeben:

    • "ru_stime.tv_sec"
    • "ru_stime.tv_usec"
    • "ru_utime.tv_sec"
    • "ru_utime.tv_usec"

    Siehe auch

    • Die Manpage zu getrusage(2)
    To Top