mpctl.2 (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

mpctl(2) mpctl(2)

launch tree. This launch policy includes all descendents of the target process in

the launch tree. The ldom argument is ignored.

MPC_SETPROCESS_NONE

This call unsets any launch policy in the process. The system will employ a

default, optimal policy in determining where the newly created process will be

launched. The existing binding of the process is not changed. The ldom argu-

ment is ignored.

For LWP launch policies use:

int mpctl(mpc_request_t request, ldom_t ldom, lwpid_t lwpid);

The request argument determines the precise action to be taken by

mpctl() and is one of the following:

MPC_GETLWP_LAUNCH

This request currently returns MPC_LAUNCH_POLICY_RR

MPC_LAUNCH_POLICY_FILL

, MPC_LAUNCH_POLICY_PACKED

MPC_LAUNCH_POLICY_LEASTLOAD

, MPC_LAUNCH_POLICY_RR_TREE

MPC_LAUNCH_POLICY_FILL_TREE

,orMPC_LAUNCH_POLICY_NONE

indicate the current launch policy of the LWP speciﬁed by lwpid. Other launch

policies may be added in future releases and returned via this option. Applica-

tions using this option should be written to handle other return values in order

to continue working on future releases. The ldom argument is ignored.

MPC_SETLWP_RR This call establishes a round robin launch policy (MPC_LAUNCH_POLICY_RR

)

for the speciﬁed LWP. The successive child LWPs are launched on different

locality domains in a round robin manner until all available locality domains

have been used by LWPs in the launch tree. At that point, the selection of local-

ity domains begins again from the original locality domain. The ldom argument

is ignored.

MPC_SETLWP_FILL

This call establishes a ﬁll ﬁrst launch policy (MPC_LAUNCH_POLICY_FILL

) for

the speciﬁed LWP. The successive child LWPs are launched on the same locality

domain as their parent LWP until one thread has been created for each avail-

able processor in the domain. At that point, a new locality domain is selected

and successive LWPs are launched there until there is one LWP per processor.

All available locality domains will be used before the original domain is selected

again. The ldom argument is ignored.

MPC_SETLWP_PACKED

This call establishes a packed launch policy (MPC_LAUNCH_POLICY_PACKED

)

for the speciﬁed LWP. The successive child LWPs are launched on the same

locality domain as their parent LWP. The ldom argument is ignored.

MPC_SETLWP_LEASTLOAD

This call establishes a least loaded launch policy

(MPC_LAUNCH_POLICY_LEASTLOAD) for the speciﬁed LWP. The successive

child LWPs are launched on the least loaded locality domain in the processor set

regardless of the location of their parent LWP. The ldom argument is ignored.

MPC_SETLWP_RR_TREE

This call establishes a tree based round robin launch policy

(MPC_LAUNCH_POLICY_RR_TREE) for the speciﬁed LWP. This request differs

from MPC_SETPROCESS_RR in which LWPs become part of the launch tree.

This launch policy includes all descendents of the target LWP in the launch tree.

The ldom argument is ignored.

MPC_SETLWP_FILL_TREE

This call establishes a tree based ﬁll ﬁrst launch policy

(MPC_LAUNCH_POLICY_FILL_TREE) for the speciﬁed LWP. This request

differs from MPC_SETPROCESS_FILL in which LWPs become part of the

launch tree. This launch policy includes all descendents of the target LWP in

the launch tree. The ldom argument is ignored.

MPC_SETLWP_NONE

This call unsets any launch policy in the LWP. The system will employ a

HP-UX 11i Version 3: September 2010 − 11 − Hewlett-Packard Company 11