timer_create(2) - Linux 手册页

版本

此系统调用自 Linux 2.6 起可用。

符合

POSIX.1-2001。

说明

程序可以使用 timer_create() 创建多个间隔定时器。

定时器不会被 fork(2) 的子进程继承，并且在 execve(2) 期间会被解除激活并删除。

内核为使用 timer_create() 创建的每个定时器预分配一个“排队的实时信号”。因此，定时器的数量受 RLIMIT_SIGPENDING 资源限制的限制（请参阅 setrlimit(2)）。

由 timer_create() 创建的定时器通常被称为“POSIX（间隔）定时器”。POSIX 定时器 API 由以下接口组成

*

timer_create(): 创建一个定时器。

*

timer_settime(2): 激活（启动）或解除激活（停止）定时器。

*

timer_gettime(2): 获取到定时器下一次到期的剩余时间，以及定时器的间隔设置。

*

timer_getoverrun(2): 返回上次定时器到期的超次数。

*

timer_delete(2): 解除激活并删除定时器。

POSIX 定时器 API 的部分实现由 glibc 提供。特别是

*

SIGEV_THREAD 的功能是在 glibc 内实现的，而不是在内核中。

*

用户级别呈现的定时器 ID 由 glibc 维护，glibc 将这些 ID 映射到内核使用的定时器 ID。

POSIX 定时器系统调用首次出现在 Linux 2.6 中。在此之前，glibc 提供了使用 POSIX 线程的不完整用户空间实现（仅 CLOCK_REALTIME 定时器），并且当前的 glibc 在运行低于 2.6 的 Linux 内核的系统上回退到此实现。

示例

下面的程序接受两个参数：秒数内的睡眠时间，以及纳秒内的定时器频率。该程序为它用于定时器的信号建立处理程序，阻塞该信号，创建一个以给定频率到期的定时器，睡眠指定的秒数，然后取消阻塞定时器信号。假设定时器在程序睡眠期间至少到期一次，则将调用信号处理程序，并且该处理程序将显示有关定时器通知的一些信息。程序在调用一次信号处理程序后终止。

在下面的示例运行中，程序在创建频率为 100 纳秒的定时器后睡眠 1 秒。到信号被取消阻塞并传递时，已经发生了大约一千万次超次数。

$ ./a.out 1 100
Establishing handler for signal 34
Blocking signal 34
timer ID is 0x804c008
Sleeping for 1 seconds
Unblocking signal 34
Caught signal 34
    sival_ptr = 0xbfb174f4;     *sival_ptr = 0x804c008
    overrun count = 10004886

程序源码

#include <stdlib.h>
#include <unistd.h>
#include <stdio.h>
#include <signal.h>
#include <time.h>

#define CLOCKID CLOCK_REALTIME
#define SIG SIGRTMIN

#define errExit(msg)    do { perror(msg); exit(EXIT_FAILURE); \
                        } while (0)

static void
print_siginfo(siginfo_t *si)
{
    timer_t *tidp;
    int or;

   tidp = si->si_value.sival_ptr;

   printf("    sival_ptr = %p; ", si->si_value.sival_ptr);
    printf("    *sival_ptr = 0x%lx\n", (long) *tidp);

   or = timer_getoverrun(*tidp);
    if (or == -1)
        errExit("timer_getoverrun");
    else
        printf("    overrun count = %d\n", or);
}

static void
handler(int sig, siginfo_t *si, void *uc)
{
    /* Note: calling printf() from a signal handler is not
       strictly correct, since printf() is not async-signal-safe;
       see signal(7) */

   printf("Caught signal %d\n", sig);
    print_siginfo(si);
    signal(sig, SIG_IGN);
}

int
main(int argc, char *argv[])
{
    timer_t timerid;
    struct sigevent sev;
    struct itimerspec its;
    long long freq_nanosecs;
    sigset_t mask;
    struct sigaction sa;

   if (argc != 3) {
        fprintf(stderr, "Usage: %s <sleep-secs> <freq-nanosecs>\n",
                argv[0]);
        exit(EXIT_FAILURE);
    }

   /* Establish handler for timer signal */

   printf("Establishing handler for signal %d\n", SIG);
    sa.sa_flags = SA_SIGINFO;
    sa.sa_sigaction = handler;
    sigemptyset(&sa.sa_mask);
    if (sigaction(SIG, &sa, NULL) == -1)
        errExit("sigaction");

   /* Block timer signal temporarily */

   printf("Blocking signal %d\n", SIG);
    sigemptyset(&mask);
    sigaddset(&mask, SIG);
    if (sigprocmask(SIG_SETMASK, &mask, NULL) == -1)
        errExit("sigprocmask");

   /* Create the timer */

   sev.sigev_notify = SIGEV_SIGNAL;
    sev.sigev_signo = SIG;
    sev.sigev_value.sival_ptr = &timerid;
    if (timer_create(CLOCKID, &sev, &timerid) == -1)
        errExit("timer_create");

   printf("timer ID is 0x%lx\n", (long) timerid);

   /* Start the timer */

   freq_nanosecs = atoll(argv[2]);
    its.it_value.tv_sec = freq_nanosecs / 1000000000;
    its.it_value.tv_nsec = freq_nanosecs % 1000000000;
    its.it_interval.tv_sec = its.it_value.tv_sec;
    its.it_interval.tv_nsec = its.it_value.tv_nsec;

   if (timer_settime(timerid, 0, &its, NULL) == -1)
         errExit("timer_settime");

   /* Sleep for a while; meanwhile, the timer may expire
       multiple times */

   printf("Sleeping for %d seconds\n", atoi(argv[1]));
    sleep(atoi(argv[1]));

   /* Unlock the timer signal, so that timer notification
       can be delivered */

   printf("Unblocking signal %d\n", SIG);
    if (sigprocmask(SIG_UNBLOCK, &mask, NULL) == -1)
        errExit("sigprocmask");

   exit(EXIT_SUCCESS);
}

参见

clock_gettime(2), setitimer(2), timer_delete(2), timer_getoverrun(2), timer_settime(2), timerfd_create(2), clock_getcpuclockid(3), pthread_getcpuclockid(3), pthreads(7), sigevent(7), signal(7), time(7)

引用自