.\" Copyright (c) 1996-1998 John Birrell . .\" 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 by John Birrell. .\" 4. Neither the name of the author nor the names of any co-contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY JOHN BIRRELL 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 REGENTS 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_join. 3, v 1.7. 2.5 2001/12/17 10:08:26 ru Exp % .\" .\" $FreeBSD: doc/ja_JP.eucJP/man/man3/pthread_join. 3, v 1.5 2002/05/18 07:12:56 horikawa Exp $ .Dd April 4, 1996 .Dt PTHREAD_JOIN 3 .Os .Sh 명칭 .Nm pthread_join .Nd thread 종료의 대기 .Sh 프로그램 라이브러리 .Lb libc_r .Sh 서식 .In pthread.h .Ft int .Fn pthread_join "pthread_t thread" "void **value_ptr" .Sh 해설 .Fn pthread_join 함수는, 대상 .Fa thread 하지만 아직 종료하고 있지 않는 경우에는, 그 대상 .Fa thread (이)가 종료될 때까지, 호출하고 있는 thread의 실행을 보류합니다. .Pp NULL 는 아니다 .Fa value_ptr 인수를 가진다 .Fn pthread_join 의 호출로부터 성공리로 돌아왔을 때에는, 종료한 thread에 의해 .Fn pthread_exit 에게 건네진 값이, .Fa value_ptr 에 의해 참조되는 위치에 격납됩니다. .Fn pthread_join 하지만 성공리로 돌아왔을 때에는, 그 대상 thread는 이미 종료하고 있습니다. 같은 대상 thread를 지정한 복수로 동시의 .Fn pthread_join 의 호출에 의한 결과는, 미정도리입니다. .Fn pthread_join (을)를 호출하고 있는 thread가 삭제되었을 경우에는, 그 대상 thread는 데탓치 되지 않습니다. .Pp 이미 종료했지만 가져 받고 되지 않고 남아 있는 thread는, [_POSIX_THREAD_THREADS_MAX] 에 대해서 카운트 됩니다. .Pp .Sh 반환값 문제가 없는 경우는, .Fn pthread_join 함수는 0 을 돌려줍니다. 문제가 있는 경우는, 그 에러를 나타내기 위해서(때문에) 에러 번호가 돌려주어집니다. .Sh 에러 .Fn pthread_join (은)는 이하의 경우에 실패합니다. .Bl -tag -width Er .It Bq Er EINVAL .Fa thread 에 의해 지정된 값이, 대기되는 것이 가능한 thread를 참조하고 있지 않는 것을 검출했습니다. .It Bq Er ESRCH 주어진 thread ID, .Fa thread 에 의해 지정된 것과 일치하는 thread를 찾아낼 수가 없습니다. .It Bq Er EDEADLK 데드 록을 검출했습니다. 또는, .Fa thread 의 값이 호출하고 있는 thread를 지정해 있습니다. .El .Pp .Sh 관련 항목 .Xr wait 2 , .Xr pthread_create 3 .Sh 표준 .Fn pthread_join 하 .St -p1003.1-96 에 적합하고 있습니다.