mq_overview - 約束事その他の説明 - Linux コマンド集 一覧表

ほとんどの場合、上記の mq_*() ライブラリインタフェースは、同じ名前の下位層のシステムコールを 使って実装されている。この枠組みにあてはまらないものを 以下の表に示す。
.TS lB lB l l. Library interface System call mq_close(3) close(2) mq_getattr(3) mq_getsetattr(2) mq_open(3) mq_open(2) mq_receive(3) mq_timedreceive(2) mq_send(3) mq_timedsend(2) mq_setattr(3) mq_getsetattr(2) mq_timedreceive(3) mq_timedreceive(2) mq_timedsend(3) mq_timedsend(2) mq_unlink(3) mq_unlink(2)

Linux では POSIX メッセージキューはカーネル 2.6.6 以降でサポートされている。 glibc ではバージョン 2.3.4 以降でサポートされている。

POSIX メッセージキューのサポートは、カーネルの設定 (configuration) オプション CONFIG_POSIX_MQUEUE で設定可能である。このオプションはデフォルトでは有効である。

POSIX メッセージキューはカーネル内で保持される。 mq_unlink ()で削除されなければ、メッセージキューは システムがシャットダウンされるまで存在し続ける。

POSIX メッセージキュー API を使用したプログラムは cc -lrt でコンパイルし、リアルタイムライブラリ librt とリンクしなければならない。

以下のインタフェースを使って、POSIX メッセージキューが消費するカーネル メモリの量を制限することができる。

/proc/sys/fs/mqueue/msg_max

このファイルを使って、一つのキューに入れられるメッセージの最大数の 上限値を参照したり変更したりできる。この値は、   mq_open (3) に渡す attr->mq_maxmsg 引き数に対する上限値として機能する。 msg_max のデフォルト値および最小値は 10 である; 上限は「埋め込みの固定値」(HARD_MAX) で (131072/sizeof(void*)) (Linux/86 では 32768) である。 この上限は特権プロセス ( CAP_SYS_RESOURCE )では無視されるが、埋め込みの固定値による上限は どんな場合にでも適用される。

/proc/sys/fs/mqueue/msgsize_max

このファイルを使って、メッセージの最大サイズの上限値を 参照したり変更したりできる。 この値は、 mq_open (3) に渡す attr.mq_msgsize 引き数に対する上限値として機能する。 msgsize_max のデフォルト値および最小値は 8192 バイトである; 上限は INT_MAX (Linux/86 では 2147483647) である。 この上限は特権プロセス ( CAP_SYS_RESOURCE ) では無視される。

/proc/sys/fs/mqueue/queues_max

このファイルを使って、作成することができるメッセージキューの数に 対するシステム全体での制限を参照したり変更したりできる。 一度この上限に達すると、新しいメッセージキューを作成できるのは 特権プロセス ( CAP_SYS_RESOURCE ) だけとなる。 queues_max のデフォルト値は 256 であり、 0 から INT_MAX の範囲の任意の値に変更することができる。

リソース上限 RLIMIT_MSGQUEUE は、プロセスの実 UID に対応する全メッセージキューが消費する メモリ空間の量に対して上限を設定する。   getrlimit (2) を参照。

Linux では、メッセージキューは仮想ファイルシステム内に作成される (他の実装でも同様の機能が提供されているものもあるが、 詳細は違っているだろう)。 以下のコマンドを使うことで、このファイルシステムをマウントできる:

$ mkdir /dev/mqueue
$ mount -t mqueue none /dev/mqueue

マウントしたディレクトリのスティッキービット (sticky bit) は 自動的にオンとなる。
メッセージキュー・ファイルシステムのマウント後は、ファイルに対して 通常使うコマンド (例えば   ls (1) や   rm (1)) を使って、システム上のメッセージキューを表示したり 操作したりできる。
ディレクトリ内の各ファイルの内容は 1行であり、 キューに関する情報が表示される。

$ ls /dev/mqueue/mymq
QSIZE:129     NOTIFY:2    SIGNO:0    NOTIFY_PID:8260
$ mount -t mqueue none /dev/mqueue

各フィールドの詳細は以下の通りである:

QSIZE

キューに入っている全メッセージの合計バイト数。

NOTIFY_PID

この値が 0 以外の場合、この値の PID を持つプロセスが   mq_notify (3) を使って、非同期のメッセージ通知を行うように設定したことを示す。 どのように通知が行われるかは、以下のフィールドにより決定される。

NOTIFY

通知方法: 0 は SIGEV_SIGNAL ;1 は SIGEV_NONE ;2 は SIGEV_THREAD

SIGNO

SIGEV_SIGNAL に使用されるシグナル番号。

Linux では、メッセージキュー記述子は実際はファイル記述子 (file descriptor) であり、   select (2),   poll (2),   epoll (7) を使って監視することができる。 この機能の移植性はない。