For the complete documentation index, see llms.txt. This page is also available as Markdown.

mq_send(2)

mq_send — 向消息队列发送消息(REALTIME)

名称

mq_send, mq_timedsend

库

Lb librt

概要

#include <mqueue.h>

int
mq_send(mqd_t mqdes, const char *msg_ptr, size_t msg_len,
    unsigned msg_prio);

int
mq_timedsend(mqd_t mqdes, const char *msg_ptr, size_t msg_len,
    unsigned msg_prio, const struct timespec *abs_timeout);

描述

mq_send() 系统调用将参数 msg_ptr 所指向的消息添加到由 mqdes 指定的消息队列中。msg_len 参数指定 msg_ptr 所指向消息的长度(以字节为单位)。msg_len 的值应小于或等于消息队列的 mq_msgsize 属性,否则 mq_send() 将失败。

如果指定的消息队列未满,mq_send() 会将消息插入到消息队列中由 msg_prio 参数指示的位置。msg_prio 数值较大的消息会插入到 msg_prio 值较小的消息之前。消息会插入到队列中具有相同 msg_prio 的其他消息(如果有)之后。msg_prio 的值应小于 {MQ_PRIO_MAX}。

如果指定的消息队列已满,且与 mqdes 关联的消息队列描述中未设置 O_NONBLOCK,mq_send() 将阻塞,直到有空间可用于将消息入队,或者 mq_send() 被信号中断。如果有多个线程在等待发送,而消息队列中变为可用空间,且支持优先级调度选项,则等待时间最长且优先级最高的线程将被解除阻塞以发送其消息。否则,未指定哪个等待线程被解除阻塞。如果指定的消息队列已满,且与 mqdes 关联的消息队列描述中设置了 O_NONBLOCK,则消息不会入队,mq_send() 将返回错误。

mq_timedsend() 系统调用按为 mq_send() 系统调用定义的方式,将消息添加到由 mqdes 指定的消息队列中。但是,如果指定的消息队列已满,且与 mqdes 关联的消息队列描述中未设置 O_NONBLOCK,则当指定的超时到期时,等待队列中有足够空间的操作将被终止。如果消息队列描述中设置了 O_NONBLOCK,此系统调用等价于 mq_send()。

当 abs_timeout 所指定的绝对时间过去时(以超时所基于的时钟来衡量,即当该时钟的值等于或超过 abs_timeout 时),或者在调用时 abs_timeout 所指定的绝对时间已经过去时,超时将到期。

超时基于 CLOCK_REALTIME 时钟。

返回值

成功完成时,mq_send() 和 mq_timedsend() 系统调用返回零。否则,不会入队任何消息,系统调用返回 -1,并设置全局变量 errno 以指示错误。

错误

mq_send() 和 mq_timedsend() 系统调用在以下情况下会失败:

[EAGAIN] 与 mqdes 关联的消息队列描述中设置了 O_NONBLOCK 标志,且指定的消息队列已满。

[EBADF] mqdes 参数不是为写入打开的有效消息队列描述符。

[EINTR] 信号中断了对 mq_send() 或 mq_timedsend() 的调用。

[EINVAL] msg_prio 的值超出有效范围。

[EINVAL] 进程或线程本应阻塞,且 abs_timeout 参数指定的纳秒字段值小于零或大于等于 10 亿。

[EMSGSIZE] 指定的消息长度 msg_len 超过了消息队列的消息大小属性。

[ETIMEDOUT] 打开消息队列时未设置 O_NONBLOCK 标志,但在消息能被添加到队列之前超时已到期。

参见

mq_open(2), mq_receive(2), mq_setattr(2), mq_timedreceive(2)

标准

mq_send() 和 mq_timedsend() 系统调用遵循 IEEE Std 1003.1-2004 ("POSIX.1")。

历史

对 POSIX 消息队列的支持首次出现于 FreeBSD 7.0。

版权

本文部分内容转载并复制自 IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group。如果本版本与原始 IEEE 及 The Open Group 标准之间存在任何差异,以原始 IEEE 及 The Open Group 标准为准。原始标准可在线获取:http://www.opengroup.org/unix/online.html。

最后更新于

这有帮助吗?