.\"   Copyright (C) 1996-1999 Free Software Foundation, Inc.
.\"
.\"   Permission is granted to make and distribute verbatim copies of
.\" this manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
.\"
.\"   Permission is granted to copy and distribute modified versions of
.\" this manual under the conditions for verbatim copying, provided that
.\" the entire resulting derived work is distributed under the terms of a
.\" permission notice identical to this one.
.\"
.\"   Permission is granted to copy and distribute translations of this
.\" manual into another language, under the above conditions for modified
.\" versions, except that this permission notice may be stated in a
.\" translation approved by the Foundation.
.\"
.\" Copyright (C) 1996 Xavier Leroy.
.\"
.\" Japanese Version Copyright (C) 2002-2003 Suzuki Takashi
.\"         all rights reserved.
.\" Translated Wed Jan  1 20:52:15 JST 2003
.\"         by Suzuki Takashi.
.\"
.\"WORD:    thread attribute    å°
.\"WORD:    thread attribute object å°֥
.\"WORD:    joinable            ήǽ
.\"WORD:    detached            ǥå
.\"
.\"
.TH PTHREAD_ATTR_INIT 3 LinuxThreads


.SH "̾"
pthread_attr_init, pthread_attr_destroy, pthread_attr_setdetachstate, pthread_attr_getdetachstate, 
pthread_attr_setschedparam, pthread_attr_getschedparam, pthread_attr_setschedpolicy, pthread_attr_getschedpolicy, 
pthread_attr_setinheritsched, pthread_attr_getinheritsched, pthread_attr_setscope, pthread_attr_getscope 
\- å°

.SH ""
.B #include <pthread.h>

.BI "int pthread_attr_init(pthread_attr_t *" attr ");"

.BI "int pthread_attr_destroy(pthread_attr_t *" attr ");"

.BI "int pthread_attr_setdetachstate(pthread_attr_t *" attr ", int " detachstate ");"

.BI "int pthread_attr_getdetachstate(const pthread_attr_t *" attr ", int *" detachstate ");"

.BI "int pthread_attr_setschedpolicy(pthread_attr_t *" attr ", int " policy ");"

.BI "int pthread_attr_getschedpolicy(const pthread_attr_t *" attr ", int *" policy ");"

.BI "int pthread_attr_setschedparam(pthread_attr_t *" attr ", const struct sched_param *" param ");"

.BI "int pthread_attr_getschedparam(const pthread_attr_t *" attr ", struct sched_param *" param ");"

.BI "int pthread_attr_setinheritsched(pthread_attr_t *" attr ", int " inherit ");"

.BI "int pthread_attr_getinheritsched(const pthread_attr_t *" attr ", int *" inherit ");"

.BI "int pthread_attr_setscope(pthread_attr_t *" attr ", int " scope ");"

.BI "int pthread_attr_getscope(const pthread_attr_t *" attr ", int *" scope ");"

.SH ""

åɤ°ꤹˤϡ
.B "pthread_attr_t"
Υå°֥
.I "attr"
ͤǼ
.BR "pthread_create" (3)
 2 ȤϤФ褤
.B "NULL"
ϤȤϡ
٤Ƥ°ǥեȤꤵ줿å°֥Ȥ
ϤΤƱǤ롣

.B "pthread_attr_init"
ϥå°֥
.I "attr"
ơ°ΥǥեȤͤǼ롣
( °Υǥեͤϲ򻲾ȤΤȡ )

줾°
.I "attrname"
( °ΥꥹȤϲ򻲾ȤΤ ) ϡ
ؿ
.BI "pthread_attr_set" "attrname"
Ǹ̤ꤷꡢ
.BI "pthread_attr_get" "attrname"
Ǹ̤˼ꤹ뤳ȤǽǤ롣

.B "pthread_attr_destroy"
ϥå°֥Ȥ˲롣
˲֥ȤϡƽޤǤ
ƤӻѤƤϤʤʤ
.B "pthread_attr_destroy"
 LinuxThreads μǤϲ⤷ʤ

°֥ȤϿåɤȤˤȤ롣
ʣΥåɤƱ°֥ȤѤ뤳ȤǤ롣
.B "pthread_create"
θƤӽФθ°֥ȤѹƤ⡢
Ǥ줿åɤ°Ѳʤ

Τ褦ʥå°бƤ:

.SS detachstate (ǥå)

åɤήǽʾ֤ (
.BR "PTHREAD_CREATE_JOINABLE" )
ǥå֤ (
.BR "PTHREAD_CREATE_DETACHED" )
椹롣

ǥե: 
.B "PTHREAD_CREATE_JOINABLE"


ήǽʾ֤ξ硢
̤Υåɤ
.BR "pthread_join" (3)
ƤӽФȤˤäơΥåɤνλƱ
λɤ뤳ȤǤ롣
åɤλ񸻤ΰϥåɤλ
ݤ줿ޤ޻Ĥꡢ
̤ΥåɤΥåɤФ
.BR "pthread_join" (3)
ƤӽФȤ˸¤äƲ롣

