msgsnd/msgrcv系統(tǒng)調(diào)用
Posted on 2008-08-18 19:03 Prayer 閱讀(5593) 評論(0) 編輯 收藏 引用 所屬分類: LINUX/UNIX/AIX在消息隊列上進(jìn)行收發(fā)消息。為了發(fā)送消息,調(diào)用進(jìn)程對消息隊列必須有寫權(quán)能。接收消息時必須有讀權(quán)能。
用法:
#include <sys/types.h>
#include <sys/ipc.h>
#include <sys/msg.h>
int msgsnd(int msqid, const void *msgp, size_t msgsz, int msgflg);
ssize_t msgrcv(int msqid, void *msgp, size_t msgsz, long msgtyp, int msgflg);
參數(shù):
msqid:消息隊列的識別碼。
msgp:指向消息緩沖區(qū)的指針,此位置用來暫時存儲發(fā)送和接收的消息,是一個用戶可定義的通用結(jié)構(gòu),形態(tài)如下
struct msgbuf {
long mtype; /* 消息類型,必須 > 0 */
char mtext[1]; /* 消息文本 */
};
msgsz:消息的大小。
msgtyp:從消息隊列內(nèi)讀取的消息形態(tài)。如果值為零,則表示消息隊列中的所有消息都會被讀取。
msgflg:用來指明核心程序在隊列沒有數(shù)據(jù)的情況下所應(yīng)采取的行動。如果msgflg和常數(shù)IPC_NOWAIT合用,則在msgsnd()執(zhí)行時若是消息隊列已滿,則msgsnd()將不會阻塞,而會立即返回-1,如果執(zhí)行的是msgrcv(),則在消息隊列呈空時,不做等待馬上返回-1,并設(shè)定錯誤碼為ENOMSG。當(dāng)msgflg為0時,msgsnd()及msgrcv()在隊列呈滿或呈空的情形時,采取阻塞等待的處理模式。
返回說明:
成功執(zhí)行時,msgsnd()返回0,msgrcv()返回拷貝到mtext數(shù)組的實際字節(jié)數(shù)。失敗兩者都返回-1,errno被設(shè)為以下的某個值
[對于msgsnd]
EACCES:調(diào)用進(jìn)程在消息隊列上沒有寫權(quán)能,同時沒有CAP_IPC_OWNER權(quán)能
EAGAIN:由于消息隊列的msg_qbytes的限制和msgflg中指定IPC_NOWAIT標(biāo)志,消息不能被發(fā)送
EFAULT:msgp指針指向的內(nèi)存空間不可訪問
EIDRM:消息隊列已被刪除
EINTR:等待消息隊列空間可用時被信號中斷
EINVAL:參數(shù)無效
ENOMEM:系統(tǒng)內(nèi)存不足,無法將msgp指向的消息拷貝進(jìn)來
[對于msgrcv]
E2BIG:消息文本長度大于msgsz,并且msgflg中沒有指定MSG_NOERROR
EACCES:調(diào)用進(jìn)程沒有讀權(quán)能,同時沒具有CAP_IPC_OWNER權(quán)能
EAGAIN:消息隊列為空,并且msgflg中沒有指定IPC_NOWAIT
EFAULT:msgp指向的空間不可訪問
EIDRM:當(dāng)進(jìn)程睡眠等待接收消息時,消息已被刪除
EINTR:當(dāng)進(jìn)程睡眠等待接收消息時,被信號中斷
EINVAL:參數(shù)無效
ENOMSG:msgflg中指定了IPC_NOWAIT,同時所請求類型的消息不存在