Posted on 2008-08-18 19:03
Prayer 閱讀(5613)
評論(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，同時所請求類型的消息不存在