.\" $NetBSD: msgctl. 2, v 1.1 1995/10/16 23:49:15 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/msgctl. 3, v 1.8. 2.6 2001/12/14 18:33:51 ru Exp % .\"/ .\" $FreeBSD: doc/ja_JP.eucJP/man/man3/msgctl. 3, v 1.5 2002/11/03 06:38:28 horikawa Exp $ .Dd November 24, 1997 .Dt MSGCTL 3 .Os .Sh 명칭 .Nm msgctl .Nd 메세지 제어 오퍼레이션 .Sh 프로그램 라이브러리 .Lb libc .Sh 서식 .In sys/types.h .In sys/ipc.h .In sys/msg.h .Ft int .Fn msgctl "int msqid" "int cmd" "struct msqid_ds *buf" .Sh 해설 .Fn msgctl 시스템 콜은, .Fa msqid 하지만 지정하는 메시지 큐에 대해서 제어 오퍼레이션을 실행합니다. .Pp 각 메시지 큐에는, 거기에 관련한 데이터 구조체가 있습니다. 그 일부는 .Fn msgctl 그리고 변경할 수 있습니다. .Fn msgctl 의 액션을 결정하는 데이터 구조도 있습니다. 이 데이터 구조체는 .Aq Pa sys/msg.h 그리고 정의되어 이하와 같은 멤버가 포함되어 있습니다 (그 외의 멤버도 있습니다). .Bd -literal struct msqid_ds { struct ipc_perm msg_perm; /* 메시지 큐의 퍼미션 비트 */ struct msg *msg_first; /* 큐의 최초의 메세지 */ struct msg *msg_last; /* 큐의 마지막 메세지 */ u_long msg_cbytes; /* 큐로 사용하고 있는 바이트수 */ u_long msg_qnum; /* 큐로 사용하고 있는 메세지수 */ u_long msg_qbytes; /* 큐로 사용하는 최대 바이트수 */ pid_t msg_lspid; /* 마지막 msgsnd 의 프로세스 ID */ pid_t msg_lrpid; /* 마지막 msgrcv 의 프로세스 ID */ time_t msg_stime; /* 마지막 msgsnd 의 시간 */ long msg_pad1; time_t msg_rtime; /* 마지막 msgrcv 의 시간 */ long msg_pad2; time_t msg_ctime; /* 마지막 msgctl 의 시간 */ long msg_pad3; long msg_pad4[4]; }; .Ed .Pp .Vt shmid_ds 구조체 중(안)에서 사용된다 .Vt ipc_perm 구조체는, .Aq Pa sys/ipc.h 그리고 이하와 같이 정의되고 있습니다. .Bd -literal struct ipc_perm { ushort cuid; /* 생성자의 유저 ID */ ushort cgid; /* 생성자의 그룹 ID */ ushort uid; /* 유저 ID */ ushort gid; /* 그룹 ID */ ushort mode; /* r/w 퍼미션 */ ushort seq; /* 순차 순서 번호 (일의에 생성된 msg/sem/shm ID) */ key_t key; /* 유저가 지정한 msg/sem/shm 키 */ }; .Ed .Pp .Fn msgctl 하지만 실행하는 오퍼레이션은, 이하 중 1 개로 .Fa cmd 그리고 지정됩니다. .Bl -tag -width IPC_RMIDX .It Dv IPC_STAT 메시지 큐의 정보를 모아 .Fa buf 하지만 가리키는 구조체에 배치합니다. .It Dv IPC_SET .Fa msqid 에 관련하는 구조체의 .Va msg_perm.uid 필드, .Va msg_perm.gid 필드, .Va msg_perm.mode 필드, .Va msg_qbytes 필드의 값을 설정합니다. 이 값은, .Fa buf 하지만 가리키는 구조체로 대응하는 필드로부터 놓칩니다. 이 오퍼레이션을 실행할 수 있는 것은, 슈퍼 유저, 또는 메시지 큐에 관련한다 데이터 구조체의 .Va msg_perm.cuid 인가 .Va msg_perm.uid (와)과 동일한 실효 유저 ID 를 가지는 프로세스만입니다. .Va msg_qbytes 의 값을 늘릴 수 있는 것은, 슈퍼 유저만입니다. 시스템 제한 ( .Aq Pa sys/msg.h 의 MSGMNB)를 넘었다 .Va msg_qbytes 의 값은, 그 제한으로 잘라 버릴 수 있습니다. .It Dv IPC_RMID .Fa msqid 하지만 지정하는 메시지 큐를 삭제해, .Fa msqid 에 관련한다 데이터를 파괴합니다. 슈퍼 유저, 또는, 큐에 관련하는 데이터 구조체의 .Va msg_perm.cuid 또는 .Va msg_perm.uid 의 값이, 실효 유저 ID 에 동일한 프로세스만이, 이것을 실행할 수 있습니다. .El .Pp 메시지 큐로부터의 독포함권이나 메시지 큐에의 기록권 ( .Xr msgsnd 3 (와)과 .Xr msgrcv 3 참조)는, 파일과 같이 ( .Xr chmod 2 참조), .Va msg_perm.mode 필드에 의해 정해집니다. 실효 유저 ID 는, .Va msg_perm.cuid 필드인가 .Va msg_perm.uid 필드와 일치해, 실효 그룹 ID 는, .Va msg_perm.cgid 인가 .Va msg_perm.gid (와)과 일치합니다. .Sh 반환값 .Rv -std msgctl .Sh 에러 .Fn msgctl (은)는, 이하와 같은 경우에 에러가 됩니다. .Bl -tag -width Er .It Bq Er EPERM .Fa cmd 하지만 IPC_SET 나 IPC_RMID 와 동일하고, 소환측이 슈퍼 유저가 아닌 경우. 또는 실효 유저 ID 가 메시지 큐에 관련하는 데이터 구조의 .Va msg_perm.uid 필드인가 .Va msg_perm.cuid 필드와 일치하지 않는 경우. .Pp IPC_SET 를 이용해 .Va msg_qbytes 의 값을 올리려고 했지만, 소환측이 슈퍼 유저가 아닌 경우. .It Bq Er EACCES 명령이 IPC_STAT 이지만, 이 메시지 큐의 독포함권이 소환 측에 없는 경우. .It Bq Er EINVAL .Fa msqid 하지만 올바른 메시지 큐 ID 가 아닌 경우. .Pp .Va cmd 하지만 올바른 명령이 아닌 경우. .It Bq Er EFAULT .Fa buf 하지만 올바른 주소를 지정하고 있지 않는 경우. .El .Sh 관련 항목 .Xr msgget 3 , .Xr msgrcv 3 , .Xr msgsnd 3 .Sh 역사 메시지 큐는, .At V 의 최초의 릴리스에 추가되었습니다. .\"kuma 1999-11-12