【linux C】sigevent结构体

NAME

   sigevent - 与异步通知控制相关的结构体。

SYNOPSIS

   #include <signal.h>

   union sigval { 
       int     sival_int;
       void   *sival_ptr;
   };

   struct sigevent {
       int          sigev_notify; /* 通知方式 */
       int          sigev_signo;  /* 通知信号 */
       union sigval sigev_value;  /* 伴随通知所传递的数据 */
       void       (*sigev_notify_function) (union sigval);
                        /* 通知方式设置为"线程通知" (SIGEV_THREAD)时新线程的线程函数 */
       void        *sigev_notify_attributes;
                        /* 通知方式设置为"线程通知" (SIGEV_THREAD)时新线程的属性 */
       pid_t        sigev_notify_thread_id;
                        /* 通知方式为SIGEV_THREAD_ID时，接收信号的线程的pid */
   };

DESCRIPTION

sigevent结构被各种API用来描述通知进程事件的方式(例如，异步请求的完成、计时器的过期或消息的到达)。SYNOPSIS中显示的定义是对sigevent结构中的一些字段的大致描绘（并不是严格地表述），那些字段有些有可能被定义为联合体，所以编程时应该只使用那些与sigev_notify中指定的值相关的字段。比如，sigev_notify设置为SIGEV_SIGNAL，那就不要对sigev_notify_function、sigev_notify_attributes进行赋值了。

sigev_notify字段定义了通知的方式，可取的值有以下几种：

• SIGEV_NONE：不通知。当事件发生时不做任何操作。
• SIGEV_SIGNAL：通过发送sigev_signo所指定的信号的方式通知进程事件(比如定时器到期)已经发生。如果这个信号被由指定了flagSA_SIGINFO的sigaction(2)注册的信号处理函数所捕获，信号处理函数的参数siginfo_t的以下三个字段会被填充为：
  si_code 该字段取决于产生通知事件的API。比如，这个信号是被posix timer定时器到期所产生的，那么就会被设置为SI_TIMER。
  si_signo 该字段被设置为信号值（即sigevent结构体中sigev_signo所指定的值）
  si_value 该字段被设置为sigevent结构体中sigev_value的值。
  其他siginfo_t字段也可能会由于API的不同而被设置。
  sigwaitinfo(2)接口也是可以获取到上述各个字段的信息的。
• SIGEV_THREAD：通过调用sigev_notify_function的方式通知进程事件(比如定时器到期)已经发生，就“好像”它是一个新开启的线程一样。（这里的实现可能包括:每个计时器通知都可能导致创建一个新线程，或者创建一个线程来接收所有通知。）调用函数时，sigev_value是它的唯一参数。如果sigev_notify_attributes不是NULL，它应该指向一个pthread_attr_t结构体，该结构体定义了新线程的属性
• SIGEV_THREAD_ID（linux特有）：目前只被posix timer使用，详见timer_create(2)

SEE ALSO

timer_create(2), aio_fsync(3), aio_read(3), aio_write(3), getaddrinfo_a(3), lio_listio(3), mq_notify(3), aio(7), pthreads(7)