分享mq_open函数

uqHZau

7 v1 d  \) Q! w5 hNAME
4 {. l/ a# C1 y5 J- Rmq_open - 打开一个消息队列 (REALTIME)
9 g- @( |- C" v4 W9 z% |( N- n
9 H  Y+ P, P$ e: E& n$ |/ w1 G/ I* V
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
  $ b6 x3 d7 R$ x/ F4 B* c

2 ~; }0 N% H1 t& ~' ?; B
DESCRIPTION

6 u. g5 \" u: T4 u' |  X7 C. Amq_open() 函数会通过一个消息队列描述符(类型是mqd_t)建立一个进程与一个消息队列的连接.

该函数会创建一个打开的消息队列的描述符, 其他函数就可以通过这个描述符操作消息队列.


4 `; c5 G: d5 q1 \4 i% YPARAMETERS

3 t* q! j, B( p3 Q' l  z2 v2 s①name
/ P- W# L& P" m& Y/ X/ K参数 name 是一个指向消息队列名称的指针. 但是名字是否出现在文件系统中,是否对其他以路径名为参数的函数可见是未定义的.

参数 name 的长度限制是由系统实现决定的(如何获取这个限制),不需要遵守路径名的限制 {PATH_MAX} 和 {NAME_MAX}.

5 J0 f  ^: S) s5 H如果 name 参数以"/"字符开头, 只有name没有被删除,所有使用相同name值调用mq_open函数的线程,访问的都是同一个消息队列,

如果 name 参数不是以"/"字符开头,效果是由系统实现决定的.所以name参数一定要以"/"字符开头.
  D( l5 \2 S( f% F# i; l; b
1 K- j" @' A- B) @; i  }* p+ ?$ l, b  }
3 z% l/ r+ k0 z) g  f: C) h②oflag

& T9 A3 m6 ~4 n. S" J, t# i参数 oflag 表示想要访问(receive/send)消息队列的方式.

参数 oflag 是由下列宏组合计算出来的, 注意必须包含前3个(访问模式) 中的一个:
. T6 l& z2 e4 e+ E, ^# C
O_RDONLY (只读)

打开一个消息队列用来接受消息.

调用进程可以使用mq_open返回的描述符用于函数 mq_receive(), 但是不能用于函数 mq_send().
' e. [- @1 t0 f, _  c
一个消息队列可以在相同或不同的进程中多次打开用来接收消息.

O_WRONLY (只写)
' {& L' X; W' x2 S1 }4 z3 g
打开一个消息队列用来发送消息.
4 D2 ^3 z& F, p6 i2 d% C
调用进程可以使用mq_open返回的描述符用于函数 mq_send(), 但是不能用于函数 mq_receive().
  n' J- `$ C* i" ~
  W, k, x  T1 {* L4 ]" u8 _9 [  P$ X一个消息队列可以在相同或不同的进程中多次打开用来发送消息.
5 C' m0 L+ H9 A$ |
& @$ p- d8 z1 k7 pO_RDWR (读写)

打开一个消息队列用即可用来发送消息也可以用来接受消息.

调用进程可以使用任何支持O_RDONLY 和O_WRONLY 访问模式的函数.
6 b1 Z  _4 k& Y) _- q
" c: m% n' c6 R$ E+ a3 s一个消息队列可以在相同或不同的进程中多次打开用来发送消息.


