MSGGET(2V) — NEWS-OS Programmer’s Manual

名称

msgget − メッセージキューの獲得

#include <sys/types.h>
#include <sys/ipc.h>
#include <sys/msg.h>

int msgget(key, msgflg)
key_t key;
int msgflg;

msgget は key に対応するメッセージキュー識別子を返します。

以下の記述のいずれかに該当する場合、メッセージキュー識別子、メッセージキュー、およびデータ構造体 ( intro(2) 参照) が key に対して作成されます。

key が IPC_PRIVATE と同等。

key はまだメッセージキュー識別子を持っていない、また ( msgflg & IPC_CREAT) が“真”でない。

作成時、新しいメッセージキュー識別子のデータ構造体は以下のように設定されます。

msg_perm.cuid、msg_perm.uid msg_perm.cgid、および msg_perm.gid がそれぞれ呼び出しプロセスの有効ユーザ ID および有効グループに設定される。

msg_perm.mode の下位 9 ビットが msgflg の下位 9 ビットに設定される。

msg_qnum、msg_lspid、msg_lrpid msg_stime、およびmsg_rtime が 0 となる。

msg_ctime が現在時刻に設定される。

msg_qbytes がシステムの限界値に設定される。

以下に示すものが 1 つでも該当する場合、 msgget の実行に失敗します。

[EACCES] key に対するメッセージキュー識別子が存在するが、 msgflg の下位 9 ビットで指定される動作許可 ( intro(2) 参照) が認められない。

[ENOENT] key に関するメッセージキュー識別子が存在せず、また (msgflg & IPC_CREAT) が偽。

[ENOSPC] メッセージキュー識別子が作成されようとしたが、メッセージキュー識別子の数がシステム全体の最大数を超えている。

[EEXIST] key に関するメッセージキュー識別子が存在するが ((msgflg & IPC_CREAT) & ( msgflg & IPC_EXCL)) が真。

コマンドの実行に成功すると、正の整数、すなわちメッセージキュー識別子が返されます。失敗すると、−1 が返され、 errno が返されます。