.\" $NetBSD: msgget. 2, v 1.1 1995/10/16 23:49:19 jtc Exp $ .\" .\" Copyright (c) 1995 Frank van der Linden .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. All advertising materials mentioning features or use of this software .\" must display the following acknowledgement: .\" This product includes software developed for the NetBSD Project .\" by Frank van der Linden .\" 4. The name of the author may not be used to endorse or promote products .\" derived from this software without specific prior written permission .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" %FreeBSD: src/lib/libc/gen/msgget. 3, v 1.7. 2.4 2001/12/14 18:33:51 ru Exp % .\" .\"/ .\" $FreeBSD: doc/ja_JP.eucJP/man/man3/msgget. 3, v 1.5 2002/11/03 06:38:28 horikawa Exp $ .Dd August 17, 1995 .Dt MSGGET 3 .Os .Sh 명칭 .Nm msgget .Nd 메시지 큐의 취득 .Sh 프로그램 라이브러리 .Lb libc .Sh 서식 .In sys/types.h .In sys/ipc.h .In sys/msg.h .Ft int .Fn msgget "key_t key" "int msgflg" .Sh 해설 .Fn msgget (은)는, .Fa key 에 관련하는 메시지 큐 ID 를 되돌립니다. 메시지 큐 ID 는, 0 보다 큰 일의적인 정수입니다. .Pp 메시지 큐는, .Fa key 하지만 .Dv IPC_PRIVATE (와)과 동일한 경우, 또는 .Fa key 에 관련하는 메시지 큐 ID 가 존재하지 않고, 한편, .Dv IPC_CREAT 비트가 .Fa msgflg 그리고 설정되어 있는 경우에 작성됩니다. .Pp 새로운 메시지 큐가 작성되었을 경우, 관련하는 데이터 구조 ( .Fa msqid_ds 구조체. .Xr msgctl 3 참조)는, 이하와 같이 초기화됩니다. .Bl -bullet .It .Va msg_perm.cuid (와)과 .Va msg_perm.uid (은)는, 호출 프로세스의 실효 유저 ID 로 설정됩니다. .It .Va msg_perm.gid (와)과 .Va msg_perm.cgid (은)는, 호출 프로세스의 실효 그룹 ID 로 설정됩니다. .It .Va msg_perm.mode (은)는, .Fa msgflg 의 하위 9 비트가 설정됩니다. .It .Va msg_cbytes , .Va msg_qnum , .Va msg_lspid , .Va msg_lrpid , .Va msg_rtime , .Va msg_stime 에는 0 이 설정됩니다. .It .Va msg_qbytes (은)는, 큐의 바이트수 .Pf ( Dv MSGMNB ) 에 대한 시스템의 최대치가 설정됩니다. .It .Va msg_ctime (은)는, 현재의 시각으로 설정됩니다. .El .Sh 반환값 문제 없게 종료하면(자), 정의 메시지 큐 ID 가 되돌려집니다. 문제 없고 종료하지 않으면 -1 이 되돌려져 글로벌 변수 .Va errno 하지만 그 에러를 나타내도록(듯이) 설정됩니다. .Sh 에러 .Bl -tag -width Er .It Bq Er EACESS 메시지 큐가 .Fa key (와)과 벌써 관련하고 있습니다만, 소환 측에 액세스권이 없습니다. .It Bq Er EEXIST .Dv IPC_CREAT (와)과 .Dv IPC_EXCL 의 양쪽 모두가 .Fa msgflg 그리고 설정되어 있어 메시지 큐가 .Fa key (와)과 벌써 관련하고 있습니다. .It Bq Er ENOSPC 메시지 큐의 수에 관한 시스템 제한에 이르고 있기 (위해)때문에, 새로운 메시지 큐를 작성할 수 없습니다. .It Bq Er ENOENT .Fa msgflg 에 .Dv IPC_CREAT 하지만 설정되어 있지 않은 상황으로, .Fa key 에 관련하는 메시지 큐가 발견되지 않습니다. .El .Sh 관련 항목 .Xr msgctl 3 , .Xr msgrcv 3 , .Xr msgsnd 3 .Pp .Sh 역사 메시지 큐는, .At V 의 최초의 릴리스에 추가되었습니다. .\"kuma 1999-11-12