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

Version Beschreibung
7.0.0 Diese Funktion wird nun unter Windows unterstützt.

Beispiele

Beispiel #1 getrusage()-Beispiel

<?php
$dat = getrusage();
echo $dat["ru_oublock"]; // number of block output operations
echo $dat["ru_inblock"]; // number of block input operations
echo $dat["ru_msgsnd"]; // number of IPC messages sent
echo $dat["ru_msgrcv"]; // number of IPC messages received
echo $dat["ru_maxrss"]; // maximum resident set size
echo $dat["ru_ixrss"]; // integral shared memory size
echo $dat["ru_idrss"]; // integral unshared data size
echo $dat["ru_minflt"]; // number of page reclaims (soft page faults)
echo $dat["ru_majflt"]; // number of page faults (hard page faults)
echo $dat["ru_nsignals"]; // number of signals received
echo $dat["ru_nvcsw"]; // number of voluntary context switches
echo $dat["ru_nivcsw"]; // number of involuntary context switches
echo $dat["ru_nswap"]; // number of swaps
echo $dat["ru_utime.tv_usec"]; // user time used (microseconds)
echo $dat["ru_utime.tv_sec"]; // user time used (seconds)
echo $dat["ru_stime.tv_usec"]; // system time used (microseconds)
echo $dat["ru_stime.tv_sec"]; // system time used (seconds)
?>

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)