OSDN Git Service

長音記号の修正を release に反映
[linuxjm/LDP_man-pages.git] / release / man3 / mq_receive.3
index b2260d5..96cd704 100644 (file)
 .\" This file was generated with po4a. Translate the source file.
 .\"
 .\"*******************************************************************
-.TH MQ_RECEIVE 3 2010\-09\-20 Linux "Linux Programmer's Manual"
+.\"
+.\" 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_RECEIVE 3 2014\-06\-03 Linux "Linux Programmer's Manual"
 .SH 名前
 mq_receive, mq_timedreceive \- メッセージキューからメッセージを受信する
 .SH 書式
@@ -36,13 +41,13 @@ mq_receive, mq_timedreceive \- メッセージキューからメッセージを
 \fB#include <mqueue.h>\fP
 .sp
 \fBssize_t mq_receive(mqd_t \fP\fImqdes\fP\fB, char *\fP\fImsg_ptr\fP\fB,\fP
-\fB                   size_t \fP\fImsg_len\fP\fB, unsigned *\fP\fImsg_prio\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
 \fBssize_t mq_timedreceive(mqd_t \fP\fImqdes\fP\fB, char *\fP\fImsg_ptr\fP\fB,\fP
-\fB                   size_t \fP\fImsg_len\fP\fB, unsigned *\fP\fImsg_prio\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
@@ -60,11 +65,11 @@ _XOPEN_SOURCE\ >=\ 600 || _POSIX_C_SOURCE\ >=\ 200112L
 .ad
 .SH 説明
 \fBmq_receive\fP()  は、記述子 \fImqdes\fP で参照されるメッセージキューから最も高い優先度を持つ
-最も古いメッセージを削除し、そのメッセージを \fImsg_ptr\fP が指すバッファに格納する。 \fImsg_len\fP 引き数は、 \fImsg_ptr\fP
\81\8cæ\8c\87ã\81\99ã\83\90ã\83\83ã\83\95ã\82¡ã\81®å¤§ã\81\8dã\81\95ã\82\92示ã\81\99ã\80\82ã\81\93ã\81®å\80¤ã\81¯ã\82­ã\83¥ã\83¼ã\81® \fImq_msgsize\fP å±\9eæ\80§ã\82\88ã\82\8aã\82\82大ã\81\8dã\81\8fã\81ªã\81\91ã\82\8cã\81°ã\81ªã\82\89ã\81ªã\81\84 (\fBmq_getattr\fP(3)
-参照)。 \fImsg_prio\fP が NULL 以外の場合、 \fImsg_prio\fP が指すバッファに受信したメッセージの優先度が格納される。
\9c\80ã\82\82å\8f¤ã\81\84ã\83¡ã\83\83ã\82»ã\83¼ã\82¸ã\82\92å\89\8aé\99¤ã\81\97ã\80\81ã\81\9dã\81®ã\83¡ã\83\83ã\82»ã\83¼ã\82¸ã\82\92 \fImsg_ptr\fP ã\81\8cæ\8c\87ã\81\99ã\83\90ã\83\83ã\83\95ã\82¡ã\83¼ã\81«æ ¼ç´\8dã\81\99ã\82\8bã\80\82 \fImsg_len\fP å¼\95ã\81\8dæ\95°ã\81¯ã\80\81 \fImsg_ptr\fP
\81\8cæ\8c\87ã\81\99ã\83\90ã\83\83ã\83\95ã\82¡ã\83¼ã\81®å¤§ã\81\8dã\81\95ã\82\92示ã\81\99ã\80\82ã\81\93ã\81®å\80¤ã\81¯ã\82­ã\83¥ã\83¼ã\81® \fImq_msgsize\fP å±\9eæ\80§ä»¥ä¸\8aã\81§ã\81ªã\81\91ã\82\8cã\81°ã\81ªã\82\89ã\81ªã\81\84 (\fBmq_getattr\fP(3)  å\8f\82ç\85§)ã\80\82
+\fImsg_prio\fP が NULL 以外の場合、 \fImsg_prio\fP が指すバッファーに受信したメッセージの優先度が格納される。
 
-キューが空の場合、デフォルトでは、 \fBmq_receive\fP()  は、新しいメッセージが届くか、関数呼び出しがシグナルハンドラにより
\82­ã\83¥ã\83¼ã\81\8c空ã\81®å ´å\90\88ã\80\81ã\83\87ã\83\95ã\82©ã\83«ã\83\88ã\81§ã\81¯ã\80\81 \fBmq_receive\fP()  ã\81¯ã\80\81æ\96°ã\81\97ã\81\84ã\83¡ã\83\83ã\82»ã\83¼ã\82¸ã\81\8cå±\8aã\81\8fã\81\8bã\80\81é\96¢æ\95°å\91¼ã\81³å\87ºã\81\97ã\81\8cã\82·ã\82°ã\83\8aã\83«ã\83\8fã\83³ã\83\89ã\83©ã\83¼ã\81«ã\82\88ã\82\8a
 中断されるまで、停止 (block) する。 メッセージキュー記述 (message queue description) で
 \fBO_NONBLOCK\fP フラグが有効になっている場合は、 \fBmq_receive\fP()  はエラー \fBEAGAIN\fP ですぐに失敗する。
 
@@ -95,7 +100,7 @@ struct timespec {
 \fImqdes\fP で指定された記述子が不正である。
 .TP 
 \fBEINTR\fP
-関数呼び出しがシグナルハンドラにより中断された。 \fBsignal\fP(7)  参照。
\96¢æ\95°å\91¼ã\81³å\87ºã\81\97ã\81\8cã\82·ã\82°ã\83\8aã\83«ã\83\8fã\83³ã\83\89ã\83©ã\83¼ã\81«ã\82\88ã\82\8a中æ\96­ã\81\95ã\82\8cã\81\9fã\80\82 \fBsignal\fP(7)  å\8f\82ç\85§ã\80\82
 .TP 
 \fBEINVAL\fP
 関数呼び出しは停止するはずであったが、 \fIabs_timeout\fP が不正であった。 \fIabs_timeout\fP が不正とは、 \fItv_sec\fP
@@ -106,6 +111,9 @@ struct timespec {
 .TP 
 \fBETIMEDOUT\fP
 メッセージが転送される前に関数呼び出しがタイムアウトした。
+.SH 属性
+.SS "マルチスレッディング (pthreads(7) 参照)"
+関数 \fBmq_receive\fP() と \fBmq_timedreceive\fP() はスレッドセーフである。
 .SH 準拠
 POSIX.1\-2001.
 .SH 注意
@@ -115,6 +123,6 @@ Linux では、 \fBmq_timedreceive\fP()  はシステムコールである。 \f
 \fBmq_close\fP(3), \fBmq_getattr\fP(3), \fBmq_notify\fP(3), \fBmq_open\fP(3),
 \fBmq_send\fP(3), \fBmq_unlink\fP(3), \fBmq_overview\fP(7), \fBtime\fP(7)
 .SH この文書について
-この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.52 の一部
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.78 の一部
 である。プロジェクトの説明とバグ報告に関する情報は
 http://www.kernel.org/doc/man\-pages/ に書かれている。