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)