Provided by: manpages-pl-dev_4.21.0-2_all 
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 */
};
getitimer()
Funkcja getitimer() wypełnia bufor wskazywany przez curr_value bieżącym wskazaniem
czasomierza podanego w parametrze which.
Do struktury it_value jest wpisywana ilość czasu, który pozostał podanemu timerowi do
następnego wygaśnięcia. Wartość ta się zmienia podczas odliczania przez czasomierz i
zostanie ustawiona na it_interval, gdy timer wygaśnie. Obie wartości it_value równe zero
oznaczają, że podany timer nie jest obecnie aktywny.
Struktura w it_interval jest ustawiana na odstęp pomiędzy kolejnymi wygaśnięciami timera.
Oba pola w it_interval równe zero oznaczają timer jednorazowy (czyli, że wygasa tylko
raz).
setitimer()
Funkcja setitimer(2) włącza lub wyłącza timer podany w argumencie which, ustawiając timer
na wartość podaną w new_value. Jeśli old_value jest różne od NULL, to bufor, na który
wskazuje, jest używany do zwrócenia poprzedniej wartości timera (to jest ta sama
informacja, którą zwraca getitimer()).
Jeśli którekolwiek pole w new_value.it_value jest niezerowe, to timer jest aktywowany i
ustawiony tak, żeby początkowo wygasł w podanym czasie. Jeśli oba pola w
new_value.it_value mają wartość zero, to timer jest wyłączony.
Pole new_value.it_interval określa nowy interwał dla timera, jeśli oba pola w nim zawarte
mają wartość zero, to jest to timer jednorazowy.
WARTOŚĆ ZWRACANA
Po pomyślnym zakończeniu zwracane jest zero. Po błędzie zwracane jest -1 i ustawiane jest
errno wskazując błąd.
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
⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ 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⟩.