.\" Copyright (c) 1998 Alex Nash .\" 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 AUTHOR AND CONTRIBUTORS ``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 OR CONTRIBUTORS 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_r/man/pthread_rwlock_rdlock. 3, v 1.2. 2.2 2001/12/17 10:08:26 ru Exp % .\" .\" $FreeBSD: doc/ja_JP.eucJP/man/man3/pthread_rwlock_rdlock. 3, v 1.6 2002/05/18 07:12:56 horikawa Exp $ .Dd August 4, 1998 .Dt PTHREAD_RWLOCK_RDLOCK 3 .Os .Sh 명칭 .Nm pthread_rwlock_rdlock , .Nm pthread_rwlock_tryrdlock .Nd 읽기용의 읽기 / 기록 락의 획득 .Sh 프로그램 라이브러리 .Lb libc_r .Sh 서식 .In pthread.h .Ft int .Fn pthread_rwlock_rdlock "pthread_rwlock_t *lock" .Ft int .Fn pthread_rwlock_tryrdlock "pthread_rwlock_t *lock" .Sh 해설 .Fn pthread_rwlock_rdlock 함수는, .Fa lock 그리고 주어진, 락이 현재 기록용으로 보관 유지되지 않고, 기록 thread가 현재 그 락으로 블록되어 있지 않은, 읽기용의 락을 획득합니다. 읽기용의 락을 곧바로 획득할 수 없는 경우에는, 호출하고 있는 thread는 그 락을 획득할 수 있을 때까지 블록 합니다. .Pp .Fn pthread_rwlock_tryrdlock 함수는, 같은 조작을 실행합니다만, 곧바로 락을 획득할 수 없다 (즉, 락이 기록용으로 보관 유지되고 있는, 또는 기다리고 있는 기록 thread가 있다) 경우에는, 블록 하지 않습니다. .Pp 1 개의 thread는 복수의 동시의 읽기용 락을 보관 유지할 수가 있습니다. 그 경우에는, 개개의 획득된 것 위해(때문에) .Fn pthread_rwlock_unlock 하지만 1 번씩 불려 가지 않으면 안됩니다. .Pp 호출하고 있는 thread가 기록용의 락을 보관 유지하고 있는 동안의, 읽기용의 락의 획득의 결과는, 미정도리입니다. .Sh 실장에 관한 주 기록측의 기아 상태를 막기 위해, 기록측이 독포함측보다 우선됩니다. .Sh 반환값 문제가 없는 경우는, .Fn pthread_rwlock_rdlock 및 .Fn pthread_rwlock_tryrdlock 함수는 0 을 돌려줍니다. 문제가 있는 경우는, 그 에러를 나타내기 위해서(때문에) 에러 번호가 돌려주어집니다. .Sh 관련 항목 .Xr pthread_rwlock_init 3 , .Xr pthread_rwlock_trywrlock 3 , .Xr pthread_rwlock_unlock 3 , .Xr pthread_rwlock_wrlock 3 .Sh 표준 .Fn pthread_rwlock_rdlock 및 .Fn pthread_rwlock_tryrdlock 함수는, .St -susv2 에 적합하고 있을 것입니다. .Sh 에러 .Fn pthread_rwlock_tryrdlock 함수는, 이하의 경우에 실패합니다. .Bl -tag -width Er .It Bq Er EBUSY 기록 thread가 락을 보관 유지하고 있다, 또는 블록 되고 있기 (위해)때문에, 락을 획득할 수 없습니다. .El .Pp .Fn pthread_rwlock_rdlock 및 .Fn pthread_rwlock_tryrdlock 함수는, 이하의 경우에 실패하는 일이 있습니다. .Bl -tag -width Er .It Bq Er EAGAIN .Fa lock 에 대한 읽기용의 락의 최대수를 이미 넘고 있기 (위해)때문에, 락을 획득할 수 없습니다. .It Bq Er EDEADLK 현재의 thread가 이미 기록용의 .Fa lock (을)를 소유하고 있습니다. .It Bq Er EINVAL .Fa lock 에 의해 지정된 값이 무효입니다. .It Bq Er ENOMEM 락 (정적으로 초기화된 락에만 적용)의 초기화를 위해서(때문에) 충분한 메모리가 없습니다. .El .Sh 역사 .Fn pthread_rwlock_rdlock 함수는, .Fx 3.0 그리고 처음 등장했습니다.