-'\" t
+.\" t
.\" Hey Emacs! This file is -*- nroff -*- source.
.\"
.\" Copyright (C) 2006 Michael Kerrisk <mtk.manpages@gmail.com>
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
-.\" 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_GETATTR 3 2010-08-29 "Linux" "Linux Programmer's Manual"
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
+.TH MQ_GETATTR 3 2010\-08\-29 Linux "Linux Programmer's Manual"
.SH 名前
mq_getattr, mq_setattr \- メッセージキューの属性を設定/取得する
.SH 書式
.nf
-.B #include <mqueue.h>
+\fB#include <mqueue.h>\fP
.sp
-.BI "int mq_getattr(mqd_t " mqdes ", struct mq_attr *" attr );
+\fBint mq_getattr(mqd_t \fP\fImqdes\fP\fB, struct mq_attr *\fP\fIattr\fP\fB);\fP
-.BI "int mq_setattr(mqd_t " mqdes ", struct mq_attr *" newattr ","
-.BI " struct mq_attr *" oldattr );
+\fBint mq_setattr(mqd_t \fP\fImqdes\fP\fB, struct mq_attr *\fP\fInewattr\fP\fB,\fP
+\fB struct mq_attr *\fP\fIoldattr\fP\fB);\fP
.fi
.sp
\fI\-lrt\fP でリンクする。
.SH 説明
-.BR mq_getattr ()
-と
-.BR mq_setattr ()
-は、記述子
-.I mqdes
+\fBmq_getattr\fP() と \fBmq_setattr\fP() は、記述子 \fImqdes\fP
で参照されるメッセージキューの属性の取得と変更をそれぞれ行う。
-.BR mq_getattr ()
-は、
-.I attr
-が指すバッファに
-.I mq_attr
+\fBmq_getattr\fP() は、 \fIattr\fP が指すバッファに \fImq_attr\fP
構造体を格納して返す。この構造体は以下のように定義されている:
.in +4n
.nf
.fi
.in
.PP
-.I mq_flags
-フィールドには、オープンメッセージキュー記述 (open message queue
-description) に関連付けられているフラグが格納される。
-このフィールドは
-.BR mq_open (3)
-でキューが作成される際に初期化される。
-このフィールドに現れるフラグは
-.B O_NONBLOCK
-だけである。
+\fImq_flags\fP フィールドには、オープンメッセージキュー記述 (open message queue description)
+に関連付けられているフラグが格納される。 このフィールドは \fBmq_open\fP(3) でキューが作成される際に初期化される。
+このフィールドに現れるフラグは \fBO_NONBLOCK\fP だけである。
-.I mq_maxmsg
-と
-.I mq_msgsize
-フィールドは
-.BR mq_open (3)
-でメッセージキューが作成される際にセットされる。
-.I mq_maxmsg
-フィールドは、
-.BR mq_send (3)
-を使ってキューに入れることができるメッセージ数の上限である。
-.I mq_msgsize
-フィールドは、キューに入れることができるメッセージの
-上限サイズである。
-これらのフィールドはどちらも 0 より大きな値でなければならない。
-これらのフィールドに設定できる値の上限は
-.I /proc
-ファイルにより決まる。
-.I /proc
-ファイルの詳細は
-.BR mq_open (3)
-に説明されている。
+\fImq_maxmsg\fP と \fImq_msgsize\fP フィールドは \fBmq_open\fP(3) でメッセージキューが作成される際にセットされる。
+\fImq_maxmsg\fP フィールドは、 \fBmq_send\fP(3) を使ってキューに入れることができるメッセージ数の上限である。
+\fImq_msgsize\fP フィールドは、キューに入れることができるメッセージの 上限サイズである。 これらのフィールドはどちらも 0
+より大きな値でなければならない。 これらのフィールドに設定できる値の上限は \fI/proc\fP ファイルにより決まる。 \fI/proc\fP ファイルの詳細は
+\fBmq_open\fP(3) に説明されている。
-.I mq_curmsgs
-フィールドはキューに現在格納されているメッセージ数を返す。
+\fImq_curmsgs\fP フィールドはキューに現在格納されているメッセージ数を返す。
-.BR mq_setattr ()
-は、
-.I newattr
-が指す
-.I mq_attr
-構造体で与えられた情報を使って、メッセージキューの属性を設定する。
-変更することができる属性は、
-.I mq_flags
-の
-.B O_NONBLOCK
-フラグの設定だけである。
-.I newattr
-の他のフィールドは無視される。
-.I oldattr
-フィールドが NULL 以外の場合、
-.BR mq_getattr ()
-が返すのと同じ情報を格納した
-.I mq_attr
-構造体を
-.I oldattr
-が指すバッファに入れて返す。
+\fBmq_setattr\fP() は、 \fInewattr\fP が指す \fImq_attr\fP
+構造体で与えられた情報を使って、メッセージキューの属性を設定する。 変更することができる属性は、 \fImq_flags\fP の \fBO_NONBLOCK\fP
+フラグの設定だけである。 \fInewattr\fP の他のフィールドは無視される。 \fIoldattr\fP フィールドが NULL 以外の場合、
+\fBmq_getattr\fP() が返すのと同じ情報を格納した \fImq_attr\fP 構造体を \fIoldattr\fP が指すバッファに入れて返す。
.SH 返り値
-成功すると、
-.I mq_getattr ()
-と
-.I mq_setattr ()
-は 0 を返す。エラーの場合、\-1 を返し、
-.I errno
+成功すると、 \fImq_getattr ()\fP と \fImq_setattr ()\fP は 0 を返す。エラーの場合、\-1 を返し、 \fIerrno\fP
にエラーを示す値を設定する。
.SH エラー
-.TP
-.B EBADF
-.I mqdes
-で指定された記述子が不正である。
-.TP
-.B EINVAL
-.I newattr\->mq_flags
-に
-.B O_NONBLOCK
-以外のビットがセットされていた。
+.TP
+\fBEBADF\fP
+\fImqdes\fP に指定されたディスクリプタが不正である。
+.TP
+\fBEINVAL\fP
+\fInewattr\->mq_flags\fP に \fBO_NONBLOCK\fP 以外のビットがセットされていた。
.SH 準拠
-POSIX.1-2001.
+POSIX.1\-2001.
.SH 注意
-Linux では、
-.BR mq_getattr ()
-と
-.BR mq_setattr ()
-はライブラリ関数であり、
-.BR mq_getsetattr (2)
-システムコールを用いて実装されている。
+Linux では、 \fBmq_getattr\fP() と \fBmq_setattr\fP() はライブラリ関数であり、
+\fBmq_getsetattr\fP(2) システムコールを用いて実装されている。
.SH 関連項目
-.BR mq_close (3),
-.BR mq_notify (3),
-.BR mq_open (3),
-.BR mq_receive (3),
-.BR mq_send (3),
-.BR mq_unlink (3),
-.BR mq_overview (7)
+\fBmq_close\fP(3), \fBmq_notify\fP(3), \fBmq_open\fP(3), \fBmq_receive\fP(3),
+\fBmq_send\fP(3), \fBmq_unlink\fP(3), \fBmq_overview\fP(7)
OSDN Git Service
