msgsnd()

キューに十分な空き容量がある場合、 msgsnd() は直ちに成功する。 (キューの容量は、メッセージ・キューのデータ構造体の msg_qbytes フィールドで定義される。キュー作成時にこのフィールドは MSGMNB に初期化されるが、この制限は msgctl(2) を使って変更できる。) キューに十分な空き容量がない場合、デフォルトでは msgsnd() は空き容量ができるまで停止 (block) する。 msgflg に IPC_NOWAIT が指定された場合は、エラー EAGAIN で失敗する。

停止している msgsnd() は以下の場合にも失敗する。

*

キューが削除された。この場合、 errno は EIDRM に設定される。

*

シグナルが捕捉された。この場合、 errno は EINTR に設定される。 signal(7) 参照。 ( msgsnd() は、たとえシグナルハンドラの設定時に SA_RESTART を指定していたとしても、シグナルハンドラによって割り込まれた後で自動的に再スタートすることは決してない。)

正常に終了した場合、メッセージ・キューのデータ構造体は以下のように更新される:

msg_lspid には呼び出し元プロセスのプロセス ID が設定される。

msg_qnum は 1 増加する。

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

msgrcv()

msgsz 引き数には msgp 引き数で指定された構造体の mtext メンバーの最大のバイト数を指定する。メッセージのテキストの長さが msgsz より大きい場合の動作は、 msgflg に MSG_NOERROR が指定されているかどうかで決まる。 MSG_NOERROR が指定されていれば、メッセージのテキストは切り詰められる (切り捨てられた部分は失われる)。 MSG_NOERROR が指定されていなければ、メッセージはキューから削除されず、システムコールは-1 を返して失敗し、 errno に E2BIG が設定される。

msgtyp 引き数には要求するメッセージの型を指定する。型は以下のように指定する:

*

msgtyp が 0 ならば、キューの最初にあるメッセージが読み込まれる。

*

msgtyp が 0 より大きい場合、 msgflg に MSG_EXCEPT が指定されていなければ、 msgtyp 型のキューの最初のメッセージが読み込まれる。 MSG_EXCEPT が指定された場合は、 msgtyp 型以外のキューの最初のメッセージが読み込まれる。

*

msgtyp が 0 より小さければ、 msgtyp の絶対値以下で最も小さい型を持つキューの最初のメッセージが読み込まれる。

msgflg 引き数には、以下のフラグを任意の数だけ (0個も可)、これらの OR で指定する:

IPC_NOWAIT

キューに要求された型のメッセージがない場合には直ちに返る。システムコールは失敗し、 errno には ENOMSG が設定される。

MSG_EXCEPT

0 より大きな msgtyp と一緒に使用して、 msgtyp 以外のキューの最初のメッセージを読み込む。

MSG_NOERROR

msgsz バイトよりも長かった場合はメッセージのテキストを切り詰める。

要求された型のメッセージが存在せず、 msgflg に IPC_NOWAIT が指定されていなかった場合、呼び出し元プロセスは以下のいずれかの状況になるまで停止 (block) される:

*

要求している型のメッセージがキューへ入れられた。

*

メッセージ・キューがシステムから削除された。この場合、システムコールは失敗し、 errno に EIDRM が設定される。

*

呼び出し元プロセスがシグナルを捕獲した。この場合、システムコールは失敗し、 errno に EINTR が設定される。 ( msgrcv() は、たとえシグナルハンドラの設定時に SA_RESTART を指定していたとしても、シグナルハンドラによって割り込まれた後で自動的に再スタートすることは決してない。)

正常に終了した場合、メッセージ・キューのデータ構造体は以下のように更新される:

msg_lrpid には呼び出し元プロセスのプロセス ID が設定される。

msg_qnum は 1 減算される。

msg_rtime には現在の時刻が設定される。