ОБЗОР

#include <sys/time.h>

ОПИСАНИЕ

ITIMER_REAL

уменьшается в режиме реального времени и выдаёт сигнал SIGALRM, когда значение таймера становится равным 0.

ITIMER_VIRTUAL

уменьшается только во время работы процесса и выдаёт сигнал SIGVTALRM, когда значение таймера становится равным 0.

ITIMER_PROF

уменьшается во время работы процесса и когда система выполняет что-либо по заданию процесса. Этот таймер обычно используется вместе с ITIMER_VIRTUAL для профилирования времени работы приложения в пользовательском режиме и режиме ядра. Когда значение таймера становится равным 0, выдаётся сигнал SIGPROF.

Величина, на которую устанавливается таймер, определяется следующими структурами:

struct itimerval {
    struct timeval it_interval; /* интервал для периодического таймера */
    struct timeval it_value;    /* время до следующего окончания */
};
struct timeval {
    time_t      tv_sec;     /* секунды */
    suseconds_t tv_usec;    /* микросекунды */
};

Функция getitimer() заполняет структуру, указанную в curr_value, текущим значением (т. е., количеством времени, оставшимся до следующего истечения) таймера, указанное в which (может указываться: ITIMER_REAL, ITIMER_VIRTUAL, ITIMER_PROF). В подполях структуры it_value задаётся количество оставшегося времени таймера или ноль, если таймер выключен. В поле it_interval задаётся интервал таймера (период); если в этом поле возвращается значение ноль (в обоих подполях), то это указывает на одноразовый таймер.

Функция setitimer() настраивает указанный таймер значением new_value. Если значение old_value не NULL, то в него сохраняется старое значение таймера (т. е., информация, возвращаемая getitimer()).

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

Величины tv_sec и tv_usec являются основными при установке таймера.

Срок на таймерах никогда не заканчивается ранее указанного времени, но может (чуть-чуть) опоздать, что зависит от степени разрешения системного таймера и загрузки системы; смотрите time(7) (но смотрите ДЕФЕКТЫ далее). По истечении времени будет послан сигнал, а таймер обнулится. Если время таймера истекает во время работы процесса (всегда, если используется ITIMER_VIRTUAL), то сигнал после создания будет доставлен немедленно. Иначе отсылка сигнала откладывается на небольшой промежуток времени, зависящий от степени загруженности системы.

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

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

ЗАМЕЧАНИЯ

В POSIX.1 не определено взаимодействие между setitimer() и тремя интерфейсами: alarm(2), sleep(3) и usleep(3).

В стандартах ничего не говорится о значении вызова:

    setitimer(which, NULL, &old_value);

В многих системах (Solaris, BSD и, возможно, другие) он считается эквивалентом:

    getitimer(which, &old_value);

В Linux это эквивалентно вызову, в котором поля new_value равны 0, то есть таймер выключен. Не используйте это особенность Linux: это непереносимо и нецелесообразно.