函数sem_wait, sem_timedwait, sem_trywait比较

#include

int sem_wait(sem_t*sem);

intsem_trywait(sem_t *sem);

intsem_timedwait(sem_t *sem, const struct timespec *abs_timeout);

与 -lrt 或 -pthread 一起链接。

glibc 需要特性测试宏(参看 feature_test_macros(7)):

sem_timedwait():_POSIX_C_SOURCE >= 200112L || _XOPEN_SOURCE >= 600

描述

(1)sem_wait() 递减(锁定)由 sem 指向的信号量。如果信号量的值大于零,那么递减被执行,并且函数立即返回。如果信号量的当前值是零,那么调用将阻塞到它可以执行递减操作为止(如信号量的值又增长超过零),或者调用被信号打断。

(2)sem_trywait() 与 sem_wait() 类似,只是如果递减不能立即执行,调用将返回错误(errno 设置为EAGAIN)而不是阻塞。

(3)sem_timedwait() 与 sem_wait() 类似,只不过 abs_timeout 指定一个阻塞的时间上限,如果调用因不能立即执行递减而要阻塞。abs_timeout 参数指向一个指定绝对超时时刻的结构,这个结果由自 Epoch,1970-01-0100:00:00 +0000(UTC) 秒数和纳秒数构成。

这个结构定义如下:

struct timespec {

    time_t tv_sec;        /* 秒 */

    long  tv_nsec;       /* 纳秒 */

};

如果调用时超时时刻已经到点,并且信号量不能立即锁定,那么 sem_timedwait()将失败于超时(errno 设置为 ETIMEDOUT)。

如果操作能被立即执行,那么 sem_timedwait()永远不会失败于超时错误,而不管 abs_timeout的值。进一步说,abs_timeout 的验证在此时没有进行。

返回值

所有这些函数在成功时都返回 0;错误保持信号量值没有更改,-1 被返回,并设置 errno 来指明错误。

错误

EINTR

这个调用被信号处理器中断,参看 signal(7)。

EINVAL

sem 不是一个有效的信号量。

对 sem_trywait()有如下额外的错误:

EAGAIN

操作不能执行而不阻塞(也就是说,信号量当前值是零)。

对 sem_timedwait()有如下额外的错误:

EINVAL

abs_timeout.tv_nsecs 的值小于0,或者大于等于 100 百万。

ETIMEDOUT

调用在信号量锁定之前超时。

遵循于

POSIX.1-2001.

注意

信号处理器问题中断这些函数调用,无论在 sigaction(2) 里有没有使用标志 SA_RESTART,

示例

下面展示一个操作匿名信号量的小程序。这个程序期待两个命令行参数。第一个参数指定一个秒数,这个秒数将用于设置由通过 SIGALRM 产生的定时器秒数。这个信号的处理器执行sem_post(3) 来递增一个信号量,这个信号量已经在 main() 函数里使用 sem_timedwait() 等待。第二个命令行参数指定调用 sem_timedwait()超时的长度,以秒为单位。现在示例了这个程序两种不同运行情况:

$ ./a.out 2 3

About to callsem_timedwait()

sem_post() fromhandler

sem_getvalue()from handler; value = 1

sem_timedwait()succeeded

$ ./a.out 2 1

About to callsem_timedwait()

sem_timedwait()timed out

程序源码

#include

#include

#include

#include

#include

#include

#include

#include

 

sem_t sem;

 

#definehandle_error(msg) \

    do { perror(msg); exit(EXIT_FAILURE); }while (0)

 

static void

handler(int sig)

{

    write(STDOUT_FILENO, "sem_post() fromhandler\n", 24);

    if (sem_post(&sem) == -1) {

        write(STDERR_FILENO, "sem_post()failed\n", 18);

        _exit(EXIT_FAILURE);

    }

}

 

int

main(int argc,char *argv[])

{

    struct sigaction sa;

    struct timespec ts;

    int s;

 

    if (argc != 3) {

        fprintf(stderr, "Usage: %s \n",

                argv[0]);

        exit(EXIT_FAILURE);

    }

 

    if (sem_init(&sem, 0, 0) == -1)

        handle_error("sem_init");

 

    /* 安置 SIGALRM 处理器;使用 argv[1] 设置警告时钟 */

 

    sa.sa_handler = handler;

    sigemptyset(&sa.sa_mask);

    sa.sa_flags = 0;

    if (sigaction(SIGALRM, &sa, NULL) ==-1)

        handle_error("sigaction");

 

    alarm(atoi(argv[1]));

 

    /* 计算相关的时刻,把当前时时加上 argv[2] 指定的秒数 */

    if (clock_gettime(CLOCK_REALTIME, &ts)== -1)

       handle_error("clock_gettime");

    ts.tv_sec += atoi(argv[2]);

    printf("main() about to callsem_timedwait()\n");

    while ((s = sem_timedwait(&sem,&ts)) == -1 && errno == EINTR)

        continue;       /* Restart if interrupted by handler */

    /* 检查发生了什么 */

    if (s == -1) {

        if (errno == ETIMEDOUT)

            printf("sem_timedwait() timedout\n");

        else

            perror("sem_timedwait");

    } else

        printf("sem_timedwait()succeeded\n");

 

    exit((s == 0) ? EXIT_SUCCESS :EXIT_FAILURE);

}

参看

clock_gettime(2), sem_getvalue(3), sem_post(3), sem_overview(7), time(7)


你可能感兴趣的:(linux学习笔记)