getitimer(2) System Calls Manual getitimer(2)

ИМЯ

getitimer, setitimer - считывает или устанавливает значение таймера интервалов

Standard C library (libc, -lc)

СИНТАКСИС

#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);

ОПИСАНИЕ

Данные системные вызовы предоставляют доступ к интервальным таймерам, то есть таймерам, у которых изначально истекает срок в будущем, и (необязательно) с регулярными интервалами после. Когда у таймера истекает срок, вызвавшему процессу отправляется сигнал и таймер перезапускается с задаваемым интервалом (если интервал не равен нулю).

Three types of timers—specified via the which argument—are provided, each of which counts against a different clock and generates a different signal on timer expiration:

Этот таймер отсчитывается по реальному времени (то есть обычному). По каждому истечению выдаёт сигнал SIGALRM.
Этот таймер отсчитывается по времени ЦП в пользовательском режиме, проведённым процессом (учёт включает время ЦП, потреблённое всеми нитями процесса). По каждому истечению выдаёт сигнал SIGVTALRM.
Этот таймер отсчитывается по полному времени ЦП, потраченному процессом (учёт включает время ЦП, потреблённое всеми нитями процесса). По каждому истечению выдаёт сигнал SIGPROF.
Данный таймер вместе с ITIMER_VIRTUAL можно использовать для профилирования затрат процессом системного и пользовательского времени ЦП.

Процесс может иметь только по одному таймеру каждого типа.

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


struct itimerval {
    struct timeval it_interval; /* Interval for periodic timer */
    struct timeval it_value;    /* Time until next expiration */
};
struct timeval {
    time_t      tv_sec;         /* seconds */
    suseconds_t tv_usec;        /* microseconds */
};

Функция getitimer() помещает текущее значение таймера, указанного в which, в буфер, указанный в curr_value.

Вложенная структура it_value содержит количество оставшегося времени до следующего истечения таймера. Это значение изменяется после начала отсчёта таймера и будет сброшено в it_interval при истечении таймера. Если оба поля it_value равны нулю, то это означает что таймер выключен (неактивен).

Вложенная структура it_interval содержит интервал таймера. Если оба поля it_intervalравны нулю, то это указывает на одноразовый таймер (то срабатывающий один раз).

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

Если какое-то из полей в new_value.it_value не равно нулю, то таймер изначально включается как просроченный на указанное время. Если оба поля в new_value.it_value равны нулю, то таймер отключён.

Поле new_value.it_interval задаёт новый интервал таймера;если оба поля равны нулю, то таймер будет одноразовым.

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

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

ОШИБКИ

Указатели new_value, old_value или curr_value являются некорректными.
which is not one of ITIMER_REAL, ITIMER_VIRTUAL, or ITIMER_PROF; or (since Linux 2.6.22) one of the tv_usec fields in the structure pointed to by new_value contains a value outside the range [0, 999999].

ВЕРСИИ

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


setitimer(which, NULL, &old_value);

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


getitimer(which, &old_value);

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

СТАНДАРТЫ

POSIX.1-2008.

ИСТОРИЯ

POSIX.1-2001, SVr4, 4.4BSD (впервые этот вызов появился в 4.2BSD). В POSIX.1-2008 вызовы getitimer() и setitimer() помечены как устаревшие, и вместо них рекомендуется использовать программный интерфейс таймеров POSIX (timer_gettime(2), timer_settime(2) и т.д.).

ПРИМЕЧАНИЯ

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

Потомок, созданный через fork(2), не наследует таймеры интервалов родителя. При вызове execve(2) таймеры интервалов сохраняются.

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

ОШИБКИ

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

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.

СМОТРИТЕ ТАКЖЕ

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

ПЕРЕВОД

Русский перевод этой страницы руководства разработал Azamat Hackimov <azamat.hackimov@gmail.com>, Dmitry Bolkhovskikh <d20052005@yandex.ru>, Vladislav <ivladislavefimov@gmail.com>, Yuri Kozlov <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>

Этот перевод является свободной программной документацией; он распространяется на условиях общедоступной лицензии GNU (GNU General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.

Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику по его адресу электронной почты или по адресу списка рассылки русских переводчиков.

2 мая 2024 г. Linux man-pages 6.8