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