Manpages

ИМЯ

getitimer, setitimer − получить или установить значение внутреннего таймера

ОБЗОР

#include <sys/time.h>

int getitimer(int

which, struct itimerval *value);

int setitimer(int

which, const struct itimerval *value, struct

itimerval *ovalue);

ОПИСАНИЕ

Система предоставляет каждому процессу три внутренних таймера, каждый из которых работает в отдельном временном домене. Когда любой из этих таймеров истекает, процессу, в котором функционировал данный таймер посылается сигнал и таймер (потенциально) перезапускается.

ITIMER_REAL

работает в реальном времени и по истечении отправляет сигнал SIGALRM .

ITIMER_VIRTUAL

работает только, когда процесс выполняется и по истечении отправляет сигнал SIGVTALRM .

ITIMER_PROF

работает и когда процесс выполняется, и когда система работает в интересах процесса. Запущенный совместно с ITIMER_VIRTUAL, данный таймер обычно используется для профилирования времени, которое приложение проводит в режиме пользователя и в режиме ядра. По истечении отправляет сигнал SIGPROF .

Значения таймера задаются с помощью следующих структур:

struct itimerval {
struct timeval it_interval; /* next value */
struct timeval it_value; /* current value */
};
struct timeval {
long tv_sec; /* seconds */
long tv_usec; /* microseconds */
};

Фнкция getitimer заполняет структуру, предоставляемую как value текущими установками таймера, который обозначается как which (одно из значений ITIMER_REAL, ITIMER_VIRTUAL, или ITIMER_PROF). Элемент it_value устанавливает ожидаемое время, оставшееся на таймере или ноль если таймер запрещается. Похожим образом устанавливается it_interval для значения сброса. Функция setitimer устанавливает указанный таймер в значение, указанное в value. Если ovalue не ноль, там будет сохранено старое значение таймера.

Таймеры уменьшающиеся от it_value до нуля, генерируют сигнал и сбрасываются в it_interval. Таймер, который установлен в ноль (it_value является нулем или таймер истёк и it_interval является нулём) останавливается.

Оба значения tv_sec и tv_usec являются важными при определении длительности работы таймера.

Таймеры никогда не истекают до затребованного времени, напротив они немного запаздывают, в зависимости от шага системного таймера (в настоящий момент 10 миллисекунд). По истечении будет сгенерирован сигнал и произойдёт сброс таймера. Если таймер истекает в момент когда процесс активен (это всегда так для ITIMER_VIRT), то сигнал будет доставлен немедленно после генерации. В противном случае, доставка будет отложена на небольшое время, которое зависит от степени загрузки системы.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

В случае успеха, возвращается ноль. В случае ошибки, возвращается −1 и значение errno устанавливается соответствующим образом.

ОШИБКИ

EFAULT

value или ovalue не являются правильными указателями.

EINVAL

which не является одним из значений ITIMER_REAL, ITIMER_VIRT, или ITIMER_PROF.

СООТВЕТСТВИЕ СТАНДАРТАМ

SVr4, 4.4BSD (Данный вызов появился сперва в 4.2BSD).

СМОТРИ ТАКЖЕ

gettimeofday(2), sigaction(2), signal(2)

БАГИ

Под Linux, генерация и доставка сигнала разделены и каждому сигналу разрешается генерировать только один недоставленный сигнал. Таким образом, получается, что при очень сильной загрузке системы, ITIMER_REAL таймер будет истекать перед тем как будет доставлен сигнал от предыдущего истекания таймера. Второй сигнал в этом случае будет потерян.

ПЕРЕВОД

Перевёл с английского Виктор Вислобоков <corochoone [AT] perm.ru> 2004