getitimer() - Unix，Linux系统调用

名称

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在确定计时器的持续时间方面都很重要。

计时器永远不会在请求时间之前超时，但可能会在之后一段时间（很短）超时，这取决于系统计时器分辨率和系统负载。（但请参见下面的错误。）超时时，将生成信号并重置计时器。如果计时器在进程活动时超时（对于ITIMER_VIRTUAL始终为真），则将在生成时立即传递信号。否则，传递将被偏移一小段时间，这取决于系统负载。

返回值

成功时，返回零。出错时，返回-1，并相应设置errno。

错误

标签	描述
EFAULT	value或ovalue不是有效的指针。
EINVAL	which不是ITIMER_REAL、ITIMER_VIRTUAL或ITIMER_PROF之一。

备注

通过fork(2)创建的子进程不继承其父进程的区间计时器。区间计时器在execve(2)中得以保留。

符合标准

POSIX.1-2001，SVr4，4.4BSD（此调用首次出现在4.2BSD中）。

参见

信号的生成和传递是不同的，并且每个进程可能只有一个上述信号的实例处于挂起状态。在非常繁重的负载下，ITIMER_REAL计时器可能在先前超时的信号传递之前超时。在这种情况下，第二个信号将丢失。

在Linux上，计时器值以节拍表示。如果请求设置一个计时器，其节拍表示的值超过MAX_SEC_IN_JIFFIES（在include/linux/jiffies.h中定义），则计时器将静默截断到此上限值。在Linux/x86（自内核2.6.13以来，默认节拍为0.004秒）上，这意味着计时器的上限值约为99.42天。

在某些系统（包括x86）上，2.6.12版本之前的Linux内核存在一个错误，在某些情况下会产生最多一个节拍的提前计时器超时。此错误已在内核2.6.12中修复。

POSIX.1-2001指出，如果指定的tv_usec值不在0到999999范围内，则setitimer()应该失败。但是，Linux不会报错，而是会静默调整计时器的相应秒值。将来（计划于2007年3月），这种不符合标准的情况将得到修复：现有应用程序现在应该进行修复，以确保它们提供正确格式的tv_usec值。

打印页面