HP-UX Reference (11i v1 05/09) - 3 Library Functions N-Z (vol 7)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

191

192

193

194

195

196

197

198

199

200

pthread_launch_policy_np(3T) pthread_launch_policy_np(3T)

(Pthread Library)

thread is bound to the locality domain on which it was launched. The answer parameter is

ignored.

PTHREAD_POLICY_FILL_NP

This call establishes a ﬁll ﬁrst policy for the speciﬁed thread. Fill ﬁrst indicates that new threads

created by this thread are launched on the same locality domain as the creating thread until one

thread has been created for each processor in the domain. At that point, a new locality domain

is selected and successive threads launched there until there is one thread per processor. All

domains in the system will be used before the original domain is selected again. As with all

launch policies, the thread is bound to the locality domain on which it was launched. The answer

parameter is ignored.

PTHREAD_POLICY_PACKED_NP

This call establishes a packed policy for the speciﬁed thread. Packed indicates that new threads

created by this thread are launched on the same locality domain as the creating thread. As with

all launch policies, the thread is bound to the locality domain on which it was launched. The

answer parameter is ignored.

PTHREAD_POLICY_LEASTLOAD_NP

This call establishes a least loaded policy for the speciﬁed thread. Least loaded indicates that

new threads created by this thread are launched on the least loaded locality domain in the sys-

tem regardless of the location of the creating thread. As with all launch policies, the thread is

bound to the locality domain on which it was launched. The answer parameter is ignored.

PTHREAD_POLICY_NONE_NP

This call unsets any launch policy in the thread. In removing a launch policy, the thread is no

longer bound to the locality domain on which it was launched.The answer parameter is ignored.

RETURN VALUE

Upon successful completion,

pthread_launch_policy_np()

returns zero. Otherwise, an error

number is returned to indicate the error (the

errno variable is not set).

ERRORS

If any of the following occur, the pthread_launch_policy_np()

function returns the corresponding

error number:

[EINVAL] The request parameter contains an illegal value.

[EINVAL] The value speciﬁed by answer is illegal.

[ESRCH] No thread could be found in the current process that matches the thread ID speciﬁed

in tid.

WARNINGS

pthread_launch_policy_np()

is currently not supported for PTHREAD_SCOPE_PROCESS

threads. If pthread_launch_policy_np()

is used on a PTHREAD_SCOPE_PROCESS

thread, it is

silently ignored and zero is returned for successful completion. If the request parameter is

PTHREAD_GET_POLICY_NP

, answer is set to PTHREAD_POLICY_NONE_NP. For all other request

values, answer parameter is ignored. Applications dependent on the complete implementation of

pthread_launch_policy_np() should use PTHREAD_SCOPE_SYSTEM

threads.

AUTHOR

pthread_launch_policy_np() was developed by HP.