System V 訊息佇列 (Message Queue) 允許進程間以結構化訊息交換資料。本文系統整理四大核心系統呼叫 msgget、msgsnd、msgrcv、msgctl 的原型、旗標、返回值、錯誤碼,並提供開啟/建立、發送、接收 (含類型過濾)、偵測、屬性控制的 C 語言封裝函數範例。
struct msgbuf {
long mtype; // 訊息類型 (>0),接收時可過濾
char mtext[1]; // 彈性陣列,實際大小由 msgsz 決定
};
// 自訂結構範例
struct mymsgbuf {
long mtype;
char data[256];
int seq;
};
int msgget(key_t key, int msgflg);
msgflg 旗標組合:
IPC_CREAT:不存在則建立IPC_EXCL:與 IPC_CREAT 同用,存在則失敗 (EEXIST)0660 (擁有者/群組讀寫)返回:佇列識別碼 msqid (>=0),失敗 -1。
int open_queue(key_t keyval) {
int qid = msgget(keyval, IPC_CREAT | 0660);
return qid; // -1 表失敗
}
int msgsnd(int msqid, const void *msgp, size_t msgsz, int msgflg);
msgp:指向訊息結構 (含 mtype)msgsz:資料長度,**不含 mtype (long, 4/8 bytes)**,通常 sizeof(struct mymsgbuf) - sizeof(long)msgflg:0 (阻塞直到有空間)、IPC_NOWAIT (滿則立即返回 EAGAIN)返回:成功 0,失敗 -1。
int send_message(int qid, struct mymsgbuf *qbuf) {
size_t len = sizeof(struct mymsgbuf) - sizeof(long);
return msgsnd(qid, qbuf, len, 0);
}
ssize_t msgrcv(int msqid, void *msgp, size_t msgsz, long msgtyp, int msgflg);
msgtyp:>0 接收指定類型、=0 接收佇列最舊訊息、<0 接收類型 ≤ |msgtyp| 的最小類型訊息。msgflg:0 阻塞、IPC_NOWAIT 立即返回 (無符合則 ENOMSG)、MSG_NOERROR (訊息過大時截斷而非報錯)。返回:實際複製資料位元組數 (不含 mtype),失敗 -1。**成功接收後,該訊息從佇列移除**。
int read_message(int qid, long type, struct mymsgbuf *qbuf) {
size_t len = sizeof(struct mymsgbuf) - sizeof(long);
return msgrcv(qid, qbuf, len, type, 0);
}
int peek_message(int qid, long type) {
// msgp=NULL, msgsz=0, IPC_NOWAIT
int r = msgrcv(qid, NULL, 0, type, IPC_NOWAIT);
if (r == -1 && errno == E2BIG) return 1; // 有訊息
return 0;
}
int msgctl(int msqid, int cmd, struct msqid_ds *buf);
cmd:
IPC_STAT:讀取佇列內部 msqid_ds 複製到 bufIPC_SET:從 buf 更新 msqid_ds 中 msg_perm (uid/gid/mode)IPC_RMID:立即從核心移除佇列 (所有進程卸載後釋放資源)
int get_queue_ds(int qid, struct msqid_ds *qbuf) {
return msgctl(qid, IPC_STAT, qbuf);
}
int change_queue_mode(int qid, const char *mode_str) {
struct msqid_ds ds;
if (msgctl(qid, IPC_STAT, &ds) == -1) return -1;
sscanf(mode_str, "%ho", &ds.msg_perm.mode); // 八進位字串轉 mode_t
return msgctl(qid, IPC_SET, &ds);
}
struct msqid_ds {
struct ipc_perm msg_perm; // uid, gid, mode, seq
time_t msg_stime; // 最後 msgsnd 時間
time_t msg_rtime; // 最後 msgrcv 時間
time_t msg_ctime; // 最後變更時間
unsigned long __msg_cbytes; // 目前佇列位元組數
msgqnum_t msg_qnum; // 目前訊息數
msglen_t msg_qbytes; // 佇列最大位元組數 (預設 16384)
pid_t msg_lspid; // 最後發送進程 PID
pid_t msg_lrpid; // 最後接收進程 PID
};
msgmax:單一訊息最大位元組 (預設 8192) → /proc/sys/kernel/msgmaxmsgmnb:佇列最大位元組 (預設 16384) → /proc/sys/kernel/msgmnbmsgmni:系統最大佇列數 (預設 16) → /proc/sys/kernel/msgmnisysctl -w kernel.msgmnb=65536 等現代替代:POSIX 訊息佇列 (mq_open/mq_send/mq_receive) 支援優先級、通知 (signal/thread)、名稱空間隔離,**新專案建議優先使用**。