HP-UX Reference (11i v3 07/02) - 3 Library Functions N-Z (vol 7)

p
pthread_attr_getdetachstate(3T) pthread_attr_getdetachstate(3T)
(Pthread Library)
ATTRIBUTE: rsestacksize
The legal values for the rsestacksize are:
rsestacksize
This defines the size (in bytes) of the register stack for the threads created with the attributes
object.
pthread_attr_setrsestacksize_np()
is used to set the register stack size for a thread and
pthread_default_rsestacksize_np()
to set the default register stack size. If either of the set
register stack size APIs is called, the register stack portion of the stack space will be that large instead of
implementation defined division. The memory stack portion will be the remainder.
pthread_attr_getrsestacksize_np()
retrieves the value of the rsestacksize attribute from the
thread attributes object attr. This value is returned in the rsestacksize parameter.
ATTRIBUTE: stackaddr
The legal values for the stackaddr attribute are:
NULL This option specifies that the storage for the user stack of any threads created with this attri-
butes object will be allocated and deallocated by the threads library. The application does not
need to allocate and manage thread stacks.
stack_address
This option specifies the base address of a stack that the created thread will use. The applica-
tion is completely responsible for allocating, managing, and deallocating these stacks. Some
options for allocation of storage are the malloc(3C), brk(2), and mmap(2) functions. Note: if
this option is used, only one thread should be created with this attributes object. If multiple
threads are created, they will all use the same stack.
The default value of the stackaddr attribute is NULL.
pthread_attr_setstackaddr()
is used to set the stackaddr attribute in the initialized attributes
object attr. The new value of the stackaddr attribute is passed to this function in the stackaddr parameter.
If the size of stack pointed to by stackaddr is different from the default stack size, the application must call
pthread_attr_setstacksize()
to set the new stack size.
pthread_attr_getstackaddr()
retrieves the value of the stackaddr attribute from the thread
attributes object attr. This value is returned in the stackaddr parameter.
The guardsize attribute is ignored if the storage for the thread’s user stack is not allocated by the library
(i.e., the stackaddr attribute is not NULL).
ATTRIBUTE: guardsize
The guardsize attribute allows an application to specify the size of the guard area for threads created with
this attributes object. The size of the guard area is specified in bytes. Most systems will round up the
guard size to a multiple of the system configurable variable
PAGESIZE. If the value zero is specified, a
guard area will not be created.
The default value of guardsize is PAGESIZE bytes. The actual value of PAGESIZE is implementation-
dependent and may not be the same on all implementations. The guardsize attribute is ignored if the
storage for the user stack is not allocated by the pthread library. The application is responsible for protect-
ing against stack overflow.
pthread_attr_setguardsize() is used to set the guardsize attribute in the initialized attributes
object attr. The new value of the guardsize attribute is passed to this function in the guardsize parameter.
pthread_attr_getguardsize() retrieves the value of the guardsize attribute from the thread
attributes object attr. This value is returned in the guardsize parameter. If the guard area is rounded up
to a multiple of
PAGESIZE, a call to this function shall store in the guardsize parameter the guard size
specified in the previous pthread_attr_setguardsize() function call.
ATTRIBUTE: inheritsched
The legal values for the inheritsched attribute are:
PTHREAD_INHERIT_SCHED
This option specifies that the scheduling policy and associated attributes are to be inherited from
the creating thread. The scheduling policy and associated attributes in the attr argument will be
ignored when a thread is created with attr.
PTHREAD_EXPLICIT_SCHED
This option specifies that the scheduling policy and associated attributes for the created thread(s)
HP-UX 11i Version 3: February 2007 − 4 − Hewlett-Packard Company 165