萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 伺服器教學

Linux System V 訊息佇列 完整 API 詳解:msgget/msgsnd/msgrcv/msgctl

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;
};

1. msgget - 取得/建立佇列


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 表失敗
}

2. msgsnd - 發送訊息


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);
}

3. msgrcv - 接收訊息


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;
}

4. msgctl - 佇列控制


int msgctl(int msqid, int cmd, struct msqid_ds *buf);

cmd:

  • IPC_STAT:讀取佇列內部 msqid_ds 複製到 buf
  • IPC_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);
}

msqid_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/msgmax
  • msgmnb:佇列最大位元組 (預設 16384) → /proc/sys/kernel/msgmnb
  • msgmni:系統最大佇列數 (預設 16) → /proc/sys/kernel/msgmni
  • 大量訊息應用需調大:sysctl -w kernel.msgmnb=65536 等
現代替代:POSIX 訊息佇列 (mq_open/mq_send/mq_receive) 支援優先級、通知 (signal/thread)、名稱空間隔離,**新專案建議優先使用**。
copyright © 萬盛學電腦網 all rights reserved