other versions
other sections
MQ_GETATTR(3) | Linux Programmer's Manual | MQ_GETATTR(3) |
名前¶
mq_getattr, mq_setattr - メッセージキューの属性を設定/取得する書式¶
#include <mqueue.h>int mq_getattr(mqd_t mqdes, struct mq_attr *attr); int mq_setattr(mqd_t mqdes, struct mq_attr *newattr, struct mq_attr *oldattr);
説明¶
mq_getattr() と mq_setattr() は、記述子 mqdes で参照されるメッセージキューの属性の取得と変更をそれぞれ行う。struct mq_attr { long mq_flags; /* フラグ: 0 か O_NONBLOCK */ long mq_maxmsg; /* キューの最大メッセージ数 */ long mq_msgsize; /* 最大メッセージサイズ (バイト単位) */ long mq_curmsgs; /* キューに現在入っているメッセージ数 */ };
mq_flags フィールドには、オープンメッセージキュー記述 (open message queue description) に関連付けられているフラグが格納される。 このフィールドは mq_open(3) でキューが作成される際に初期化される。 このフィールドに現れるフラグは O_NONBLOCK だけである。
返り値¶
成功すると、 mq_getattr () と mq_setattr () は 0 を返す。エラーの場合、-1 を返し、 errno にエラーを示す値を設定する。エラー¶
- EBADF
- mqdes に指定されたディスクリプタが不正である。
- EINVAL
- newattr->mq_flags に O_NONBLOCK 以外のビットがセットされていた。
準拠¶
POSIX.1-2001.注意¶
Linux では、 mq_getattr() と mq_setattr() はライブラリ関数であり、 mq_getsetattr(2) システムコールを用いて実装されている。関連項目¶
mq_close(3), mq_notify(3), mq_open(3), mq_receive(3), mq_send(3), mq_unlink(3), mq_overview(7)この文書について¶
この man ページは Linux man-pages プロジェクトのリリース 3.41 の一部 である。プロジェクトの説明とバグ報告に関する情報は http://www.kernel.org/doc/man-pages/ に書かれている。2010-08-29 | Linux |