ǥå֤ξ硢åɤλ񸻤Ͻλľ˲롣

.BR "pthread_join" (3)
ѤƥåɤνλƱ뤳ȤϤǤʤ

ήǽʾ֤줿åɤϡ
.BR "pthread_detach" (3)
ƤӽФƥǥååɤѹ뤳ȤǤ롣

.SS schedpolicy (塼󥰥ݥꥷ)

åɤΥ塼󥰥ݥꥷ򤹤롣
Ȥꤦͤ
.B "SCHED_OTHER"
(̾Ρꥢ륿Ǥʤ塼) 
.B "SCHED_RR"
(饦ɥӥΥꥢ륿ॹ塼) 
.B "SCHED_FIFO"
(Ф (FIFO) Υꥢ륿ॹ塼) Τ줫Ǥ롣
塼󥰥ݥꥷ˴ؤ뤵ʤˤĤƤ
.BR "sched_setpolicy" (2)
򻲾ȤΤȡ

ǥե:
.B "SCHED_OTHER"


ꥢ륿ॹ塼󥰥ݥꥷǤ
.B "SCHED_RR"

.B "SCHED_FIFO"
ϡѡ桼¤Υץ˸¤äƻѤǤ롣

åɤΥ塼󥰥ݥꥷϡ

.BR "pthread_setschedparam" (3)
Ѥѹ뤳ȤǤ롣

.SS schedparam (塼󥰥ѥ᡼)

åɤΥ塼󥰥ѥ᡼ (äˡ塼ͥ) 
ꤹ롣
塼󥰥ѥ᡼˴ؤ뤵ʤˤĤƤ
.BR "sched_setparam" (2)
򻲾ȤΤȡ

ǥե: ͥ٤ 0 

°ϥ塼󥰥ݥꥷ
.BR "SCHED_OTHER"
λˤϰ̣
ꥢ륿ݥꥷ
.B "SCHED_RR"

.B "SCHED_FIFO"
ФƤΤͭǤ롣

åɤΥ塼ͥ٤ϡ

.BR "pthread_setschedparam" (3)
Ѥѹ뤳ȤǤ롣

.SS inheritsched (塼󥰤ηѾ)

륹åɤ
塼󥰥ݥꥷȥ塼󥰥ѥ᡼
°
.I "schedpolicy"

.I "schedparam"
ͤǷꤵ (
.BR "PTHREAD_EXPLICIT_SCHED" )
ƥåɤѾ (
.BR "PTHREAD_INHERIT_SCHED" )
ꤹ롣

ǥե: 
.B "PTHREAD_EXPLICIT_SCHED"


.SS scope ()

륹åɤΥ塼󥰶襹פ롣
LinuxThreads μͣбƤͤ
.B "PTHREAD_SCOPE_SYSTEM"
ǡ
åɤƱ׻Ǽ¹Τ٤ƤΥץ CPU ֤礦
ܤСåɤͥ٤Ϸ׻¾Τ٤ƤΥץͥ٤
ƱΤΤȲᤵ롣
POSIX ɸǵꤵ⤦ 1 Ĥ
.B "PTHREAD_SCOPE_PROCESS"
ϡ
塼󥰤ζϼ¹ΥץΥåɴ֤
뤳Ȥ̣롣
ʤåɤͥ٤ϥץ¾Υåɤͥ٤
ƱΤΤȲᤵ졢¾Υץͥ٤Ȥϴؤ꤬ʤ
LinuxThreads 
.B "PTHREAD_SCOPE_PROCESS"
бƤʤ

ǥե: 
.B "PTHREAD_SCOPE_SYSTEM"


.SH "֤"

٤Ƥδؿ 0 ֤
顼ʤ 0 Υ顼ɤ֤
ξ硢
ؿ
.BI "pthread_attr_get" "attrname"
°
.I "attrname"
θߤͤ 2 ǻؤΰ˳Ǽ롣

.SH "顼"

ؿ
.B "pthread_attr_setdetachstate"
ϥ顼ξ硢Τ褦ʥ顼ɤ֤:
.RS
.TP
.B "EINVAL"
ꤵ줿
.I "detachstate"

.B "PTHREAD_CREATE_JOINABLE"

.BR "PTHREAD_CREATE_DETACHED"
ΤǤʤ
.RE

ؿ
.B "pthread_attr_setschedparam"
ϥ顼ξ硢Τ褦ʥ顼ɤ֤:
.RS
.TP
.B "EINVAL"
.I "param"
ǻꤵ줿ͥ٤
ߤ
.I "attr"
Υ塼󥰥ݥꥷФϰ (
.B "SCHED_FIFO"

.B "SCHED_RR"
ξ 1  99 ޤǡ
.B "SCHED_OTHER"
ξ 0 Τ )
ĶƤ롣
.RE

