NAZWA¶

getitimer, setitimer - pobranie i ustawienie wartości czasomierza

BIBLIOTEKA¶

Standardowa biblioteka C (libc, -lc)

SKŁADNIA¶

#include <sys/time.h>

int getitimer(int which, struct itimerval *curr_value);
int setitimer(int which, const struct itimerval *restrict new_value,
              struct itimerval *_Nullable restrict old_value);

OPIS¶

Te wywołania systemowe umożliwiają dostęp do czasomierzy (timerów) interwałowych, to jest timerów, które najpierw wygasają w pewnym punkcie w przyszłości, a potem (opcjonalnie) w regularnych odstępach czasu. Po wygaśnięciu timera wysyłany jest sygnał do procesu wywołującego, a następnie timer jest ponownie inicjowany podaną wartością interwału (jeśli jest niezerowa).

Dostępne są trzy typy czasomierzy, podawane w argumencie which; każdy z nich mierzy czas według innego zegara i generuje inny sygnał, gdy upłynie czas ważności:

ITIMER_REAL

Odlicza czas rzeczywisty. Po wygaśnięciu generuje sygnał SIGALRM.

ITIMER_VIRTUAL

Odlicza czas CPU wykonywania się procesu w przestrzeni użytkownika. (Obliczenia obejmują czas CPU zużyty przez wszystkie wątki procesu). Po każdorazowym wygaśnięciu generowany jest sygnał SIGVTALRM.

ITIMER_PROF

Odlicza całkowity (tj. zarówno w przestrzeni użytkownika, jak i jądra systemu) czas CPU wykonywania się procesu. (Obliczenia obejmują czas CPU zużyty przez wszystkie wątki procesu). Po każdorazowym wygaśnięciu generowany jest sygnał SIGPROF.

W powiązaniu z ITIMER_VIRTUAL ten czasomierz zwykle jest używany do profilowania czasu używanego przez aplikację zarówno w przestrzeni użytkownika, jak i jądra.

Proces ma tylko po jednym timerze każdego z tych trzech typów.

Wartości czasomierza są zdefiniowane za pomocą następujących struktur:

struct itimerval {


    struct timeval it_interval; /* Interwał czasomierza periodycznego */


    struct timeval it_value;    /* Czas do następnego wygaśnięcia */
};
struct timeval {


    long tv_sec;                /* sekundy */


    long tv_usec;               /* mikrosekundy */
};

WARTOŚĆ ZWRACANA¶

On success, zero is returned. On error, -1 is returned, and errno is set to indicate the error.

BŁĘDY¶

EFAULT

new_value, old_value lub curr_value nie jest poprawnym wskaźnikiem.

EINVAL

which nie jest jednym z ITIMER_REAL, ITIMER_VIRTUAL lub ITIMER_PROF albo (od Linuksa 2.6.22) jedno z pól tv_usec w strukturze wskazywanej przez new_value zawiera wartość spoza zakresu od 0 do 999999.

STANDARDY¶

POSIX.1-2001, SVr4, 4.4BSD (to wywołanie najpierw pojawiło się w 4.2BSD). POSIX.1-2008 uznaje getitimer() i setitimer() za przestarzałe, zalecając zamiast nich używanie API POSIX-owych czasomierzy (timer_gettime(2), timer_settime(2) i tak dalej).

UWAGI¶

Ważność czasomierzy nigdy nie upływa przed zadanym czasem, natomiast może ona upłynąć jakiś (krótki) czas później, co zależy od rozdzielczości zegara systemowego i obciążenia systemu, patrz time(7) (patrz także rozdział USTERKI poniżej). Jeśli czas ważności upływa, gdy proces jest aktywny (jest to zawsze prawda dla ITIMER_VIRTUAL), to sygnał zostanie dostarczony natychmiast po wygenerowaniu.

Dziecko utworzone przez fork(2) nie dziedziczy timerów interwałowych rodzica. Jednakże timery te są zachowywane przez execve(2).

POSIX.1 nie określa interakcji pomiędzy setitimer() i trzema interfejsami alarm(2), sleep(3) oraz usleep(3).

Standardy nie określają znaczenia poniższego wywołania:

setitimer(which, NULL, &old_value);

Wiele systemów (Solaris, systemy BSD i być może również inne) traktuje to jako równoważne z:

getitimer(which, &old_value);

Pod Linuksem jest to odpowiednikiem wywołania, w którym pola new_value są ustawione na zero, to jest czasomierz jest wyłączany. Prosimiy o nieużywanie tej właściwości Linuska: jest nieprzenośna i niepotrzebna.

BŁĘDY¶

Pod Linuksem generowanie i dostarczanie sygnału są oddzielnymi zdarzeniami i dla każdego sygnału może być tylko jedno zaległe zdarzenie. Zatem możliwe jest, że podczas patologicznie dużego obciążenia czas ważności ITIMER_REAL może upłynąć wcześniej, niż sygnał poprzedniego przeterminowania zostanie dostarczony. Drugi sygnał w takiej sytuacji zostanie utracony.

Before Linux 2.6.16, timer values are represented in jiffies. If a request is made set a timer with a value whose jiffies representation exceeds MAX_SEC_IN_JIFFIES (defined in include/linux/jiffies.h), then the timer is silently truncated to this ceiling value. On Linux/i386 (where, since Linux 2.6.13, the default jiffy is 0.004 seconds), this means that the ceiling value for a timer is approximately 99.42 days. Since Linux 2.6.16, the kernel uses a different internal representation for times, and this ceiling is removed.

On certain systems (including i386), Linux kernels before Linux 2.6.12 have a bug which will produce premature timer expirations of up to one jiffy under some circumstances. This bug is fixed in Linux 2.6.12.

POSIX.1-2001 says that setitimer() should fail if a tv_usec value is specified that is outside of the range [0, 999999]. However, up to and including Linux 2.6.21, Linux does not give an error, but instead silently adjusts the corresponding seconds value for the timer. From Linux 2.6.22 onward, this nonconformance has been repaired: an improper tv_usec value results in an EINVAL error.

ZOBACZ TAKŻE¶

gettimeofday(2), sigaction(2), signal(2), timer_create(2), timerfd_create(2), time(7)

TŁUMACZENIE¶

Autorami polskiego tłumaczenia niniejszej strony podręcznika są: Przemek Borys <pborys@dione.ids.pl>, Andrzej Krzysztofowicz <ankry@green.mf.pg.gda.pl> i Robert Luberda <robert@debian.org>

Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe informacje o warunkach licencji można uzyskać zapoznając się z GNU General Public License w wersji 3 lub nowszej. Nie przyjmuje się ŻADNEJ ODPOWIEDZIALNOŚCI.

Błędy w tłumaczeniu strony podręcznika prosimy zgłaszać na adres listy dyskusyjnej manpages-pl-list@lists.sourceforge.net.