.\"
.TH MQ_GETATTR 3 2010-08-29 "Linux" "Linux Programmer's Manual"
.\"O .SH NAME
-.SH ̾Á°
+.SH 名前
.\"O mq_getattr, mq_setattr \- get/set message queue attributes
-mq_getattr, mq_setattr \- ¥á¥Ã¥»¡¼¥¸¥¥å¡¼¤Î°À¤òÀßÄê/¼èÆÀ¤¹¤ë
+mq_getattr, mq_setattr \- メッセージキューの属性を設定/取得する
.\"O .SH SYNOPSIS
-.SH ½ñ¼°
+.SH 書式
.nf
.B #include <mqueue.h>
.sp
.fi
.sp
.\"O Link with \fI\-lrt\fP.
-\fI\-lrt\fP ¤Ç¥ê¥ó¥¯¤¹¤ë¡£
+\fI\-lrt\fP でリンクする。
.\"O .SH DESCRIPTION
-.SH ÀâÌÀ
+.SH 説明
.\"O .BR mq_getattr ()
.\"O and
.\"O .BR mq_setattr ()
.\"O referred to by the descriptor
.\"O .IR mqdes .
.BR mq_getattr ()
-¤È
+と
.BR mq_setattr ()
-¤Ï¡¢µ½Ò»Ò
+は、記述子
.I mqdes
-¤Ç»²¾È¤µ¤ì¤ë¥á¥Ã¥»¡¼¥¸¥¥å¡¼¤Î°À¤Î¼èÆÀ¤ÈÊѹ¹¤ò¤½¤ì¤¾¤ì¹Ô¤¦¡£
+で参照されるメッセージキューの属性の取得と変更をそれぞれ行う。
.\"O .BR mq_getattr ()
.\"O returns an
.\"O .IR attr .
.\"O This structure is defined as:
.BR mq_getattr ()
-¤Ï¡¢
+は、
.I attr
-¤¬»Ø¤¹¥Ð¥Ã¥Õ¥¡¤Ë
+が指すバッファに
.I mq_attr
-¹½Â¤ÂΤò³ÊǼ¤·¤ÆÊÖ¤¹¡£¤³¤Î¹½Â¤ÂΤϰʲ¼¤Î¤è¤¦¤ËÄêµÁ¤µ¤ì¤Æ¤¤¤ë:
+構造体を格納して返す。この構造体は以下のように定義されている:
.in +4n
.nf
.\"O long mq_maxmsg; /* Max. # of messages on queue */
.\"O long mq_msgsize; /* Max. message size (bytes) */
.\"O long mq_curmsgs; /* # of messages currently in queue */
- long mq_flags; /* ¥Õ¥é¥°: 0 ¤« O_NONBLOCK */
- long mq_maxmsg; /* ¥¥å¡¼¤ÎºÇÂç¥á¥Ã¥»¡¼¥¸¿ô */
- long mq_msgsize; /* ºÇÂç¥á¥Ã¥»¡¼¥¸¥µ¥¤¥º (¥Ð¥¤¥Èñ°Ì) */
- long mq_curmsgs; /* ¥¥å¡¼¤Ë¸½ºßÆþ¤Ã¤Æ¤¤¤ë¥á¥Ã¥»¡¼¥¸¿ô */
+ long mq_flags; /* フラグ: 0 か O_NONBLOCK */
+ long mq_maxmsg; /* キューの最大メッセージ数 */
+ long mq_msgsize; /* 最大メッセージサイズ (バイト単位) */
+ long mq_curmsgs; /* キューに現在入っているメッセージ数 */
};
.fi
.in
.\"O The only flag that can appear in this field is
.\"O .BR O_NONBLOCK .
.I mq_flags
-¥Õ¥£¡¼¥ë¥É¤Ë¤Ï¡¢¥ª¡¼¥×¥ó¥á¥Ã¥»¡¼¥¸¥¥å¡¼µ½Ò (open message queue
-description) ¤Ë´ØÏ¢ÉÕ¤±¤é¤ì¤Æ¤¤¤ë¥Õ¥é¥°¤¬³ÊǼ¤µ¤ì¤ë¡£
-¤³¤Î¥Õ¥£¡¼¥ë¥É¤Ï
+フィールドには、オープンメッセージキュー記述 (open message queue
+description) に関連付けられているフラグが格納される。
+このフィールドは
.BR mq_open (3)
-¤Ç¥¥å¡¼¤¬ºîÀ®¤µ¤ì¤ëºÝ¤Ë½é´ü²½¤µ¤ì¤ë¡£
-¤³¤Î¥Õ¥£¡¼¥ë¥É¤Ë¸½¤ì¤ë¥Õ¥é¥°¤Ï
+でキューが作成される際に初期化される。
+このフィールドに現れるフラグは
.B O_NONBLOCK
-¤À¤±¤Ç¤¢¤ë¡£
+だけである。
.\"O The
.\"O .I mq_maxmsg
.\"O fields are set when the message queue is created by
.\"O .BR mq_open (3).
.I mq_maxmsg
-¤È
+と
.I mq_msgsize
-¥Õ¥£¡¼¥ë¥É¤Ï
+フィールドは
.BR mq_open (3)
-¤Ç¥á¥Ã¥»¡¼¥¸¥¥å¡¼¤¬ºîÀ®¤µ¤ì¤ëºÝ¤Ë¥»¥Ã¥È¤µ¤ì¤ë¡£
+でメッセージキューが作成される際にセットされる。
.\"O The
.\"O .I mq_maxmsg
.\"O field is an upper limit on the number of messages
.\"O that may be placed on the queue using
.\"O .BR mq_send (3).
.I mq_maxmsg
-¥Õ¥£¡¼¥ë¥É¤Ï¡¢
+フィールドは、
.BR mq_send (3)
-¤ò»È¤Ã¤Æ¥¥å¡¼¤ËÆþ¤ì¤ë¤³¤È¤¬¤Ç¤¤ë¥á¥Ã¥»¡¼¥¸¿ô¤Î¾å¸Â¤Ç¤¢¤ë¡£
+を使ってキューに入れることができるメッセージ数の上限である。
.\"O The
.\"O .I mq_msgsize
.\"O field is an upper limit on the size of messages
.\"O that may be placed on the queue.
.I mq_msgsize
-¥Õ¥£¡¼¥ë¥É¤Ï¡¢¥¥å¡¼¤ËÆþ¤ì¤ë¤³¤È¤¬¤Ç¤¤ë¥á¥Ã¥»¡¼¥¸¤Î
-¾å¸Â¥µ¥¤¥º¤Ç¤¢¤ë¡£
+フィールドは、キューに入れることができるメッセージの
+上限サイズである。
.\"O Both of these fields must have a value greater than zero.
.\"O Two
.\"O .I /proc
.\"O files that place ceilings on the values for these fields are described in
.\"O .BR mq_open (3).
-¤³¤ì¤é¤Î¥Õ¥£¡¼¥ë¥É¤Ï¤É¤Á¤é¤â 0 ¤è¤êÂ礤ÊÃͤǤʤ±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
-¤³¤ì¤é¤Î¥Õ¥£¡¼¥ë¥É¤ËÀßÄê¤Ç¤¤ëÃͤξå¸Â¤Ï
+これらのフィールドはどちらも 0 より大きな値でなければならない。
+これらのフィールドに設定できる値の上限は
.I /proc
-¥Õ¥¡¥¤¥ë¤Ë¤è¤ê·è¤Þ¤ë¡£
+ファイルにより決まる。
.I /proc
-¥Õ¥¡¥¤¥ë¤Î¾ÜºÙ¤Ï
+ファイルの詳細は
.BR mq_open (3)
-¤ËÀâÌÀ¤µ¤ì¤Æ¤¤¤ë¡£
+に説明されている。
.\"O The
.\"O .I mq_curmsgs
.\"O field returns the number of messages currently held in the queue.
.I mq_curmsgs
-¥Õ¥£¡¼¥ë¥É¤Ï¥¥å¡¼¤Ë¸½ºß³ÊǼ¤µ¤ì¤Æ¤¤¤ë¥á¥Ã¥»¡¼¥¸¿ô¤òÊÖ¤¹¡£
+フィールドはキューに現在格納されているメッセージ数を返す。
.\"O .BR mq_setattr ()
.\"O sets message queue attributes using information supplied in the
.\"O structure pointed to by
.\"O .IR newattr .
.BR mq_setattr ()
-¤Ï¡¢
+は、
.I newattr
-¤¬»Ø¤¹
+が指す
.I mq_attr
-¹½Â¤ÂΤÇÍ¿¤¨¤é¤ì¤¿¾ðÊó¤ò»È¤Ã¤Æ¡¢¥á¥Ã¥»¡¼¥¸¥¥å¡¼¤Î°À¤òÀßÄꤹ¤ë¡£
+構造体で与えられた情報を使って、メッセージキューの属性を設定する。
.\"O The only attribute that can be modified is the setting of the
.\"O .B O_NONBLOCK
.\"O flag in
.\"O The other fields in
.\"O .I newattr
.\"O are ignored.
-Êѹ¹¤¹¤ë¤³¤È¤¬¤Ç¤¤ë°À¤Ï¡¢
+変更することができる属性は、
.I mq_flags
-¤Î
+の
.B O_NONBLOCK
-¥Õ¥é¥°¤ÎÀßÄê¤À¤±¤Ç¤¢¤ë¡£
+フラグの設定だけである。
.I newattr
-¤Î¾¤Î¥Õ¥£¡¼¥ë¥É¤Ï̵»ë¤µ¤ì¤ë¡£
+の他のフィールドは無視される。
.\"O If the
.\"O .I oldattr
.\"O field is not NULL,
.\"O structure that contains the same information that is returned by
.\"O .BR mq_getattr ().
.I oldattr
-¥Õ¥£¡¼¥ë¥É¤¬ NULL °Ê³°¤Î¾ì¹ç¡¢
+フィールドが NULL 以外の場合、
.BR mq_getattr ()
-¤¬ÊÖ¤¹¤Î¤ÈƱ¤¸¾ðÊó¤ò³ÊǼ¤·¤¿
+が返すのと同じ情報を格納した
.I mq_attr
-¹½Â¤ÂΤò
+構造体を
.I oldattr
-¤¬»Ø¤¹¥Ð¥Ã¥Õ¥¡¤ËÆþ¤ì¤ÆÊÖ¤¹¡£
+が指すバッファに入れて返す。
.\"O .SH RETURN VALUE
-.SH ÊÖ¤êÃÍ
+.SH 返り値
.\"O On success
.\"O .BR mq_getattr ()
.\"O and
.\"O return 0; on error, \-1 is returned, with
.\"O .I errno
.\"O set to indicate the error.
-À®¸ù¤¹¤ë¤È¡¢
+成功すると、
.I mq_getattr ()
-¤È
+と
.I mq_setattr ()
-¤Ï 0 ¤òÊÖ¤¹¡£¥¨¥é¡¼¤Î¾ì¹ç¡¢\-1 ¤òÊÖ¤·¡¢
+は 0 を返す。エラーの場合、\-1 を返し、
.I errno
-¤Ë¥¨¥é¡¼¤ò¼¨¤¹ÃͤòÀßÄꤹ¤ë¡£
+にエラーを示す値を設定する。
.\"O .SH ERRORS
-.SH ¥¨¥é¡¼
+.SH ã\82¨ã\83©ã\83¼
.TP
.B EBADF
.\"O The descriptor specified in
.\"O .I mqdes
.\"O is invalid.
.I mqdes
-¤Ç»ØÄꤵ¤ì¤¿µ½Ò»Ò¤¬ÉÔÀµ¤Ç¤¢¤ë¡£
+で指定された記述子が不正である。
.TP
.B EINVAL
.\"O .I newattr\->mq_flags
.\"O contained set bits other than
.\"O .BR O_NONBLOCK .
.I newattr\->mq_flags
-¤Ë
+に
.B O_NONBLOCK
-°Ê³°¤Î¥Ó¥Ã¥È¤¬¥»¥Ã¥È¤µ¤ì¤Æ¤¤¤¿¡£
+以外のビットがセットされていた。
.\"O .SH CONFORMING TO
-.SH ½àµò
+.SH 準拠
POSIX.1-2001.
.\"O .SH NOTES
-.SH Ãí°Õ
+.SH 注意
.\"O On Linux,
.\"O .BR mq_getattr ()
.\"O and
.\"O are library functions layered on top of the
.\"O .BR mq_getsetattr (2)
.\"O system call.
-Linux ¤Ç¤Ï¡¢
+Linux では、
.BR mq_getattr ()
-¤È
+と
.BR mq_setattr ()
-¤Ï¥é¥¤¥Ö¥é¥ê´Ø¿ô¤Ç¤¢¤ê¡¢
+はライブラリ関数であり、
.BR mq_getsetattr (2)
-¥·¥¹¥Æ¥à¥³¡¼¥ë¤òÍѤ¤¤Æ¼ÂÁõ¤µ¤ì¤Æ¤¤¤ë¡£
+システムコールを用いて実装されている。
.\"O .SH "SEE ALSO"
-.SH ´ØÏ¢¹àÌÜ
+.SH 関連項目
.BR mq_close (3),
.BR mq_notify (3),
.BR mq_open (3),