1. 程式人生 > 其它 >linux 訊息佇列

linux 訊息佇列

功能描述:
在訊息佇列上進行收發訊息。為了傳送訊息,呼叫程序對訊息佇列必須有寫權能。接收訊息時必須有讀權能。

 

用法: 
#include
#include
#include

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,同時所請求型別的訊息不存在