Rogue Wave banner
Previous fileTop of DocumentContentsIndexNext file

3.3 HPUX POSIX 1003.1c Thread Attribute Support

3.3.1 Scheduling Attributes

The following sections describe the HP POSIX 1003.1c implement-specific support, behavior, and restrictions for thread scheduling attributes.

3.3.1.1 Start Policy

The start policy attribute is fully supported by the HP-UX POSIX implementation of Threads.h++ and defaults to RW_THR_START_RUNNING.

3.3.1.2 Contention Scope

In POSIX 1003.1c-compliant systems, support for contention scope is optional. Threads.h++ determines whether contention scope is supported by testing for the definition of the macro _POSIX_THREAD_PRIORITY_SCHEDULING. Even if the API indicates that priority scheduling is supported, the environment may only allow one policy.

That is exactly the case in HP's POSIX implementation; priority scheduling is supported but all threads have a fixed contention scope of RW_THR_SYSTEM_SCOPE.

You may query the contention scope, and may set the contention scope to RW_THR_SYSTEM_SCOPE, but any attempt to change the scope to RW_THR_PROCESS_SCOPE will produce an exception.

The Threads.h++ HP POSIX implementation maps its RWContentionScope values to the underlying POSIX 1003.1cAPI as follows:

Table 1 -- HP/UX: Mapping of RWContentionScope to POSIX 1003.1c values

Threads.h++
RWContentionScope
POSIX 1003.1c
Contention Scope
RW_THR_PROCESS_SCOPE PTHREAD_SCOPE_PROCESS
RW_THR_SYSTEM_SCOPE PTHREAD_SCOPE_SYSTEM

3.3.1.3 Scheduling Inheritance Policy

The scheduling inheritance policy attribute is fully supported by the HP POSIX implementation of Threads.h++ and defaults to RW_THR_INHERIT. The process must have root privileges or be a member of a group with the RTPRIO privilege in order to set a policy of RW_THR_EXPLICIT.

3.3.1.4 Concurrency Policy

The concurrency policy attribute is not supported in the HP POSIX implementation of Threads.h++. Attempts to get or set this attribute value will result in exceptions.

3.3.1.5 Scheduling Policy

In POSIX 1003.1c compliant systems, support for the specification of scheduling policy is optional. Threads.h++ determines whether scheduling policy is supported by testing for the definition of the macro _POSIX_THREAD_PRIORITY_SCHEDULING. Even if the API indicates that priority scheduling is supported, the environment may not support all policies.

The HP implementation of the POSIX 1003.1c threads API supports all three scheduling policies as defined by the standard:

The Threads.h++ HP-UX POSIX implementation maps its RWSchedulingPolicy values to the underlying POSIX 1003.1c policy values as follows:

Table 2 -- HP/UX: Mapping of RWSchedulingPolicy to POSIX 1003.1c values

Threads.h++
RWSchedulingPolicy
POSIX 1003.1c
Scheduling Policy
RW_THR_PREEMPTIVE
SCHED_FIFO
RW_THR_TIME_SLICED_FIXED
SCHED_RR
RW_THR_TIME_SLICED_DYNAMIC
(RW_THR_OTHER may be used to set)
SCHED_OTHER

Attempts to set any other scheduling policy value will result in an RWTHROperationNotAvailable exception. None of these policies may be explicitly requested unless the process has root privileges or is a member of a group with the RTPRIO privilege.

Note that Threads.h++ has mapped two policy values to the same underlying policy, SCHED_OTHER. Calls to getSchedulingPolicy() will return RW_THR_TIME_SLICED_DYNAMIC since that value gives the most meaningful interpretation.

A new thread's scheduling policy is inherited from the creating thread by default, unless the scheduling policy attribute has been explicitly set or the inheritance policy has been changed from its default value of RW_THR_INHERIT to RW_THR_EXPLICIT. If the inheritance policy is RW_THR_EXPLICIT, Threads.h++ defines the default scheduling policy to be RW_THR_TIME_SLICED_DYNAMIC.

3.3.1.6 Scheduling Priority

In POSIX 1003.1c-compliant systems, support for the specification of thread priority is optional. Threads.h++ determines whether scheduling priority is supported by testing for the definition of the macro _POSIX_THREAD_PRIORITY_SCHEDULING.

The HP POSIX implementation does support priority scheduling. Threads.h++ uses the standard POSIX.4 functions sched_get_priority_min() and sched_get_priority_max() to determine the legal range of priority values.

The default priorities assigned by Threads.h++ and the ranges reported by these functions are as follows:

Table 3 -- HP/UX with POSIX 1003.1c: Scheduling policy priority values

Scheduling PolicyMinimum
Priority
Maximum
Priority
Default
Priority
RW_THR_PREEMPTIVE
0
31
0
RW_THR_TIME_SLICED_FIXED
0
31
0
RW_THR_TIME_SLICED_DYNAMIC
-256
-129
N/A

A new thread's priority value is inherited from the creating thread by default, unless the priority attribute has been explicitly set or the inheritance policy has been changed from its default value of RW_THR_INHERIT to RW_THR_EXPLICIT. If the inheritance policy is RW_THR_EXPLICIT, Threads.h++ defines the default priority to be the minimum priority. HP's implementation ignores attempts to set the priority if the scheduling policy is SCHED_OTHER (RW_THR_TIME_SLICED_DYNAMIC); threads with this scheduling policy are subject to continuous priority adjustments.

The priority of any thread may be changed unless the process has root privileges or is a member of a group with the RTPRIO privilege.

3.3.1.7 Scheduling Time-Slice Quantum

The time-slice quantum attribute is not supported in the HP POSIX implementation of Threads.h++. Attempts to get or set this attribute value will result in exceptions.

3.3.2 Stack Attributes

In POSIX 1003.1c-compliant systems, support for user specification of stack attributes is optional. HP POSIX supports size control for a system-managed stack, and supports user-managed stacks.

3.3.2.1 System-Managed Stack Attributes

POSIX 1003.1c-compliant systems provide optional support for controlling the reserve size of a system-managed stack, but provide no support for controlling the commitment of physical memory and page-file space to a thread stack.

3.3.2.2 User-Managed Stack Attributes

In POSIX 1003.1c compliant systems, support for user-defined stacks is optional. Threads.h++ determines the support for user-defined stacks by testing for the definition of the standard POSIX macro _POSIX_THREAD_ATTR_STACKADDR.

The HP-UX POSIX implementation of Threads.h++ supports user-managed stacks.

If an attempt is made to set the user stack address to zero, or to set the user stack size to a value less than the minimum stack size returned by the getMinStackSize() function, a RWTHRBoundsError exception is produced.

Threads.h++ imposes no upper limit for user stack size; the maximum stack size is effectively limited by the virtual memory space and pagefile size available to the user.

Attempts to query for a default user-stack address value or user-stack size value will result in an RWTHROperationNotAvailable exception. These values may only be queried after they have been set.

A call to setStackReserveSize() replaces or nullifies the attribute settings produced by any previous call to setUserStack() and vice versa.


Previous fileTop of DocumentContentsIndexNext file

©Copyright 2000, Rogue Wave Software, Inc.
Contact Rogue Wave about documentation or support issues.