NAME
mq_open - 打开一个消息队列 (REALTIME)
SYNOPSIS
#include <mqueue.h>
mqd_t mq_open(const char *name, int oflag, ...)
mqd_t mq_open(const char *name, int oflag, mode_t mode, mq_attr* attr) //O_CREAT
DESCRIPTION
mq_open() 函数会通过一个消息队列描述符(类型是mqd_t)建立一个进程与一个消息队列的连接.
该函数会创建一个打开的消息队列的描述符, 其他函数就可以通过这个描述符操作消息队列.
PARAMETERS
①name
参数 name 是一个指向消息队列名称的指针. 但是名字是否出现在文件系统中,是否对其他以路径名为参数的函数可见是未定义的.
参数 name 的长度限制是由系统实现决定的(如何获取这个限制),不需要遵守路径名的限制 {PATH_MAX} 和 {NAME_MAX}.
如果 name 参数以"/"字符开头, 只有name没有被删除,所有使用相同name值调用mq_open函数的线程,访问的都是同一个消息队列,
如果 name 参数不是以"/"字符开头,效果是由系统实现决定的.所以name参数一定要以"/"字符开头.
②oflag
参数 oflag 表示想要访问(receive/send)消息队列的方式.
参数 oflag 是由下列宏组合计算出来的, 注意必须包含前3个(访问模式) 中的一个:
O_RDONLY (只读)
打开一个消息队列用来接受消息.
调用进程可以使用mq_open返回的描述符用于函数 mq_receive(), 但是不能用于函数 mq_send().
一个消息队列可以在相同或不同的进程中多次打开用来接收消息.
O_WRONLY (只写)
打开一个消息队列用来发送消息.
调用进程可以使用mq_open返回的描述符用于函数 mq_send(), 但是不能用于函数 mq_receive().
一个消息队列可以在相同或不同的进程中多次打开用来发送消息.
O_RDWR (读写)
打开一个消息队列用即可用来发送消息也可以用来接受消息.
调用进程可以使用任何支持O_RDONLY 和O_WRONLY 访问模式的函数.
一个消息队列可以在相同或不同的进程中多次打开用来发送消息.
Any combination of the remaining flags may be specified in the value of oflag:
O_CREAT (创建)
- 创建一个消息队列. 使用这个参数需要追加2个参数: ③ mode(类型是mode_t ), 和 ④attr(类型是mq_attr*).
- 如果name参数指定的消息队列已经存在, 那么这个参数将不起任何作用, 除非像下面 O_EXCL 中提到的情况;
- 否则, 会创建一个空的消息队列. 消息队列的用户ID会被设置成这个进程的实际的用户ID.
- 消息队列的组ID会被设置成这个进程的实际的组ID; 然而, 如果参数 name 指向的消息队列在文件系统中可见, 那么组ID会被设置成包含消息队列的目录的组ID.
- 如果参数mode中的位与文件权限中位不同,这种情况是未定义的.
- 如果 attr 是 NULL, 创建的消息队列是系统实现的默认属性. 如果 attr 不是 NULL 并且调用进程对参数name指定的文件有特定的权限 (什么权限),
- 那么消息队列的属性 mq_maxmsg 和 mq_msgsize 会被设置成 attr 中的属性. 属性 mq_flags 和 mq_curmsgs 会被忽略.
- 如果 attr 不是 NULL , 并且调用进程对参数name指定的文件没有特定的权限,函数 mq_open() 会返回失败,不会创建消息队列.
O_EXCL (既存检查)
- 如果 O_EXCL 和O_CREAT同时被设置了, 如果消息队列应经存在,那么函数 mq_open() 会返回失败.
- 提供了检查消息队列是否存在的方法, 如果设置了 O_EXCL 必须同时设置 O_CREAT 否则结果未定义.
O_NONBLOCK (非阻塞)
- 决定函数 mq_send() 和 mq_receive() 在获取当前无法获得的资源或消息时,是一直等待(阻塞), 还是返回失败并将 errno 设置成 [EAGAIN];
RETURN VALUE
如果函数执行成功, 函数返回一个描述符
如果函数执行失败,函数返回 (mqd_t)-1 并且设置errno,errno的种别详见下面的ERRORS一节.
ERRORS
[EACCES]
The message queue exists and the permissions specified by oflag are denied, or the message queue does not exist and permission to create the message queue is denied.
[EEXIST]
O_CREAT and O_EXCL are set and the named message queue already exists.
[EINTR]
函数 mq_open() 被信号中断.
[EINVAL]
函数 mq_open() 不支持参数name指定的路径.
[EINVAL]
设置了O_CREAT标志, 参数3 attr 不是NULL;并且 mq_maxmsg 或 mq_msgsize 小于等于0.
[EMFILE]
本进程中使用了过多的消息队列描述符 或 文件描述符.
[ENFILE]
系统中打开的消息队列数目超过了系统支持的最大数.
[ENOENT]
没有设置O_CREAT标志,并且指定的消息队列不存在.
[ENOSPC]
空间不足,无法创建新的消息队列.
[ENAMETOOLONG]
参数 name 的长度超过系统定义的最大长度.
在不支持XSI系统中,name 的长度超过了 {_POSIX_PATH_MAX},在支持XSI系统中,name 的长度超过了 {_XOPEN_PATH_MAX};或者
在不支持XSI系统中,某一级路径的长度超过了 {_POSIX_NAME_MAX},在支持XSI系统中,某一级路径的长度超过了 {_XOPEN_NAME_MAX};
EXAMPLES