.\" .\" Copyright (c) 1995 David Hovemeyer .\" .\" 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. .\" .\" THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``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 DEVELOPERS 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/sys/semctl. 2, v 1.9. 2.6 2002/03/11 08:37:47 maxim Exp % .\" .\" $FreeBSD: doc/ja_JP.eucJP/man/man2/semctl. 2, v 1.8 2002/03/18 03:19:52 horikawa Exp $ .Dd September 12, 1995 .Dt SEMCTL 2 .Os .Sh 명칭 .Nm semctl .Nd semaphore 집합에 대한 조작을 제어한다 .Sh 프로그램 라이브러리 .Lb libc .Sh 서식 .In sys/types.h .In sys/ipc.h .In sys/sem.h .Ft int .Fn semctl "int semid" "int semnum" "int cmd" ... .Sh 해설 .Fn semctl (은)는, .Fa cmd 하지만 가리키는 조작을 .Fa semid 그리고 나타나는 semaphore 집합에 대해서 실행합니다. 어느 값의 .Fa cmd 에 대해서는, 4 번째의 인수 .Fa "union semun arg" 하지만 필요합니다. .Fa arg 파라미터를 사용하는 명령의 경우, .Fa "union semun" (은)는 다음과 같이 정의됩니다. .Bd -literal .\" .\" From : .\" union semun { int val; /* SETVAL 용의 값 */ struct semid_ds *buf; /* IPC_STAT 및 IPC_SET 용의 버퍼 */ u_short *array; /* GETALL 및 SETALL 용의 배열 */ }; .Ed .Pp 명령은 다음과 같이 실행됩니다. .\" .\" This section based on Stevens, _Advanced Programming in the UNIX .\" Environment_. .\" .Bl -tag -width IPC_RMIDXXX .It Dv IPC_STAT semaphore 집합의 .Fa "struct semid_ds" (을)를 취득해, .Fa arg.buf 하지만 가리키는 메모리에 보존합니다. .It Dv IPC_SET semaphore 집합의 .Fa "struct semid_ds" 의 멤버 .Fa sem_perm.uid , .Fa sem_perm.gid 및 .Fa sem_perm.mode (을)를, .Fa arg.buf 하지만 가리키는 구조체의 멤버와 일치하도록(듯이) 변경합니다. 호출원프로세스의 실효 유저 ID 는, .Fa sem_perm.uid 또는 .Fa sem_perm.cuid 의 어느 쪽일까하고 일치할 필요가 있는지, 또는 슈퍼 유저 특권을 가지고 있을 필요가 있습니다. .It IPC_RMID semaphore 집합을 즉시 시스템으로부터 삭제합니다. 호출원프로세스의 실효 유저 ID 가 semaphore 집합의 .Fa sem_perm.uid 또는 .Fa sem_perm.cuid (와)과 동일한지, 또는 프로세스가 슈퍼 유저 특권을 가지고 있을 필요가 있습니다. .It Dv GETVAL semaphore 번호 .Fa semnum 의 값을 돌려줍니다. .It Dv SETVAL semaphore 번호 .Fa semnum 의 값을 .Fa arg.val (으)로 설정합니다. .It Dv GETPID semaphore 번호 .Fa semnum 에 붙어 조작을 실행한 마지막 프로세스의 프로세스 ID 를 돌려줍니다. .It Dv GETNCNT semaphore 번호 .Fa semnum 의 값이 현재의 값보다 커지는 것을 기다리고 있는 프로세스의 수를 돌려줍니다. .It Dv GETZCNT semaphore 번호 .Fa semnum 의 값이 0 이 되는 것을 기다리고 있는 프로세스의 수를 돌려줍니다. .It Dv GETALL 집합내의 모든 semaphore의 값을 .Fa arg.array 하지만 가리키는 배열내에 취득합니다. .It Dv SETALL 집합내의 모든 semaphore의 값을 .Fa arg.array 하지만 가리키는 배열내의 값으로 설정합니다. .El .Pp .Fa "struct semid_ds" (은)는 다음과 같이 정의됩니다. .Bd -literal .\" .\" Taken straight from . .\" struct semid_ds { struct ipc_perm sem_perm; /* 조작 퍼미션 구조체 */ struct sem *sem_base; /* 집합내의 최초의 semaphore에의 포인터 */ u_short sem_nsems; /* 집합내의 semaphore의 수 */ time_t sem_otime; /* 마지막 조작 시각 */ long sem_pad1; /* SVABI/386 에 밤과 이것이 필요 */ time_t sem_ctime; /* 마지막 변경 시각 * 1970/01/01 00:00:00 GMT * (으)로부터의 초단위의 경과시간 */ long sem_pad2; /* SVABI/386 에 밤과 이것이 필요 */ long sem_pad3[4]; /* SVABI/386 에 밤과 이것이 필요 */ }; .Ed .Sh 반환값 처리가 정상적으로 완료하면(자), .Fa cmd 하지만 .Dv GETVAL , .Dv GETPID , .Dv GETNCNT , .Dv GETZCNT 의 어떤 것인가일 때, .Fn semctl (은)는 대응하는 값을 돌려줍니다. 그렇지 않은 경우는 0 을 돌려줍니다. 처리에 실패했을 경우는,-1 을 돌려주어, 에러를 나타내기 위해서(때문에) .Va errno (을)를 설정합니다. .Sh 에러 .Fn semctl (은)는 다음의 경우에 처리에 실패합니다. .Bl -tag -width Er .It Bq Er EINVAL .Fa semid 에 대응하는 semaphore 집합이 없습니다. .It Bq Er EINVAL .Fa semnum 하지만, 지정의 semaphore 집합에 대해서 유효한 semaphore의 범위내에 없습니다. .It Bq Er EPERM 호출원프로세스의 실효 유저 ID 가, semaphore 집합의 소유자 또는 작성자의 유저 ID 와 일치하지 않습니다. .It Bq Er EACCES 조작과 semaphore 집합의 모드의 사이에 불일치가 있었기 때문에 퍼미션이 거부되었습니다. .El .Sh 관련 항목 .Xr semget 2 , .Xr semop 2