% h! ^/ y9 ]9 K: t% j( {
Any combination of the remaining flags may be specified in the value of oflag:
3 q, f1 v" k7 A1 S( A3 L

O_CREAT (创建)
: n7 l! `" b; n7 M9 b
6 I- S+ w9 h  |. k创建一个消息队列. 使用这个参数需要追加2个参数: ③mode(类型是mode_t), 和④attr(类型是mq_attr*).
如果name参数指定的消息队列已经存在, 那么这个参数将不起任何作用, 除非像下面 O_EXCL 中提到的情况;
否则, 会创建一个空的消息队列. 消息队列的用户ID会被设置成这个进程的实际的用户ID.
% @0 W, }) h: n 消息队列的组ID会被设置成这个进程的实际的组ID; 然而, 如果参数name 指向的消息队列在文件系统中可见, 那么组ID会被设置成包含消息队列的目录的组ID.
& \9 I# q; S% c0 ?0 O如果参数mode中的位与文件权限中位不同,这种情况是未定义的.
如果 attr 是 NULL, 创建的消息队列是系统实现的默认属性. 如果 attr 不是 NULL 并且调用进程对参数name指定的文件有特定的权限(什么权限),
" J* m( S0 r; k  f4 n' j那么消息队列的属性 mq_maxmsg 和 mq_msgsize 会被设置成 attr 中的属性. 属性 mq_flags 和 mq_curmsgs 会被忽略.
如果 attr 不是 NULL , 并且调用进程对参数name指定的文件没有特定的权限,函数 mq_open() 会返回失败,不会创建消息队列.


; n( b7 T1 |" X: P. n' pO_EXCL (既存检查)
, X/ V% ]9 h  w( k" Z/ V
如果 O_EXCL 和O_CREAT同时被设置了, 如果消息队列应经存在,那么函数 mq_open() 会返回失败.
提供了检查消息队列是否存在的方法, 如果设置了 O_EXCL 必须同时设置 O_CREAT 否则结果未定义.
- k7 u. [# v( _% G8 y
7 o) h- B+ I; Q9 x$ L1 bO_NONBLOCK (非阻塞)

8 U: \# c9 ~' \6 A# `! Q决定函数 mq_send() 和 mq_receive() 在获取当前无法获得的资源或消息时,是一直等待(阻塞), 还是返回失败并将 errno 设置成 [EAGAIN];


RETURN VALUE
8 A  c, K# F- ]" ?
# m% h( U' v+ K8 }如果函数执行成功, 函数返回一个描述符
- _; i$ O/ Y7 B1 X8 h6 b
6 x4 Q7 J- Q! _3 c9 v* C如果函数执行失败,函数返回 (mqd_t)-1 并且设置errno,errno的种别详见下面的ERRORS一节.
9 c$ Z& I3 Q& F7 b& ~
, v1 j- W, O" i2 b

; Z& M( j& r8 W# [, TERRORS

* y! d' z# X9 ~! x, E& @7 }[EACCES]
7 s, m8 o9 f" r* I6 Q% Q* N
3 S& d/ i" s0 {* i! kThe 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.

1 m6 J5 L/ G! |8 r% Y5 d1 _% X7 ^[EEXIST]
) {8 B& l0 g$ `: ~- A0 ]; j
5 y1 u( N+ Z& l* F2 xO_CREAT and O_EXCL are set and the named message queue already exists.
/ ]# P' Q1 y3 q% j) x, w
, w9 E" x7 {7 L& U[EINTR]

# l! E1 j# W( _) U& L函数 mq_open() 被信号中断.
9 O' {5 \3 H; i; T) y* m% Q
/ p- R3 @- Q7 i1 Y2 C5 b+ r[EINVAL]

! n7 s  c. {2 D7 t函数 mq_open() 不支持参数name指定的路径.
+ C! q5 \! b" s" D; `! L  S
' U: I. n( o! t9 }! g/ b6 n0 s[EINVAL]

设置了O_CREAT标志, 参数3 attr 不是NULL;并且 mq_maxmsg 或 mq_msgsize 小于等于0.

3 O5 T# E1 r& p- L[EMFILE]

. y# p: g& {+ Q$ |" ?本进程中使用了过多的消息队列描述符 或 文件描述符.
- m' S: Y' M- f5 B& r
[ENFILE]

系统中打开的消息队列数目超过了系统支持的最大数.
1 S% }. _% c1 C- J) w& {
( E, [9 T8 w) }$ U* Z[ENOENT]

没有设置O_CREAT标志,并且指定的消息队列不存在.

) D  d) j* A8 x& a6 S" x[ENOSPC]

7 }/ C, F. \3 f2 C) O) O9 d$ c空间不足,无法创建新的消息队列.
+ ^7 {* O. H7 F, X3 X- y
, g9 C$ a* x: |6 h' W. R0 _[ENAMETOOLONG]
  s0 P$ v! H, I0 J" F' b" l- B! k
, p% Y+ [; U9 ]6 k/ b' l参数 name 的长度超过系统定义的最大长度.
# B5 b" W2 f2 h
在不支持XSI系统中,name 的长度超过了 {_POSIX_PATH_MAX},在支持XSI系统中,name 的长度超过了 {_XOPEN_PATH_MAX};或者

: i9 X9 c7 ~0 l  N. \在不支持XSI系统中,某一级路径的长度超过了 {_POSIX_NAME_MAX},在支持XSI系统中,某一级路径的长度超过了 {_XOPEN_NAME_MAX};

EXAMPLES

SsaaM7

分享mq_open函数