Liefert den aktuellen Wert der Ressourcenauslastung

# getrusage

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

getrusage — Liefert den aktuellen Wert der Ressourcenauslastung

### Beschreibung

function 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.

### 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 `mode` `RUSAGE_SELF` ist).
> - `"ru_maxrss"` (nur wenn `mode` `RUSAGE_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)

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