+++ /dev/null
-.\" t
-.\" Copyright (C) 2006 Michael Kerrisk <mtk.manpages@gmail.com>
-.\"
-.\" %%%LICENSE_START(VERBATIM)
-.\" Permission is granted to make and distribute verbatim copies of this
-.\" manual provided the copyright notice and this permission notice are
-.\" preserved on all copies.
-.\"
-.\" Permission is granted to copy and distribute modified versions of this
-.\" manual under the conditions for verbatim copying, provided that the
-.\" entire resulting derived work is distributed under the terms of a
-.\" permission notice identical to this one.
-.\"
-.\" Since the Linux kernel and libraries are constantly changing, this
-.\" manual page may be incorrect or out-of-date. The author(s) assume no
-.\" responsibility for errors or omissions, or for damages resulting from
-.\" the use of the information contained herein. The author(s) may not
-.\" have taken the same level of care in the production of this manual,
-.\" which is licensed free of charge, as they might when working
-.\" professionally.
-.\"
-.\" Formatted or processed versions of this manual, if unaccompanied by
-.\" the source, must acknowledge the copyright and authors of this work.
-.\" %%%LICENSE_END
-.\"
-.\"*******************************************************************
-.\"
-.\" This file was generated with po4a. Translate the source file.
-.\"
-.\"*******************************************************************
-.\"
-.\" Japanese Version Copyright (c) 2006 Akihiro MOTOKI all rights reserved.
-.\" Translated 2006-04-23, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
-.\" Updated 2008-11-09, Akihiro MOTOKI, LDP v3.13
-.\"
-.TH MQ_SEND 3 2014\-06\-03 Linux "Linux Programmer's Manual"
-.SH 名前
-mq_send, mq_timedsend \- メッセージキューにメッセージを送信する
-.SH 書式
-.nf
-\fB#include <mqueue.h>\fP
-.sp
-\fBint mq_send(mqd_t \fP\fImqdes\fP\fB, const char *\fP\fImsg_ptr\fP\fB,\fP
-\fB size_t \fP\fImsg_len\fP\fB, unsigned int \fP\fImsg_prio\fP\fB);\fP
-.sp
-\fB#include <time.h>\fP
-\fB#include <mqueue.h>\fP
-.sp
-\fBint mq_timedsend(mqd_t \fP\fImqdes\fP\fB, const char *\fP\fImsg_ptr\fP\fB,\fP
-\fB size_t \fP\fImsg_len\fP\fB, unsigned int \fP\fImsg_prio\fP\fB,\fP
-\fB const struct timespec *\fP\fIabs_timeout\fP\fB);\fP
-.fi
-.sp
-\fI\-lrt\fP でリンクする。
-.sp
-.ad l
-.in -4n
-glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参照):
-.in
-.sp
-\fBmq_timedsend\fP():
-.RS 4
-_XOPEN_SOURCE\ >=\ 600 || _POSIX_C_SOURCE\ >=\ 200112L
-.RE
-.ad
-.SH 説明
-\fBmq_send\fP() は、記述子 \fImqdes\fP で参照されるメッセージキューに \fImsg_ptr\fP が指すメッセージを追加する。
-\fImsg_len\fP 引き数は、 \fImsg_ptr\fP が指すメッセージの長さを示す。この長さはキューの \fImq_msgsize\fP
-属性以下でなければならない。 長さが 0 のメッセージも認められている。
-
-\fImsg_prio\fP 引き数は、メッセージの優先度を指定する負でない整数である。
-メッセージは優先度の降順でキューに格納され、同じ優先度の新しいメッセージは 同じ優先度の古いメッセージの後ろに格納される。
-
-メッセージキューがすでに一杯の場合 (すなわち、キューに入っているメッセージ数がキューの \fImq_maxmsg\fP 属性と等しい場合)、デフォルトでは、
-\fBmq_send ()\fP は、メッセージをキューイングするのに十分な空間ができるか、 関数呼び出しがシグナルハンドラーにより中断されるまで、停止
-(block) する。 メッセージキュー記述 (message queue description) で \fBO_NONBLOCK\fP
-フラグが有効になっている場合は、 \fBmq_send\fP() はエラー \fBEAGAIN\fP ですぐに失敗する。
-
-\fBmq_timedsend\fP() は \fBmq_send\fP() と全く同じ動作をするが、 メッセージキューが一杯で、メッセージキュー記述で
-\fBO_NONBLOCK\fP フラグが有効になっていない場合に、この呼び出しが停止する時間の上限を \fIabs_timeout\fP
-が指す構造体で指定する点が異なる。この上限は、タイムアウトの時刻を 時刻紀元 (Epoch; 1970\-01\-01 00:00:00 +0000
-(UTC)) からの経過時間 (秒とナノ秒の組) で指定する。タイムアウト時刻は以下の構造体で指定する:
-.sp
-.in +4n
-.nf
-struct timespec {
- time_t tv_sec; /* 秒 */
- long tv_nsec; /* ナノ秒 */
-};
-
-.fi
-.in
-メッセージキューが一杯で、関数呼び出し時にすでにタイムアウト時刻が 過ぎている場合、 \fBmq_timedsend\fP() はすぐに返る。
-.SH 返り値
-成功すると、 \fBmq_send\fP() と \fBmq_timedsend\fP() は 0 を返す。 エラーの場合、\-1 を返し、 \fIerrno\fP
-にエラーを示す値を設定する。
-.SH エラー
-.TP
-\fBEAGAIN\fP
-キューが一杯で、かつ \fImqdes\fP で参照されるメッセージキュー記述で \fBO_NONBLOCK\fP フラグがセットされていた。
-.TP
-\fBEBADF\fP
-\fImqdes\fP で指定された記述子が不正である。
-.TP
-\fBEINTR\fP
-関数呼び出しがシグナルハンドラーにより中断された。 \fBsignal\fP(7) 参照。
-.TP
-\fBEINVAL\fP
-関数呼び出しは停止するはずであったが、 \fIabs_timeout\fP が不正であった。 \fIabs_timeout\fP が不正とは、 \fItv_sec\fP
-が 0 未満、もしくは \fItv_nsec\fP が 0 未満か 1,000,000,000 より大きい、ということである。
-.TP
-\fBEMSGSIZE\fP
-\fImsg_len\fP がメッセージキューの \fImq_msgsize\fP 属性よりも大きかった。
-.TP
-\fBETIMEDOUT\fP
-メッセージが転送される前に関数呼び出しがタイムアウトした。
-.SH 属性
-.SS "マルチスレッディング (pthreads(7) 参照)"
-関数 \fBmq_send\fP() と \fBmq_timedsend\fP() はスレッドセーフである。
-.SH 準拠
-POSIX.1\-2001.
-.SH 注意
-Linux では、 \fBmq_timedsend\fP() はシステムコールである。 \fBmq_send\fP() はライブラリ関数で、
-\fBmq_timedsend\fP() システムコールを用いて実装されている。
-.SH 関連項目
-\fBmq_close\fP(3), \fBmq_getattr\fP(3), \fBmq_notify\fP(3), \fBmq_open\fP(3),
-\fBmq_receive\fP(3), \fBmq_unlink\fP(3), \fBmq_overview\fP(7), \fBtime\fP(7)
-.SH この文書について
-この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.79 の一部
-である。プロジェクトの説明とバグ報告に関する情報は
-http://www.kernel.org/doc/man\-pages/ に書かれている。
OSDN Git Service
