getrusage

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

getrusageLiefert 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)