ؿ
.B "pthread_attr_setschedpolicy"
ϥ顼ξ缡Τ褦ʥ顼ɤ֤:
.RS
.TP
.B "EINVAL"
ꤵ줿
.I "policy"

.B "SCHED_OTHER"

.B "SCHED_FIFO"

.B "SCHED_RR"
ΤǤʤ

.TP
.B "ENOTSUP"
.I "policy"

.B "SCHED_FIFO"
ޤ
.B "SCHED_RR"
ǤäơƤӽФץμ¸桼ѡ桼ǤϤʤ
.RE

ؿ
.B "pthread_attr_setinheritsched"
ϥ顼ξ缡Τ褦ʥ顼ɤ֤:
.RS
.TP
.B "EINVAL"
ꤵ줿
.I "inherit"

.B "PTHREAD_INHERIT_SCHED"

.B "PTHREAD_EXPLICIT_SCHED"
ΤǤʤ
.RE

ؿ
.B "pthread_attr_setscope"
ϥ顼ξ缡Τ褦ʥ顼ɤ֤:
.RS
.TP
.B "EINVAL"
ꤵ줿
.I "scope"

.B "PTHREAD_SCOPE_SYSTEM"

.B "PTHREAD_SCOPE_PROCESS"
ΤǤʤ

.TP
.B "ENOTSUP"
ꤵ줿
.I "scope"

.B "PTHREAD_SCOPE_PROCESS"
(̤б) Ǥ롣
.RE

.SH ""
Xavier Leroy <Xavier.Leroy@inria.fr>

.SH "Ϣ"
.BR "pthread_create" (3),
.BR "pthread_join" (3),
.BR "pthread_detach" (3),
.BR "pthread_setschedparam" (3).

[] glibc-linuxthreads κǿΥɥȤ Texinfo󶡤Ƥ롣
ʲ glibc-linuxthreads-2.3.1  Texinfo ե뤫ΰѤǡ
פɵƤ롣
glibc-linuxthreads-2.1 ʹ guardsize  stackaddr  stacksize 
glibc-linuxthreads-2.2 ʹ stack ɲä줿

.BI "int pthread_attr_setstackaddr(pthread_attr_t *" attr ", void *" stackaddr ");"

.BI "int pthread_attr_getstackaddr(const pthread_attr_t *" attr ", void **" stackaddr ");"

.SS stackaddr (åɥ쥹)
ץꥱåΥɥ쥹ꤹ롣
åΥ
.B "PTHREAD_STACK_MIN"
ʾǤʤФʤʤ

.BI "int pthread_attr_setstacksize(pthread_attr_t *" attr ", size_t " stacksize");"

.BI "int pthread_attr_getstacksize(const pthread_attr_t *" attr ", size_t *" stacksize ");"

.SS stacksize (å)
åɤФƳݤ륹åΥѹ롣
Ǿåꤷͤꤵ롣ñ̤ϥХȤǤ롣

ꤷͤƥκ祹åĶ硢
ޤ
.B "PTHREAD_STACK_MIN"
⾮硢
.B "pthread_attr_setstacksize"
ϼԤ
.B "EINVAL"
֤

.BI "int pthread_attr_setstack(pthread_attr_t *" attr ", void *" stackaddr ", size_t " stacksize ");"

.BI "int pthread_attr_getstack(const pthread_attr_t *" attr ", void **" stackaddr ", size_t *" stacksize ");"

.SS stack (å)
륹åɤѤ륢ץꥱå
ɥ쥹ȥξꤹ롣
ΰΥ١
.I "stackaddr"
ˡΰΥХñ̤
.I "stacksize"
˻ꤹ롣

.I "stacksize"
ͤ
.B "PTHREAD_STACK_MIN"
⾮
ƥκ祹åĶ硢
ޤ
.I "stackaddr"
ͤŬڤʥ饤ȤǤʤ硢
.B "pthread_attr_setstack"
ϼԤ
.B "EINVAL"
֤

.BI "int pthread_attr_setguardsize(pthread_attr_t *" attr ", size_t " guardsize ");"

.BI "int pthread_attr_getguardsize(const pthread_attr_t *" attr ", size_t *" guardsize ");"

.SS guardsize (ݸ)
åɤΥåݸΰκǾΥХñ̤ѹ롣
ǥեȤΥ 1 ڡǤ롣
ͤꤵ줿硢ꤷͰʾκǤᤤڡ˴ݤ롣
ͤ 0 ꤵ줿硢ΥåɤˤݸΰϺʤ
ݸΰȤƳݤ줿ΰϡåСե򸡽ФΤ
Ѥ롣äơ礭ʹ¤Τΰ򥹥å˳ݤ硢
åСե򸡽Ф뤿ˤϤ
礭ݸΰꤹɬפ롣

åɤȼΥåѤƤ(
.I "stackaddr"
°ꤵƤ) 
.I "guardsize"
°̵뤵롣

ꤷͤ
.I "stacksize"
Ķ硢
.B "pthread_attr_setguardsize"
ϼԤ
.B "EINVAL"
֤