posix线程编程

八、Posix消息队列

2011-09-14 19:07:09| 分类： Unix网络编程 |举报 |字号 订阅

消息队列
一、函数
mq_open
头文件

mqueue.h；

原型

mqd_t mq_open(const char name, int oflag, …/*mode_t mode,struct mq_attr attr*/);

函数功能

创建消息队列；

参数

name ：消息队列的名字，根据消息队列的规则，为了更好的可移植性，该名字必须以‘／’开头，创建一个消息队列的时候无须路径，给出名字就好，其存放位置可有自己指定(创建前后都可以)。

oflag：O_RDONLY（只读） O_WRONLY（只写） O_RDWR（可读可写） O_CREAT（创建） O_EXCL （当消息已存在时，返回EEXIST错误到errno中）O_NONBLOCK（设置非阻塞）

mode：在oflag中指定O_CREAT时，此参数是需要的。表示创建消息队列的权限，S_IRUSR,S_IWUSR,S_IXUSR,S_IRGRP,S_IWGRP,S_IXGRP,S_IROTH,S_IWOTH,S_IXOTH相或组成或者写成0777(表示rwxrwxrwx)等用八进制表示也可以。

attr：在oflag中指定O_CREAT时，此参数是需要的。存放消息队列的属性。其中mq_flags为0，表示阻塞，为O_NONBLOCK为非阻塞。

(这里可以填写哪些参数具体看：二、Posix IPC)

返回值

若创建成功则返回消息队列的描述符，否则返回－1。

mq_close函数
头文件

mqueue.h
原型

int mq_close(mqd_t mqdes);
函数功能

关闭已打开的消息队列，关闭后调用进程不可以再使用该描述符，但其消息队列并没有被删除。一个进程终止时，它的所有打开着的消息队列都关闭，就像调用了mq_close一样。
参数

mqdes 消息队列的描述符，即消息队列创建成功后的返回值。
返回值

成功返回0，失败返回-1。

mq_unlink
头文件

mqueue.h
原型

int mq_unlink(const char *name);
函数功能

从系统中删除名为name的消息队列，但删除的只是我们可以在系统中看见的文件的名字，但文件本身并没有被从磁盘上删除，除非该名称是文件的最后一个链接，并且该文件已关闭，才会将该文件真正从磁盘上删除。即如果某前该详细队列的文件还在其他进程中打开，那么不会将其从磁盘上删除，又或者这是最后一个链接，但它还为关闭，即未执行ma_close操作，或打开它的进程为结束就执行mq_unlink，它也不会从磁盘上删除。
参数

name消息队列的名称，以‘／’开始。
返回值

成功返回0，出错返回－1。

mq_getattr
头文件

mqueue.h
原型

int mq_getattr(mqd_t mqdes, struct mq_attr *attr);
函数功能

获取mqdes指的消息队列的属性，存放到attr结构体中。

struct mq_attr

{

long int mq_flags; /* Message queue flags：0，O_NONBLOCK */

long int mq_maxmsg; /* Maximum number of messages. */

long int mq_msgsize; /* Maximum message size. */

long int mq_curmsgs; /* Number of messages currently queued. */

long int __pad[4];

};
参数

mqdes为消息队列描述符，attr为上面解释的存放消息队列属性的结构体。
返回值

成功返回0，失败返回－1。

mq_setattr
头文件

mqueue.h
原型

int mq_setattr(mqd_t mqdes, const struct mq_attr *attr,

struct mq_attr *oattr);
函数功能

设置消息队列的属性，但是只使用attr结构体中的mq_flags属性，以设置(O_NONBLOCK)或清除(0)非阻塞标志。该结构体的另外三个属性被忽略，每个队列的最大消息数和每个消息的最大字节数都只能在创建时设置，当前队列中的消息数是随传送消息和读取消息的操作改变的，只能读取不能设置。如果oattr非空，那么指定队列的先前属性(4个)全将返回到由该指针指向的结构体中。
参数

mqdes 消息队列的属性

attr 函数功能解释中

oattr 函数功能解释中
返回值

成功返回0，失败返回－1。

mq_send
头文件

mqueue.h
原型

int mq_send(mqd_t mqdes, const char *ptr, size_t len,

unsigned int prio);
函数功能

给描述符mqdes指向的消息队列发送消息，大小为len，内容存放在ptr中，prio为优先级。
参数

mqdes为要发送消息的消息队列描述符;

ptr为要发送的数据;

len为消息的长度;

prio为消息的优先级;
返回值

成功返回0，失败返回－1。

mq_receive
头文件

mqueue.h
原型

ssize_t mq_receive(mqd_t mqdes, char *ptr, size_t len,

unsigned int *proip);
函数功能

从描述符mqdes指向的消息队列中读取消息存放ptr中。
参数

mqdes为要从中读取消息的消息队列的描述符;

ptr为存放接受到的消息的指针;

len为接受的最大长度;

该值不能小于能加到该消息对列上的最大大小，如果len小于该值，就立即返回EMSGSIZE错误。
返回值

成功返回读取消息的内容的字节数，出错返回－1。

mq_notify
头文件

mqueue.h;

signal.h;
原型

int mq_notify(mqd_t mqdes, const struct sigevent *notification);
函数功能

为指定队列建立或删除异步事件通知。
参数

在

include

include

include

include

include

include

include

include

include

include

include

include

include

include