POSIX 消息队列 之 参数说明
消息队列
一、函数
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);
函数功能
为指定队列建立或删除异步事件通知。
参数
在<signal.h>中:
union
signal
{
int
sival_int;
/*整数值*/
void
*sival_ptr;
/*指针值*/
};
struct
sigevent
{
int
sigev_notify;
/*通知类型:SIGEV_NONE、SIGEV_SIGNAL、SIGEV_THREAD*/
int
sigev_signo;
/*信号值*/
union
sigval sigev_value;
/*传递给信号处理函数或线程的信号值*/
void
(*sigev_notify_function)(
union
sigval);
/*线程处理函数*/
pthread_attr_t *sigev_notify_attributes;
/*线程属性*/
};
(1).如果notification参数非空,那么当前进程希望在有一个消息到达所指定的先前为空的队列时得到通知。我们说“该进程被注册为接收该队列的通知”。
(2).如果notification参数为空指针,而且当前进程目前被注册为接收所指定队列的通知,那么已存在的注册将被撤销。
(3).任意时刻只有一个进程可以被注册为接收某个指定队列的通知。
(4).当有一个消息到达某个先前为空的队列,而且已有一个进程被注册为接收该队列的通知时,只有在没有任何线程阻塞在该队列的mq_receive调用中的前提下,通知才会发出。这就是说,在mq_receive调用中的阻塞比任何通知的注册都优先。
(5).当该通知被发送给它的注册进程时,其注册即被撤销。该进程必须再次调用mq_notify重新注册(如果想要的话)。
返回值
成功返回0,失败返回-1。
二、程序举例
mqsend.c
#include<stdio.h>
#include<stdlib.h>
#include<sys/types.h>
#include<mqueue.h>
#include<sys/stat.h>
#include<string.h>
#include<unistd.h>
#include<fcntl.h>
int main(int argc, char **argv)
{
mqd_t mqd;
char *ptr;
size_t len;
unsigned int prio;
if(argc != 4)
perror("./mqsend mqueue_name size prio!\n");
len = atoi(argv[2]);
prio = atoi(argv[3]);
mqd = mq_open(argv[1], O_WRONLY);
ptr = (char *)calloc(len, sizeof(char));
strcpy(ptr, "wjj_xyd");
mq_send(mqd, ptr, len, prio);
exit(0);
}
mqreceive.c
#include<stdio.h>
#include<stdlib.h>
#include<mqueue.h>
#include<sys/types.h>
#include<sys/stat.h>
#include<unistd.h>
int main(int argc, char **argv)
{
int c, flags;
mqd_t mqd;
ssize_t n;
unsigned int prio;
char *buff;
struct mq_attr attr;
flags = O_RDONLY;
while((c = getopt(argc,argv, "n")) != -1)
{
switch(c){
case 'n':flags |= O_NONBLOCK;
break;
}
}
if(optind != argc - 1)
perror("mqreceive error!\n");
mqd = mq_open(argv[optind], flags);
mq_getattr(mqd, &attr);
buff = (char*)malloc(attr.mq_msgsize);
n = mq_receive(mqd, buff, attr.mq_msgsize, &prio);
printf("buff = %s, read %ld bytes, priority = %u\n",buff, (long)n, prio);
exit(0);
}
异步通知事件:
#include <stdio.h>
#include <stdlib.h>
#include <mqueue.h>
#include <sys/types.h>
#include <sys/stat.h>
#include <unistd.h>
#include <fcntl.h>
#include <errno.h>
#include <signal.h>
mqd_t mqd;
struct
mq_attr attr;
struct
sigevent sigev;
char
*ptr;
unsigned
int
prio;
size_t
n;
int
rc;
void
sig_usr1(
int
signo);
/*读取某消息队列,消息队列名通过参数传递*/
/*当有消息放置到某个空的队列中时产生SIGUSR1信号*/
int
main(
int
argc,
char
*argv[])
{
if
(argc != 2)
{
printf
(
"Usage: mqnotifysig1 <name>\n"
);
exit
(1);
}
/*只读模式打开消息队列*/
mqd = mq_open(argv[1], O_RDONLY);
if
(mqd < 0)
{
perror
(
"打开消息队列失败"
);
exit
(1);
}
// 取得消息队列属性,根据mq_msgsize动态申请内存
rc = mq_getattr(mqd, &attr);
if
(rc < 0)
{
perror
(
"取得消息队列属性失败"
);
exit
(1);
}
/*动态申请保证能存放单条消息的内存*/
ptr =
calloc
(attr.mq_msgsize,
sizeof
(
char
));
if
(NULL == ptr)
{
printf
(
"动态申请内存失败\n"
);
mq_close(mqd);
exit
(1);
}
//注册信号函数
signal
(SIGUSR1, sig_usr1);
sigev.sigev_notify = SIGEV_SIGNAL;
sigev.sigev_signo = SIGUSR1;
//注册通知
rc = mq_notify(mqd, &sigev);
// 读取前需要再次注册
if
(rc < 0)
{
perror
(
"通知注册失败"
);
mq_close(mqd);
free
(ptr);
exit
(1);
}
for
(;;)
{
pause();
}
return
0;
}
void
sig_usr1(
int
signo)
{
rc = mq_notify(mqd, &sigev);
// 读取前需要再次注册
if
(rc < 0)
{
perror
(
"通知注册失败"
);
mq_close(mqd);
free
(ptr);
exit
(1);
}
/*接收一条消息*/
n = mq_receive(mqd, ptr, attr.mq_msgsize, &prio);
if
(n < 0)
{
perror
(
"读取失败"
);
mq_close(mqd);
free
(ptr);
exit
(1);
}
printf
(
"读取 %ld 字节\n优先级为 %u\n"
, (
long
)n, prio);
}
相关文章
- C# 消息队列
- 利用加锁或消息队列,数据一致性处理
- RabbitMQ消息队列+安装+工具介绍
- Redis 实现消息队列 MQ
- 线程安全使用(四) [.NET] 简单接入微信公众号开发:实现自动回复 [C#]C#中字符串的操作 自行实现比dotcore/dotnet更方便更高性能的对象二进制序列化 自已动手做高性能消息队列 自行实现高性能MVC WebAPI 面试题随笔 字符串反转
- python (高级消息队列)普通、进程、进程池的消息队列
- PHP+RabbitMQ消息队列的配置和使用方法【MQ】
- laravel5.6 基于redis,使用消息队列(邮件推送)
- 国内首个分布式消息队列技术标准发布,推动云原生中间件技术落地
- 当下最好的消息,莫过于我拿到了25K的offer
- Redis——关于redis5.0的stream消息队列的命令的使用
- 一文理解Kafka如何消息不丢失
- WindowsAPI-获得当前活动窗口(运行自身消息循环的窗体)的句柄
- windows消息机制-4(MFC)
- windows消息机制深入详解-1
- 【Business Touch Kit】服务号消息发送接口返回401如何解决?
- 《微软云计算Windows Azure开发与部署权威指南》——6.9 AppFabric消息缓冲区:云端上的信息暂存区
- 使用消息队列的理由
- printk函数打开和关闭消息
- 消息总线VS消息队列
- 消息队列-RabbitMQ的交换机和队列配置
- 为什么要消息认证码
- 几百万消息在消息队列里积压了几个小时
- java JMS消息队列
- springboot+rocketmq(3):实现广播消息
- Java开发 - 消息队列之Kafka初体验
- MQTT协议-发布消息(服务器向客户端发送)
- 零基础入门快速掌握RocketMQ,从安装、搭建、使用,SpringBoot+RocketMQ构建消息队列的使用,包含RocketMQ全套详细资料,包含所需安装文件、后台监控程序、源码、详细使用资料等
- 消息队列技术选型(Kafka + RocketMQ)