'\" t
.\" Hey Emacs! This file is -*- nroff -*- source.
.\"
.\" Copyright (C) 2006 Michael Kerrisk <mtk.manpages@gmail.com>
.\"
.\" 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.
.\"
.\" 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>
.\"
.TH MQ_OPEN 3 2006-02-25 "Linux" "Linux Programmer's Manual"
.SH ̾
mq_open \- å塼򥪡ץ󤹤
.SH 
.nf
.B #include <mqueue.h>
.sp
.BI "mqd_t mq_open(const char *" name ", int " oflag );
.BI "mqd_t mq_open(const char *" name ", int " oflag ", mode_t " mode ,
.BI "              struct mq_attr *" attr );
.fi
.sp
\fI\-lrt\fP ǥ󥯤롣
.SH 
.BR mq_open ()
ϡ POSIX å塼뤫¸Υ塼
ץ󤹤롣塼
.I name
Ǽ̤롣
.I name
ιξܺ٤ˤĤƤ
.B mq_overview (7)
򻲾ȡ

.I oflag
ˤϡؿƤӽФ椹ե饰ꤹ롣
.I oflag
ˤϡʲΤ줫ĤɬꤷʤФʤʤ
.TP
.B O_RDONLY
åμѤȤƥ塼򥪡ץ󤹤롣
.TP
.B O_WRONLY
åѤȤƥ塼򥪡ץ󤹤롣
.TP
.B O_RDWR
åξѤȤƥ塼򥪡ץ󤹤롣
.PP
0 İʾβΥե饰򡢥ӥåñ̤ OR () 
.I oflag
ɲäǻǤ롣
.TP
.B O_NONBLOCK
 (non-blocking) ⡼ɤǥ塼򥪡ץ󤹤롣
.BR mq_receive (3)

.BR mq_send (3)
ϡ̾ (block) ˤơ顼
.B EAGAIN
ǼԤ褦ˤʤ롣
.TP
.B O_CREAT
¸ߤʤ硢å塼롣
å塼νͭ (桼 ID) ȥ롼׽ͭ (롼 ID) ϡ
줾ƤӽФץμ¸桼 ID ȼ¸롼 ID ꤵ롣
.\" ºݤϡLinux Ǥϥե륷ƥ ID Ѥ롣
.TP
.B O_EXCL
.B O_CREAT

.I oflag
˻ꤵ졢Ļꤵ줿̾
.I name
ĥ塼Ǥ¸ߤ硢顼
.B EEXIST
ǼԤ롣
.PP
.I oflag

.B O_CREAT
ꤹ硢ɲä 2ĤΰͿɬפ롣
.I mode
ϡ塼ŬѤ (permission) 
.BR open (2)
Ʊ褦˻ꤹ롣
ϥץ umask ǥޥ롣
.I attr
ϡ塼°ꤹ롣ܺ٤ϡ
.BR mq_getattr (3)
򻲾ȡ
.I attr
 NULL ξ硢塼ϼ줿ǥե°Ǻ롣
.SH ֤
ȡ
.BR mq_open ()
ϥå塼һ (message queue descriptor) ֤
å塼һҤ¾Υå塼ϢδؿǻѤ롣
顼ξ硢
.BR mq_open ()

.I "(mqd_t)\ \-1"
֤
.I errno
˥顼򼨤ͤꤹ롣
.SH 顼
.TP
.B EACCES
塼¸ߤ뤬ƤӽФꤵ줿⡼ɤǤΥ塼
򥪡ץ󤹤Ĥʤ
.TP
.B EEXIST
.I oflag

.B O_CREAT

.B O_EXCL
ξꤵ줿ꤵ줿̾
.I name
ĥ塼Ǥ¸ߤ롣
.TP
.B EINVAL
.I oflag

.B O_CREAT
ꤵ졢
.I attr
 NULL ʳ
.I attr\->mq_maxmsg

.I attr\->mq_msqsize
Ǥä
ΥեɤξȤ 0 礭ʤФʤʤ
ץøʤ
.RB ( CAP_SYS_RESOURCE
ѥӥƥʤ) 硢
.I attr\->mq_maxmsg

.I attr\->mq_msgsize
ϡ줾
.IR msg_max 
.I msgsize_max
ʲǤʤФʤʤ
ޤøץξǤ⡢
.I attr\->mq_maxmsg

.B HARD_MAX
¤Ķ뤳ȤϤǤʤ
(ξ¤˴ؤܺ٤
.BR mq_overview (7)
򻲾ȡ)
.TP
.B EMFILE
Υץץ󤷤Ƥեȥå塼ο
ץξ¤ãƤ롣
.TP
.B ENAMETOOLONG
.I name
Ĺ롣
.TP
.B ENFILE
ƥΤǥץ󤷤Ƥեȥå塼ι׿
ƥ¤ãƤ롣
.TP
.B ENOENT
.B O_CREAT
ե饰
.I oflag
˻ꤵʤäꤵ줿̾
.I name
ĥ塼¸ߤʤ
.TP
.B ENOMEM
ʬʥ꤬ʤ
.TP
.B ENOSPC
å塼Τ˽ʬʶ֤ʤ
Υ顼Ϥ餯
.I queues_max
¤񿨤ᵯäΤ
.BR mq_overview (7)
򻲾ȡ
.SH 
POSIX.1-2001.
.SH Х
2.6.14 Υͥˤϡ
ץ umask 
.I mode
ǻꤵ줿ŬѤʤä
.SH Ϣ
.BR mq_close (3),
.BR mq_getattr (3),
.BR mq_notify (3),
.BR mq_receive (3),
.BR mq_send (3),
.BR mq_unlink (3),
.BR mq_overview (7)