消息隊列函數由msgget、msgctl、msgsnd、msgrcv四個函數組成。下面的表格列出了這四個函數的函數原型及其具體說明。
1. msgget函數原型
|
msgget(得到消息隊列標識符或創建一個消息隊列對象) |
||
|
所需頭文件 |
#include <sys/types.h> #include <sys/ipc.h> #include <sys/msg.h> |
|
|
函數說明 |
得到消息隊列標識符或創建一個消息隊列對象並返回消息隊列標識符 |
|
|
函數原型 |
int msgget(key_t key, int msgflg) |
|
|
函數傳入值 |
key |
0(IPC_PRIVATE)：會建立新的消息隊列 |
|
大於0的32位整數：視參數msgflg來確定操作。通常要求此值來源於ftok返回的IPC鍵值 |
||
|
msgflg |
0：取消息隊列標識符，若不存在則函數會報錯 |
|
|
IPC_CREAT：當msgflg&IPC_CREAT爲真時，如果內核中不存在鍵值與key相等的消息隊列，則新建一個消息隊列；如果存在這樣的消息隊列，返回此消息隊列的標識符 |
||
|
IPC_CREAT|IPC_EXCL：如果內核中不存在鍵值與key相等的消息隊列，則新建一個消息隊列；如果存在這樣的消息隊列則報錯 |
||
|
函數返回值 |
成功：返回消息隊列的標識符 |
|
|
出錯：-1，錯誤原因存於error中 |
||
|
附加說明 |
上述msgflg參數爲模式標誌參數，使用時需要與IPC對象存取權限（如0600）進行|運算來確定消息隊列的存取權限 |
|
|
錯誤代碼 |
EACCES：指定的消息隊列已存在，但調用進程沒有權限訪問它 EEXIST：key指定的消息隊列已存在，而msgflg中同時指定IPC_CREAT和IPC_EXCL標誌 ENOENT：key指定的消息隊列不存在同時msgflg中沒有指定IPC_CREAT標誌 ENOMEM：需要建立消息隊列，但內存不足 ENOSPC：需要建立消息隊列，但已達到系統的限制 |
|
如果用msgget創建了一個新的消息隊列對象時，則msqid_ds結構成員變量的值設置如下：
msg_qnum、msg_lspid、msg_lrpid、 msg_stime、msg_rtime設置爲0。
msg_ctime設置爲當前時間。
msg_qbytes設成系統的限制值。
msgflg的讀寫權限寫入msg_perm.mode中。
msg_perm結構的uid和cuid成員被設置成當前進程的有效用戶ID，gid和cuid成員被設置成當前進程的有效組ID。
2. msgctl函數原型
|
msgctl (獲取和設置消息隊列的屬性) |
||
|
所需頭文件 |
#include <sys/types.h> #include <sys/ipc.h> #include <sys/msg.h> |
|
|
函數說明 |
獲取和設置消息隊列的屬性 |
|
|
函數原型 |
int msgctl(int msqid, int cmd, struct msqid_ds *buf) |
|
|
函數傳入值 |
msqid |
消息隊列標識符 |
|
cmd
|
IPC_STAT:獲得msgid的消息隊列頭數據到buf中 |
|
|
IPC_SET：設置消息隊列的屬性，要設置的屬性需先存儲在buf中，可設置的屬性包括：msg_perm.uid、msg_perm.gid、msg_perm.mode以及msg_qbytes |
||
|
buf：消息隊列管理結構體，請參見消息隊列內核結構說明部分 |
||
|
函數返回值 |
成功：0 |
|
|
出錯：-1，錯誤原因存於error中 |
||
|
錯誤代碼 |
EACCESS：參數cmd爲IPC_STAT，確無權限讀取該消息隊列 EFAULT：參數buf指向無效的內存地址 EIDRM：標識符爲msqid的消息隊列已被刪除 EINVAL：無效的參數cmd或msqid EPERM：參數cmd爲IPC_SET或IPC_RMID，卻無足夠的權限執行 |
|
3. msgsnd函數原型
|
msgsnd (將消息寫入到消息隊列) |
||
|
所需頭文件 |
#include <sys/types.h> #include <sys/ipc.h> #include <sys/msg.h> |
|
|
函數說明 |
將msgp消息寫入到標識符爲msqid的消息隊列 |
|
|
函數原型 |
int msgsnd(int msqid, const void *msgp, size_t msgsz, int msgflg) |
|
|
函數傳入值 |
msqid |
消息隊列標識符 |
|
msgp |
發送給隊列的消息。msgp可以是任何類型的結構體，但第一個字段必須爲long類型，即表明此發送消息的類型，msgrcv根據此接收消息。msgp定義的參照格式如下： struct s_msg{ /*msgp定義的參照格式*/ |
|
|
msgsz |
要發送消息的大小，不含消息類型佔用的4個字節,即mtext的長度 |
|
|
msgflg |
0：當消息隊列滿時，msgsnd將會阻塞，直到消息能寫進消息隊列 |
|
|
IPC_NOWAIT：當消息隊列已滿的時候，msgsnd函數不等待立即返回 |
||
|
IPC_NOERROR：若發送的消息大於size字節，則把該消息截斷，截斷部分將被丟棄，且不通知發送進程。 |
||
|
函數返回值 |
成功：0 |
|
|
出錯：-1，錯誤原因存於error中 |
||
|
錯誤代碼 |
EAGAIN：參數msgflg設爲IPC_NOWAIT，而消息隊列已滿 EIDRM：標識符爲msqid的消息隊列已被刪除 EACCESS：無權限寫入消息隊列 EFAULT：參數msgp指向無效的內存地址 EINTR：隊列已滿而處於等待情況下被信號中斷 EINVAL：無效的參數msqid、msgsz或參數消息類型type小於0 |
|
msgsnd()爲阻塞函數，當消息隊列容量滿或消息個數滿會阻塞。消息隊列已被刪除，則返回EIDRM錯誤；被信號中斷返回E_INTR錯誤。
如果設置IPC_NOWAIT消息隊列滿或個數滿時會返回-1，並且置EAGAIN錯誤。
msgsnd()解除阻塞的條件有以下三個條件：
① 不滿足消息隊列滿或個數滿兩個條件，即消息隊列中有容納該消息的空間。
② msqid代表的消息隊列被刪除。
③ 調用msgsnd函數的進程被信號中斷。
4. msgrcv函數原型
|
msgrcv (從消息隊列讀取消息) |
||
|
所需頭文件 |
#include <sys/types.h> #include <sys/ipc.h> #include <sys/msg.h> |
|
|
函數說明 |
從標識符爲msqid的消息隊列讀取消息並存於msgp中，讀取後把此消息從消息隊列中刪除 |
|
|
函數原型 |
ssize_t msgrcv(int msqid, void *msgp, size_t msgsz, long msgtyp, int msgflg); |
|
|
函數傳入值 |
msqid |
消息隊列標識符 |
|
msgp |
存放消息的結構體，結構體類型要與msgsnd函數發送的類型相同 |
|
|
msgsz |
要接收消息的大小，不含消息類型佔用的4個字節 |
|
|
msgtyp |
0：接收第一個消息 |
|
|
>0：接收類型等於msgtyp的第一個消息 |
||
|
<0：接收類型等於或者小於msgtyp絕對值的第一個消息 |
||
|
msgflg |
0: 阻塞式接收消息，沒有該類型的消息msgrcv函數一直阻塞等待 |
|
|
IPC_NOWAIT：如果沒有返回條件的消息調用立即返回，此時錯誤碼爲ENOMSG |
||
|
IPC_EXCEPT：與msgtype配合使用返回隊列中第一個類型不爲msgtype的消息 |
||
|
IPC_NOERROR：如果隊列中滿足條件的消息內容大於所請求的size字節，則把該消息截斷，截斷部分將被丟棄 |
||
|
函數返回值 |
成功：實際讀取到的消息數據長度 |
|
|
出錯：-1，錯誤原因存於error中 |
||
|
錯誤代碼 |
E2BIG：消息數據長度大於msgsz而msgflag沒有設置IPC_NOERROR EIDRM：標識符爲msqid的消息隊列已被刪除 EACCESS：無權限讀取該消息隊列 EFAULT：參數msgp指向無效的內存地址 ENOMSG：參數msgflg設爲IPC_NOWAIT，而消息隊列中無消息可讀 EINTR：等待讀取隊列內的消息情況下被信號中斷 |
|
msgrcv()解除阻塞的條件有以下三個：
① 消息隊列中有了滿足條件的消息。
② msqid代表的消息隊列被刪除。
③ 調用msgrcv()的進程被信號中斷。
消息隊列使用程序範例
5. 消息隊列控制範例
msgctl.c源代碼如下：
#include <stdio.h>
#include <string.h>
#include <unistd.h>
#include <sys/ipc.h>
#include <sys/msg.h>
#include <error.h>
#define TEXT_SIZE 512
struct msgbuf
{
long mtype ;
char mtext[TEXT_SIZE] ;
} ;
int main(int argc, char **argv)
{
int msqid ;
struct msqid_ds info ;
struct msgbuf buf ;
struct msgbuf buf1 ;
int flag ;
int sendlength, recvlength ;
msqid = msgget( IPC_PRIVATE, 0666 ) ;
if ( msqid < 0 )
{
perror("get ipc_id error") ;
return -1 ;
}
buf.mtype = 1 ;
strcpy(buf.mtext, "happy new year!") ;
sendlength = sizeof(struct msgbuf) - sizeof(long) ;
flag = msgsnd( msqid, &buf, sendlength , 0 ) ;
if ( flag < 0 )
{
perror("send message error") ;
return -1 ;
}
buf.mtype = 3 ;
strcpy(buf.mtext, "good bye!") ;
sendlength = sizeof(struct msgbuf) - sizeof(long) ;
flag = msgsnd( msqid, &buf, sendlength , 0 ) ;
if ( flag < 0 )
{
perror("send message error") ;
return -1 ;
}
flag = msgctl( msqid, IPC_STAT, &info ) ;
if ( flag < 0 )
{
perror("get message status error") ;
return -1 ;
}
printf("uid:%d, gid = %d, cuid = %d, cgid= %d\n" ,
info.msg_perm.uid, info.msg_perm.gid, info.msg_perm.cuid, info.msg_perm.cgid ) ;
printf("read-write:%03o, cbytes = %lu, qnum = %lu, qbytes= %lu\n" ,
info.msg_perm.mode&0777, info.msg_cbytes, info.msg_qnum, info.msg_qbytes ) ;
system("ipcs -q") ;
recvlength = sizeof(struct msgbuf) - sizeof(long) ;
memset(&buf1, 0x00, sizeof(struct msgbuf)) ;
flag = msgrcv( msqid, &buf1, recvlength ,3,0 ) ;
if ( flag < 0 )
{
perror("recv message error") ;
return -1 ;
}
printf("type=%d, message=%s\n", buf1.mtype, buf1.mtext) ;
flag = msgctl( msqid, IPC_RMID,NULL) ;
if ( flag < 0 )
{
perror("rm message queue error") ;
return -1 ;
}
system("ipcs -q") ;
return 0 ;
}
編譯 gcc msgctl.c –o msgctl。
執行 ./msg，執行結果如下:
uid:1008, gid = 1003, cuid = 1008, cgid= 1003
read-write:666, cbytes = 1024, qnum = 2, qbytes= 163840
------ Message Queues --------
key msqid owner perms used-bytes messages
0x00000000 65536 zjkf 666 1024 2
type=3, message=good bye!
------ Message Queues --------
key msqid owner perms used-bytes messages
6. 兩進程通過消息隊列收發消息
（1）發送消息隊列程序
msgsnd.c源代碼如下：
#include <stdio.h>
#include <string.h>
#include <unistd.h>
#include <sys/ipc.h>
#include <sys/msg.h>
#include <time.h>
#define TEXT_SIZE 512
struct msgbuf
{
long mtype ;
int status ;
char time[20] ;
char mtext[TEXT_SIZE] ;
} ;
char *getxtsj()
{
time_t tv ;
struct tm *tmp ;
static char buf[20] ;
tv = time( 0 ) ;
tmp = localtime(&tv) ;
sprintf(buf,"%02d:%02d:%02d",tmp->tm_hour , tmp->tm_min,tmp->tm_sec);
return buf ;
}
int main(int argc, char **argv)
{
int msqid ;
struct msqid_ds info ;
struct msgbuf buf ;
struct msgbuf buf1 ;
int flag ;
int sendlength, recvlength ;
int key ;
key = ftok("msg.tmp", 0x01 ) ;
if ( key < 0 )
{
perror("ftok key error") ;
return -1 ;
}
msqid = msgget( key, 0600|IPC_CREAT ) ;
if ( msqid < 0 )
{
perror("create message queue error") ;
return -1 ;
}
buf.mtype = 1 ;
buf.status = 9 ;
strcpy(buf.time, getxtsj()) ;
strcpy(buf.mtext, "happy new year!") ;
sendlength = sizeof(struct msgbuf) - sizeof(long) ;
flag = msgsnd( msqid, &buf, sendlength , 0 ) ;
if ( flag < 0 )
{
perror("send message error") ;
return -1 ;
}
buf.mtype = 3 ;
buf.status = 9 ;
strcpy(buf.time, getxtsj()) ;
strcpy(buf.mtext, "good bye!") ;
sendlength = sizeof(struct msgbuf) - sizeof(long) ;
flag = msgsnd( msqid, &buf, sendlength , 0 ) ;
if ( flag < 0 )
{
perror("send message error") ;
return -1 ;
}
system("ipcs -q") ;
return 0 ;
}
（2）接收消息隊列程序
msgrcv.c源代碼如下：
#include <stdio.h>
#include <string.h>
#include <unistd.h>
#include <sys/ipc.h>
#include <sys/msg.h>
#define TEXT_SIZE 512
struct msgbuf
{
long mtype ;
int status ;
char time[20] ;
char mtext[TEXT_SIZE] ;
} ;
int main(int argc, char **argv)
{
int msqid ;
struct msqid_ds info ;
struct msgbuf buf1 ;
int flag ;
int recvlength ;
int key ;
int mtype ;
key = ftok("msg.tmp", 0x01 ) ;
if ( key < 0 )
{
perror("ftok key error") ;
return -1 ;
}
msqid = msgget( key, 0 ) ;
if ( msqid < 0 )
{
perror("get ipc_id error") ;
return -1 ;
}
recvlength = sizeof(struct msgbuf) - sizeof(long) ;
memset(&buf1, 0x00, sizeof(struct msgbuf)) ;
mtype = 1 ;
flag = msgrcv( msqid, &buf1, recvlength ,mtype,0 ) ;
if ( flag < 0 )
{
perror("recv message error\n") ;
return -1 ;
}
printf("type=%d,time=%s, message=%s\n", buf1.mtype, buf1.time, buf1.mtext) ;
system("ipcs -q") ;
return 0 ;
}
（3）編譯與執行程序
① 在當前目錄下利用>msg.tmp建立空文件msg.tmp。
② 編譯發送消息隊列程序 gcc msgsnd.c -o msgsnd。
③ 執行./msgsnd，執行結果如下:
----- Message Queues --------
key msqid owner perms used-bytes messages
0x0101436d 294912 zjkf 600 1072 2
④ 編譯接收消息程序 gcc msgrcv.c -o msgrcv
⑤ 執行./msgrcv，執行結果如下:
type=1,time=03:23:16, message=happy new year!
------ Message Queues --------
key msqid owner perms used-bytes messages
0x0101436d 294912 zjkf 600 536 1
⑥ 利用ipcrm -q 294912刪除該消息隊列。因爲消息隊列是隨內核持續存在的，在程序中若不利用msgctl函數或在命令行用ipcrm命令顯式地刪除，該消息隊列就一直存在於系統中。另外信號量和共享內存也是隨內核持續存在的。
摘錄自《深入淺出Linux工具與編程》