mq_notify
NAME
mq_notify - 通知进程可以接收一条消息 (REALTIME)
SYNOPSIS
#include <mqueue.h> int mq_notify(mqd_t mqdes, const struct sigevent *notification);
Data Structure
struct sigevent 的详细定义请参见 :http://www.cnblogs.com/LubinLew/p/POSIX-DataStructure.html#sigevent
DESCRIPTION
如果参数 notification 不为空, 这个函数会在调用进程注册一个异步通知函数,通知注册进程 空的消息队列中有消息到达了.
当消息队列从空到非空状态变化时,通知就会发送到注册的进程.
任何时候, 一个消息队列只能被一个进程注册通知. 如果之前调用进程或者其他进程已经注册过了,那么随后调用本函数注册通知会返回失败.
如果参数 notification 是 NULL 并且这个进程之前注册过了通知函数, 那么这个注册会被删除,其他进程就可以在这个消息队列上注册通知.
当一个消息队列从空变成非空,并且这个消息队列被注册了通知,并且一些线程被函数 mq_receive() 或者mq_timedreceive() 阻塞了,
到达的消息会被适当的发送给 mq_receive() 或者 mq_timedreceive() ,不会发送通知(结果就像消息队列仍然是空的).
PARAMETERS
①mqdes [IN]
消息队列的描述符
②notification [IN]
struct sigevent 类型结构体指针，用来注册通知函数，当该参数被设置为NULL时，会取消调用进程之前注册的通知。
详细参数Data Structure 一节
RETURN VALUE
如果函数执行成功, 函数返回0
如果函数执行失败,函数返回 -1 并且设置errno,errno的种别详见下面的ERRORS一节.
ERRORS
[EBADF]
参数 mqdes 不是有效的消息队列描述符.
[EBUSY]
一个进程已经在这个消息队列上注册了通知函数.
[EINVAL]
参数notification 是NULL 并且 当前进程没有注册通知函数.
EXAMPLES
