Linux程序员手册 第2部分
更新日期： 2017-09-15

名称

sigwaitinfo，sigtimedwait，rt_sigtimedwait-同步等待排队的信号

语法

#include <signal.h>

int sigwaitinfo(const sigset_t *set, siginfo_t *info);

int sigtimedwait(const sigset_t *set, siginfo_t *info,
                 const struct timespec *timeout);

glibc的功能测试宏要求(请参阅feature_test_macros(7))：

sigwaitinfo()，sigtimedwait()：_POSIX_C_SOURCE> = 199309L

说明

sigwaitinfo()暂停调用线程的执行，直到set中的信号之一挂起(如果set中的信号之一已经为调用线程挂起，sigwaitinfo()将立即返回。)

sigwaitinfo()从待处理信号集中删除信号，并返回信号编号作为其功能结果。如果info参数不是NULL，则它指向的缓冲区将用于返回siginfo_t类型的结构(请参见sigaction(2))，其中包含有关信号的信息。

如果集合中有多个信号等待调用者处理，则由sigwaitinfo()检索的信号是根据通常的排序规则确定的；有关更多详细信息，请参见signal(7)。

sigtimedwait()的运行方式与sigwaitinfo()完全相同，不同之处在于它具有一个附加参数timeout，该参数指定线程挂起等待信号的间隔。 (此间隔将四舍五入为系统时钟的粒度，并且内核调度延迟意味着该间隔可能会少量溢出。)此参数具有以下类型：

struct timespec {
    long    tv_sec;         /* seconds */
    long    tv_nsec;        /* nanoseconds */
}

如果将此结构的两个字段都指定为0，则将执行轮询：sigtimedwait()立即返回，其中包含有关调用方未决信号的信息，或者如果set中没有信号未决，则返回错误。

返回值

成功时，sigwaitinfo()和sigtimedwait()均返回信号号(即，大于零的值)。失败时，两个调用均返回-1，并设置errno来指示错误。

错误说明

EAGAIN

在sigtimedwait()指定的超时期限内，没有信号置入待处理状态。

EINTR

等待被信号处理程序中断；参见signal(7)。 (此处理程序用于信号而不是集合中的信号之一。)

EINVAL

超时无效。

遵循规范

POSIX.1-2001，POSIX.1-2008。

备注

在正常使用中，调用程序会通过先前对sigprocmask(2)的调用来阻塞设置的信号(因此，如果这些信号在连续调用sigwaitinfo()或sigtimedwait()之间变为挂起状态，则不会发生默认设置)，并且没有为这些信号建立处理程序。在多线程程序中，应在所有线程中阻塞信号，以防止在调用sigwaitinfo()或sigtimedwait()的线程之外的线程中，根据信号的默认配置来处理信号。

给定线程的未决信号集是专门针对该线程的待决信号集与整个进程未决的信号集的总和(请参见signal(7))。

静默忽略等待SIGKILL和SIGSTOP的尝试。

如果一个进程的多个线程被阻塞，等待sigwaitinfo()或sigtimedwait()中的相同信号，那么，如果一个线程整体上正在等待处理，则恰好一个线程实际上会接收到该信号。哪个线程接收信号是不确定的。

sigwaitinfo()或sigtimedwait()不能用于接收同步生成的信号，例如，由于访问无效的内存地址而产生的SIGSEGV信号或由于算术错误而导致的SIGFPE信号。只能通过信号处理程序捕获此类信号。

POSIX未指定sigtimedwait()的timeout参数的NULL值的含义，这使它有可能与sigwaitinfo()的调用具有相同的含义，并且确实是在Linux上完成的。

C library/kernel differences

在Linux上，sigwaitinfo()是在sigtimedwait()之上实现的库函数。

sigwaitinfo()和sigtimedwait()的glibc包装函数默默地忽略了等待NPTL线程实现内部使用的两个实时信号的尝试。有关详细信息，请参见nptl(7)。

最初的Linux系统调用名为sigtimedwait()。但是，在Linux 2.2中添加了实时信号后，该系统调用支持的固定大小的32位sigset_t类型不再适合此目的。因此，添加了新的系统调用rt_sigtimedwait()以支持扩展的sigset_t类型。新的系统调用采用第四个参数size_t sigsetsize，它指定set中信号集的大小(以字节为单位)。当前需要此参数具有sizeof(sigset_t)值(或错误EINVAL结果)。 glibc sigtimedwait()包装函数对我们隐藏了这些细节，在内核提供时透明地调用rt_sigtimedwait()。

另外参见

kill(2)，sigaction(2)，signal(2)，signalfd(2)，sigpending(2)，sigprocmask(2)，sigqueue(3)，sigsetops(3)，sigwait(3)，signal(7)，时间(7)

出版信息

这个页面是Linux手册页项目5.08版的一部分。有关项目的说明、有关报告错误的信息以及此页面的最新版本，请访问https://www.kernel.org/doc/man-pages/。