日本語 man コマンド類 (ja-man-1.1j_5) と日本語 man ドキュメント (ja-man-doc-5.4 (5.4-RELEASE 用) など) をインストールすると、以下のような man コマンド閲覧、キーワード検索が コンソールからできるようになります。
4.11-RELEASE-K, 5.4-RELEASE-K, 5.5-RELEASE-K, 6.0-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K, 12.1-RELEASE-K は、 プライベート版 (小金丸が編集してまとめたもの) ですが、 より多くの翻訳したファイルが含まれています。 (5.4-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K から 12.4-RELEASE-K, 13.0-RELEASE-K から 13.3-RELEASE-K, 14.0-RELEASE-K から 14.1-RELEASE-K は、全翻訳済み)
13.3-STABLE-K, 15.0-CURRENT-K は現在、作成中で日々更新されています。
Table of Contents
MQ_NOTIFY(2) FreeBSD システムコールマニュアル MQ_NOTIFY(2)
名称
mq_notify -- メッセージが利用可能であることをプロセスに通知する (リアルタ
イム)
ライブラリ
POSIX リアルタイムライブラリ (librt, -lrt)
書式
#include <mqueue.h>
int
mq_notify(mqd_t mqdes, const struct sigevent *notification);
解説
引数 notification が NULL でないなら、このシステムコールは、指定された
メッセージキュー記述子 mqdes に関連している空のメッセージキューにメッセー
ジ到着を通知するために呼び出しプロセスを登録します。notification 引数に
よって指定された通知は、メッセージキューが空から非空に遷移するとき、プロ
セスに送信されます。いつでも、メッセージキューによる通知のためには、1 つ
のプロセスだけが登録できます。呼び出しプロセス、または他のプロセスが既に
指定されたメッセージキューでメッセージの到着の通知を登録しているなら、そ
の後のそのメッセージキューに登録する試みは、失敗します。
notification 引数は、呼び出しプロセスがどのように通知されるかを定義する
sigevent 構造体を指します。notification->sigev_notify が SIGEV_NONE であ
るなら、シグナルは通知されませんが、エラー状態と操作の戻り状態は、適切に
設定されます。SIGEV_SIGNO と SIGEV_THREAD_ID 通知のために、
notification->sigev_signo で指定されたシグナルは、呼び出しているプロセス
(SIGEV_SIGNO) または LWP ID が notification->sigev_notify_thread_id
(SIGEV_THREAD_ID) であるスレッドに送られます。キューに入れられたシグナル
のための情報は、次を含んでいます:
メンバ 値
si_code SI_MESGQ
si_value notification->sigev_value に格納される値
si_mqd mqdes
notification が NULL であり、プロセスが指定されたメッセージキューによって
通知のために現在登録されているなら、既存の登録は、削除されます。
通知が登録されたプロセスに送信されるとき、登録は、削除されます。次に、
メッセージキューは、登録が利用可能となります。
プロセスがメッセージキューにメッセージの到着の通知が登録され、いくつかの
スレッドがメッセージがキューに到達するとき、メッセージを受信するのを
ウェートする (待つ)、mq_receive() でブロックされるなら、到着メッセージ
は、適切な mq_receive() を満足します。結果の振る舞いは、まるでメッセージ
キューが空のままで残っているかのようであり、通知は送信されません。
戻り値
成功して終了したときには値 0 を返します。そうでない場合、値 -1 が返され、
グローバル変数 errno にエラーを示す値が設定されます。
エラー
mq_notify() システムコールは、次の場合に失敗します:
[EBADF] mqdes 引数が、有効なメッセージキュー記述子ではありませ
ん。
[EBUSY] プロセスは、メッセージキューによって通知のために既に登
録されています。
[EINVAL] notification->sigev_notify の非同期の通知方法が、無効
であるか、またはサポートしていません。
関連項目
mq_open(2), mq_send(2), mq_timedsend(2), sigevent(3), siginfo(3)
規格
mq_notify() システムコールは、IEEE Std 1003.1-2004 (``POSIX.1'') に適合し
ています。
歴史
POSIX メッセージキューのサポートは FreeBSD 7.0 ではじめて登場しました。
COPYRIGHT
Portions of this text are reprinted and reproduced in electronic form
from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology
-- Portable Operating System Interface (POSIX), The Open Group Base Spec
ifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electri
cal and Electronics Engineers, Inc and The Open Group. In the event of
any discrepancy between this version and the original IEEE and The Open
Group Standard, the original IEEE and The Open Group Standard is the ref
eree document. The original Standard can be obtained online at
http://www.opengroup.org/unix/online.html.
FreeBSD 11.4 July 15, 2016 FreeBSD 11.4