Man page - getrusage(2)

Packages contains this manual

Package: manpages-dev
apt-get install manpages-dev

Manuals in package:

Available languages:

en fr pl ja ru ro

Manual

getrusage

NAZWA
BIBLIOTEKA
SKŁADNIA
OPIS
WARTOŚĆ ZWRACANA
BŁĘDY
ATRYBUTY
STANDARDY
HISTORIA
UWAGI
ZOBACZ TAKŻE
TŁUMACZENIE

NAZWA

getrusage - pobiera użycie zasobów

BIBLIOTEKA

Standardowa biblioteka C ( libc , -lc )

SKŁADNIA

#include <sys/resource.h>

int getrusage(int who , struct rusage * usage );

OPIS

getrusage () zwraca użycie zasobów zmierzone dla who , którym może być jeden z:
RUSAGE_SELF

Zwraca statystyki użycia zasobów procesu wywołującego, czyli sumę zasobów użytych przez wszystkie wątki procesu.

RUSAGE_CHILDREN

Zwraca statystyki użycia zasobów przez wszystkie dzieci procesu wywołującego, które się zakończyły i na które się oczekuje. Statystyki te obejmą zasoby użyte przez wnuki i kolejne pokolenia, jeśli wszystkie one oczekują na swoich zakończonych potomków.

RUSAGE_THREAD (od Linuksa 2.6.26)

Zwraca statystyki użycia zasobów przez wątek wywołujący. Aby uzyskać definicję tej stałej z <sys/resource.h> konieczne jest zdefiniowanie makra sprawdzania cech _GNU_SOURCE (przed dołączeniem jakichkolwiek plików nagłówkowych).

Użycie zasobów jest zwracane w strukturze, na którą wskazuje usage , w postaci:

struct rusage {
struct timeval ru_utime; /* użyty czas procesora użytkownika */
struct timeval ru_stime; /* użyty czas procesora systemu */
long ru_maxrss; /* maksymalny rozmiar zestawu rezydentnego */
long ru_ixrss; /* całkowity rozmiar pamięci dzielonej */
long ru_idrss; /* całkowity rozmiar niedzielonych danych */
long ru_isrss; /* całkowity rozmiar niedzielonego stosu */
long ru_minflt; /* odzyskane strony (pomniejsze chybienia) */
long ru_majflt; /* chybienia stron (główne chybienia) */
long ru_nswap; /* wymienione strony */
long ru_inblock; /* blokowe operacje wejścia */
long ru_oublock; /* blokowe operacje wyjścia */
long ru_msgsnd; /* wysłane komunikaty IPC */
long ru_msgrcv; /* otrzymane komunikaty IPC */
long ru_nsignals; /* otrzymane sygnały */
long ru_nvcsw; /* dobrowolne przełączenia kontekstu */
long ru_nivcsw; /* przymusowe przełączenia kontekstu */
};

Nie wszystkie pola są ukończone; pola nieutrzymywane są ustawiane na zero przez jądro (pola nieutrzymywane są zapewniane ze względu na kompatybilność z innymi systemami i ponieważ w przyszłości mogą być obsługiwane w Linuksie). Pola są interpretowane w następujący sposób:
ru_utime

Całkowity czas spędzony na wykonywaniu w trybie użytkownika, wyrażony jako struktura timeval (sekundy i mikrosekundy).

ru_stime

Całkowity czas spędzony na wykonywaniu w trybie jądra, wyrażony jako struktura timeval (sekundy i mikrosekundy).

ru_maxrss (od Linuksa 2.6.32)

Szczytowy osiągnięty rozmiar zestawu rezydentnego („resident set size” — RSS; w kilobajtach). W przypadku RUSAGE_CHILDREN , dotyczy to RSS największego potomka, a nie RSS całego drzewa procesów.

ru_ixrss (nieutrzymywane)