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

### 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