.\" 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_key_create. 3, v 1.6. 2.5 2001/12/17 10:08:26 ru Exp % .\" .\" $FreeBSD: doc/ja_JP.eucJP/man/man3/pthread_key_create. 3, v 1.5 2002/05/18 07:12:56 horikawa Exp $ .Dd April 4, 1996 .Dt PTHREAD_KEY_CREATE 3 .Os .Sh 명칭 .Nm pthread_key_create .Nd thread 고유의 데이터 키의 작성 .Sh 프로그램 라이브러리 .Lb libc_r .Sh 서식 .In pthread.h .Ft int .Fn pthread_key_create "pthread_key_t *key" "void (*destructor)(void *)" .Sh 해설 .Fn pthread_key_create 함수는, 프로세스내의 모든 thread에 가시의 thread 고유의 데이터 키를 작성합니다. .Fn pthread_key_create 에 의해 제공된 키의 값은, thread 고유의 데이터의 위치를 나타내기 위해서(때문에) 사용되는 불투명한 오브젝트입니다. 다른 thread에 의해 같은 키치가 사용되는 것이 가능합니다만, .Fn pthread_setspecific 에 의해 키에 묶을 수 있었던 값은 thread마다를 기준에 메인트넌스되어 호출하고 있는 thread가 살아 있는 동안 존속합니다. .Pp 키의 작성시에는, 모든 액티브한 thread내의 새로운 키에, 값 NULL 가 관련지을 수 있습니다. thread의 작성시에는, 새로운 thread내의 모든 정의제의 키에, 값 NULL 가 관련지을 수 있습니다. .Pp 임의의 소멸자 함수는, 개개의 키의 값과 관련지을 수 있을 수가 있습니다. thread의 종료시에, 키치가 NULL 가 아닌 소멸자의 포인터를 가져, 한편 thread를 키에 관련지을 수 있었던 NULL 가 아닌 값을 가지고 있는 경우에는, 현재 관련지을 수 있고 있는 값을 유일한 인수로서 가리켜지고 있는 함수가 불려 갑니다. thread의 종료시에 그 thread를 위한 1 개 이상의 소멸자 함수가 존재하는 경우에는, 소멸자의 호출의 순서는 미규정입니다. .Pp 소멸자에 관련지을 수 있던 모든 NULL 가 아닌 값을 위해서(때문에), 모든 소멸자가 불려 간 다음에, 아직 몇개의 관련지을 수 있었던 소멸자를 가지는 NULL 가 아닌 값이 있는 경우에는, 그 과정이 반복해집니다. 최악이어도 [PTHREAD_DESTRUCTOR_ITERATIONS] 회의 소멸자의 호출의 반복의 후에, 아직 더 몇개의 관련지을 수 있었던 소멸자를 가지는 NULL 가 아닌 값이 있는 경우에는, 실장은 소멸자의 호출을 중지합니다. .Sh 반환값 문제가 없는 경우는, .Fn pthread_key_create 함수는, 새롭게 작성된 키의 값을 .Fa key 그리고 지정된 장소에 격납해, 0 을 돌려줍니다. 문제가 있는 경우는, 그 에러를 나타내기 위해서(때문에) 에러 번호가 돌려주어집니다. .Sh 에러 .Fn pthread_key_create (은)는 이하의 경우에 실패합니다. .Bl -tag -width Er .It Bq Er EAGAIN 다른 thread 고유의 데이터 키를 작성하기 위해서 필요한 리소스가 시스템에 부족합니다. 또는, 1 개의 프로세스마다의 키의 총수에 대한 시스템의 제한 [PTHREAD_KEYS_MAX] 를 초과했습니다. .It Bq Er ENOMEM 키를 작성하기 위한 충분한 메모리가 없습니다. .El .Sh 관련 항목 .Xr pthread_getspecific 3 , .Xr pthread_key_delete 3 , .Xr pthread_setspecific 3 .Sh 표준 .Fn pthread_key_create 하 .St -p1003.1-96 에 적합하고 있습니다.