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 の下位９ビットが msgflg の下位９ビットに設定される。

Msg_qnum、msg_lspid、msg_lrpid、 msg_stime、およびmsg_rtime が０となる。

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

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

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

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

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

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

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

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