NAME
mq_send - 将消息发送到消息队列 (REALTIME)
SYNOPSIS
#include <mqueue.h>
int mq_send(mqd_t mqdes, const char *msg_ptr, size_t msg_len,unsigned msg_prio);
DESCRIPTION
函数 mq_send() 会将参数 msg_ptr 指向的内容发送给参数mqdes 指向的消息队列.
参数 msg_len 指定消息的大小(用字节数表示). 参数 msg_len 的值应该不大于消息队列的属性 mq_msgsize 的值, 否则函数执行失败.
如果指定的消息队列不为空, mq_send() 的操作类似将消息插入在消息队列的指定位置,指定位置是通过参数 msg_prio 来指定.
参数 msg_prio 值大的消息会被插入在参数 msg_prio值小的消息前;如果值相等,则插在后面. 参数 msg_prio 的值应该小于 {MQ_PRIO_MAX}.
如果指定的消息队列满了并且 O_NONBLOCK(mq_open中设置) 未被设置, 函数mq_send() 会阻塞, 一直到消息可以被插入队列或者函数 mq_send() 被信号中断.
如果有几个线程都在等待消息队列的空闲资源向, 在支持优先级调度的系统中, 优先级最高的线程先解除阻塞,如果优先级相同则等待时间最长的线程先解除阻塞;
不支持优先级调度的系统中, 哪一个等待线程解除阻塞是未说明的.
如果指定的消息队列满了并且 O_NONBLOCK被设置了,函数 mq_send() 会失败返回.
PARAMETERS
①mqdes
消息队列的描述符
②msg_ptr
指向消息结构体的指针
③msg_len
消息的字节数, 不能大于 mq_msgsize
④msg_prio
消息的优先级,
优先级大的消息会插队在优先级小的消息前面;
同优先级的消息会插队在后面(时间先后).
RETURN VALUE
如果函数执行成功, 函数返回0
如果函数执行失败,函数返回 -1 并且设置errno,errno的种别详见下面的ERRORS一节.
ERRORS
[EAGAIN]
O_NONBLOCK标志被设置并且消息队列已满.
[EBADF]
参数 mqdes 不是有效的消息队列描述符.
[EINTR]
函数被信号中断.
[EINVAL]
函数已阻塞并且参数 abs_timeout 无效(无效是因为 tv_sec 小于0或者 tv_nsec 小于0或者 tv_nsec大于 10亿(1000 million).
[EMSGSIZE]
参数 msg_len 指定的大小超过了消息队列的消息大小属性.