.\" Copyright (c) 1996 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_create. 3, v 1.9. 2.5 2001/12/17 10:08:26 ru Exp % .\" .\" $FreeBSD: doc/ja_JP.eucJP/man/man3/pthread_create. 3, v 1.6 2002/05/18 07:12:56 horikawa Exp $ .Dd April 4, 1996 .Dt PTHREAD_CREATE 3 .Os .Sh 명칭 .Nm pthread_create .Nd 새로운 thread의 작성 .Sh 프로그램 라이브러리 .Lb libc_r .Sh 서식 .In pthread.h .Ft int .Fn pthread_create "pthread_t *thread" "const pthread_attr_t *attr" "void *(*start_routine)(void *)" "void *arg" .Sh 해설 .Fn pthread_create 함수는, 프로세스내에 .Fa attr 에 의해 지정된 속성을 가지는 새로운 thread를 작성하기 위해서 사용됩니다. .Fa attr 하지만 .Dv NULL 인 경우에는, 디폴트의 속성이 사용됩니다. .Fa attr 에 의해 지정된 속성이 나중에 갱신되었을 경우에는, thread의 속성은 변화하지 않습니다. 문제 없게 완료하면(자), .Fn pthread_create 하 .Fa thread 에 의해 지정된 장소에 작성된 thread의 ID 를 격납합니다. .Pp thread는, .Fa arg (을)를 유일한 인수로서 .Fa start_routine (을)를 실행하는 것으로 작성됩니다. .Fa start_routine 하지만 돌아왔을 경우에는, .Fa start_routine 의 반환값을 종료 스테이터스로서 사용해, 암묵중에 .Fn pthread_exit (을)를 호출한 것 같은 효과가 있습니다. .Fn main (을)를 최초로에 실행한 thread는, 이것과는 다른 것에 주의해 주세요. 그 thread가 .Fn main (으)로부터 돌아왔을 때에는, .Fn main 의 반환값을 종료 스테이터스로서 사용해, 암묵중에 .Fn exit (을)를 호출한 것 같은 효과가 있습니다. .Pp 새로운 thread의 시그널 상태는, 이하와 같이 초기화됩니다. .Bl -bullet -offset indent .It 시그널 마스크는 작성한 thread로부터 계승됩니다. .It 새로운 thread용으로 보류하고 있는 시그널세트는 하늘입니다. .El .Sh 반환값 문제가 없는 경우는, .Fn pthread_create 함수는 0 을 돌려줍니다. 문제가 있는 경우는, 그 에러를 나타내기 위해서(때문에) 에러 번호가 돌려주어집니다. .Sh 에러 .Fn pthread_create (은)는 이하의 경우에 실패합니다. .Bl -tag -width Er .It Bq Er EAGAIN 다른 thread를 작성하기 위해서 필요한 리소스가 시스템에 부족합니다. 또는, 1 개의 프로세스내의 총thread수에 대한 시스템의 제한 [PTHREAD_THREADS_MAX] 를 초과했습니다. .It Bq Er EINVAL .Fa attr 에 의해 지정된 값이, 유효하지는 않습니다. .El .Pp .Sh 관련 항목 .Xr fork 2 , .Xr pthread_cleanup_pop 3 , .Xr pthread_cleanup_push 3 , .Xr pthread_exit 3 , .Xr pthread_join 3 .Sh 표준 .Fn pthread_create 하 .St -p1003.1-96 에 적합하고 있습니다.