1. 创建/获取一个消息队列
#include <fcntl.h> /* For O_* constants */
#include <sys/stat.h> /* For mode constants */
#include <mqueue.h>
mqd_t mq_open(const char *name, int oflag); //专用于打开一个消息队列
mqd_t mq_open(const char *name, int oflag, mode_t mode,
struct mq_attr *attr);
参数:
name: 消息队列名字;
oflag: 与open函数类型, 可以是O_RDONLY, O_WRONLY, O_RDWR, 还可以按位或上O_CREAT, O_EXCL, O_NONBLOCK.
mode: 如果oflag指定了O_CREAT, 需要指定mode参数;
attr: 指定消息队列的属性;
返回值:
成功: 返回消息队列文件描述符;
失败: 返回-1;
注意-Posix IPC名字限制:
1. 必须以”/”开头, 并且后面不能还有”/”, 形如:/file-name;
2. 名字长度不能超过NAME_MAX
3. 链接时:Link with -lrt.
/** System V 消息队列
通过msgget来创建/打开消息队列
int msgget(key_t key, int msgflg);
**/
2. 关闭一个消息队列
int mq_close(mqd_t mqdes); /** System V 消息队列没有类似的该函数调用**/
3. 删除一个消息队列
int mq_unlink(const char *name); /** System V 消息队列 通过msgctl函数, 并将cmd指定为IPC_RMID来实现 int msgctl(int msqid, int cmd, struct msqid_ds *buf); **/
//示例
int main()
{
mqd_t mqid = mq_open("/abc", O_CREAT|O_RDONLY, 0666, NULL);
if (mqid == -1)
err_exit("mq_open error");
cout << "mq_open success" << endl;
mq_close(mqid);
mq_unlink("/abc");
cout << "unlink success" << endl;
}
4. 获取/设置消息队列属性
int mq_getattr(mqd_t mqdes, struct mq_attr *attr);
int mq_setattr(mqd_t mqdes, struct mq_attr *newattr,
struct mq_attr *oldattr);
参数:
newattr: 需要设置的属性
oldattr: 原来的属性
//struct mq_attr结构体说明
struct mq_attr
{
long mq_flags; /* Flags: 0 or O_NONBLOCK */
long mq_maxmsg; /* Max. # of messages on queue: 消息队列能够保存的消息数 */
long mq_msgsize; /* Max. message size (bytes): 消息的最大长度 */
long mq_curmsgs; /* # of messages currently in queue: 消息队列当前保存的消息数 */
};
/** System V 消息队列
通过msgctl函数, 并将cmd指定为IPC_STAT/IPC_SET来实现
int msgctl(int msqid, int cmd, struct msqid_ds *buf);
**/
/** 示例: 获取消息队列的属性
**/
int main(int argc,char **argv)
{
mqd_t mqid = mq_open("/test", O_RDONLY|O_CREAT, 0666, NULL);
if (mqid == -1)
err_exit("mq_open error");
struct mq_attr attr;
if (mq_getattr(mqid, &attr) == -1)
err_exit("mq_getattr error");
cout << "Max messages on queue: " << attr.mq_maxmsg << endl;
cout << "Max message size: " << attr.mq_msgsize << endl;
cout << "current messages: " << attr.mq_curmsgs << endl;
mq_close(mqid);
return 0;
}
5. 发送消息
int mq_send(mqd_t mqdes, const char *msg_ptr,
size_t msg_len, unsigned msg_prio);
参数:
msg_ptr: 指向需要发送的消息的指针
msg_len: 消息长度
msg_prio: 消息的优先级
/** System V 消息队列
通过msgsnd函数来实现消息发送
int msgsnd(int msqid, const void *msgp, size_t msgsz, int msgflg);
**/
/** 示例: 向消息队列中发送消息, prio需要从命令行参数中读取 **/
struct Student
{
char name[36];
int age;
};
int main(int argc,char **argv)
{
if (argc != 2)
err_quit("./send <prio>");
mqd_t mqid = mq_open("/test", O_WRONLY|O_CREAT, 0666, NULL);
if (mqid == -1)
err_exit("mq_open error");
struct Student stu = {"xiaofang", 23};
unsigned prio = atoi(argv[1]);
if (mq_send(mqid, (const char *)&stu, sizeof(stu), prio) == -1)
err_exit("mq_send error");
mq_close(mqid);
return 0;
}
6. 从消息队列中读取消息
ssize_t mq_receive(mqd_t mqdes, char *msg_ptr,
size_t msg_len, unsigned *msg_prio);
参数:
msg_len: 读取的消息的长度, 注意: 此值一定要等于mq_attr::mq_msgsize的值, 该值可以通过mq_getattr获取, 但一般是8192字节 [this must be greater than the mq_msgsize attribute of the queue (see mq_getattr(3)).]
msg_prio: 保存获取的消息的优先级
返回值:
成功: 返回读取的消息的字节数
失败: 返回-1
注意: 读取的永远是消息队列中优先级最高的最早的消息, 如果消息队列为, 如果不指定为非阻塞模式, 则mq_receive会阻塞;
/** System V 消息队列
通过msgrcv函数来实现消息发送的
ssize_t msgrcv(int msqid, void *msgp, size_t msgsz, long msgtyp, int msgflg);
**/
/** 示例: 从消息队列中获取消息 **/
int main(int argc,char **argv)
{
mqd_t mqid = mq_open("/test", O_RDONLY);
if (mqid == -1)
err_exit("mq_open error");
struct Student buf;
int nrcv;
unsigned prio;
struct mq_attr attr;
if (mq_getattr(mqid, &attr) == -1)
err_exit("mq_getattr error");
if ((nrcv = mq_receive(mqid, (char *)&buf, attr.mq_msgsize, &prio)) == -1)
err_exit("mq_receive error");
cout << "receive " << nrcv << " bytes, priority: " << prio << ", name: "
<< buf.name << ", age: " << buf.age << endl;
mq_close(mqid);
return 0;
}
7. 建立/删除消息到达通知事件
int mq_notify(mqd_t mqdes, const struct sigevent *sevp);
参数sevp:
NULL: 表示撤销已注册通知;
非空: 表示当消息到达且消息队列当前为空, 那么将得到通知;
通知方式:
1. 产生一个信号, 需要自己绑定
2. 创建一个线程, 执行指定的函数
注意: 这种注册的方式只是在消息队列从空到非空时才产生消息通知事件, 而且这种注册方式是一次性的!
//sigevent结构体
struct sigevent
{
int sigev_notify; /* Notification method */
int sigev_signo; /* Notification signal */
union sigval sigev_value; /* Data passed with notification */
void (*sigev_notify_function) (union sigval); /* Function used for thread notification (SIGEV_THREAD) */
void *sigev_notify_attributes; /* Attributes for notification thread (SIGEV_THREAD) */
pid_t sigev_notify_thread_id; /* ID of thread to signal (SIGEV_THREAD_ID) */
};
union sigval /* Data passed with notification */
{
int sival_int; /* Integer value */
void *sival_ptr; /* Pointer value */
};
sigev_notify代表通知的方式: 一般常用两种取值:SIGEV_SIGNAL, 以信号方式通知; SIGEV_THREAD, 以线程方式通知
如果以信号方式通知: 则需要设定一下两个参数:
sigev_signo: 信号的代码
sigev_value: 信号的附加数据(实时信号)
如果以线程方式通知: 则需要设定以下两个参数:
sigev_notify_function
sigev_notify_attributes
/** Posix IPC所特有的功能, System V没有 **/
/**示例: 将下面程序多运行几遍, 尤其是当消息队列”从空->非空”, 多次”从空->非空”, 当消息队列不空时运行该程序时, 观察该程序的状态;
**/
mqd_t mqid;
long size;
void sigHandlerForUSR1(int signo)
{
//将数据的读取转移到对信号SIGUSR1的响应函数中来
struct Student buf;
int nrcv;
unsigned prio;
if ((nrcv = mq_receive(mqid, (char *)&buf, size, &prio)) == -1)
err_exit("mq_receive error");
cout << "receive " << nrcv << " bytes, priority: " << prio << ", name: "
<< buf.name << ", age: " << buf.age << endl;
}
int main(int argc,char **argv)
{
// 安装信号响应函数
if (signal(SIGUSR1, sigHandlerForUSR1) == SIG_ERR)
err_exit("signal error");
mqid = mq_open("/test", O_RDONLY);
if (mqid == -1)
err_exit("mq_open error");
// 获取消息的最大长度
struct mq_attr attr;
if (mq_getattr(mqid, &attr) == -1)
err_exit("mq_getattr error");
size = attr.mq_msgsize;
// 注册消息到达通知事件
struct sigevent event;
event.sigev_notify = SIGEV_SIGNAL; //指定以信号方式通知
event.sigev_signo = SIGUSR1; //指定以SIGUSR1通知
if (mq_notify(mqid, &event) == -1)
err_exit("mq_notify error");
//死循环, 等待信号到来
while (true)
pause();
mq_close(mqid);
return 0;
}
/** 示例:多次注册notify, 这样就能过多次接收消息, 但是还是不能从队列非空的时候进行接收, 将程序改造如下:
**/
mqd_t mqid;
long size;
struct sigevent event;
void sigHandlerForUSR1(int signo)
{
// 注意: 是在消息被读走之前进行注册,
// 不然该程序就感应不到消息队列"从空->非空"的一个过程变化了
if (mq_notify(mqid, &event) == -1)
err_exit("mq_notify error");
//将数据的读取转移到对信号SIGUSR1的响应函数中来
struct Student buf;
int nrcv;
unsigned prio;
if ((nrcv = mq_receive(mqid, (char *)&buf, size, &prio)) == -1)
err_exit("mq_receive error");
cout << "receive " << nrcv << " bytes, priority: " << prio << ", name: "
<< buf.name << ", age: " << buf.age << endl;
}
int main(int argc,char **argv)
{
// 安装信号响应函数
if (signal(SIGUSR1, sigHandlerForUSR1) == SIG_ERR)
err_exit("signal error");
mqid = mq_open("/test", O_RDONLY);
if (mqid == -1)
err_exit("mq_open error");
// 获取消息的最大长度
struct mq_attr attr;
if (mq_getattr(mqid, &attr) == -1)
err_exit("mq_getattr error");
size = attr.mq_msgsize;
// 注册消息到达通知事件
event.sigev_notify = SIGEV_SIGNAL; //指定以信号方式通知
event.sigev_signo = SIGUSR1; //指定以SIGUSR1通知
if (mq_notify(mqid, &event) == -1)
err_exit("mq_notify error");
//死循环, 等待信号到来
while (true)
pause();
mq_close(mqid);
return 0;
}
mq_notify 注意点总结:
1. 任何时刻只能有一个进程可以被注册为接收某个给定队列的通知;
2. 当有一个消息到达某个先前为空的队列, 而且已有一个进程被注册为接收该队列的通知时, 只有没有任何线程阻塞在该队列的mq_receive调用的前提下, 通知才会发出;
3. 当通知被发送给它的注册进程时, 该进程的注册被撤销. 进程必须再次调用mq_notify以重新注册(如果需要的话),但是要注意: 重新注册要放在从消息队列读出消息之前而不是之后(如同示例程序);
附-查看已经成功创建的Posix消息队列
#其存在与一个虚拟文件系统中, 需要将其挂载到系统中才能查看
Mounting the message queue filesystem On Linux, message queues are created in a virtual filesystem.
(Other implementations may also provide such a feature, but the details are likely to differ.) This
file system can be mounted (by the superuser, 注意是使用root用户才能成功) using the following commands:
mkdir /dev/mqueue
mount -t mqueue none /dev/mqueue
还可以使用cat查看该消息队列的状态, rm删除:
cat /dev/mqueue/abc
rm abc
还可umount该文件系统
umount /dev/mqueue
附-Makefile
.PHONY: clean all CC = g++ CPPFLAGS = -Wall -g BIN = main SOURCES = $(BIN.=.cpp) all: $(BIN) %.o: %.c $(CC) $(CPPFLAGS) -c $^ -o $@ main: main.o $(CC) $(CPPFLAGS) $^ -lrt -o $@ clean: -rm -rf $(BIN) *.o bin/ obj/ core