HP-UX Reference (11i v3 07/02) - 2 System Calls (vol 5)

m
mpctl(2) mpctl(2)
policies may be added in future releases and returned via this option. Applications
using this option should be written to handle other return values in order to con-
tinue working on future releases. The ldom argument is ignored.
MPC_SETPROCESS_RR
This call establishes a round robin launch policy (
MPC_LAUNCH_POLICY_RR
) for
the specified process. The successive child processes are launched on different
locality domains in a round robin manner until all available locality domains have
been used by processes in the launch tree. At that point, the selection of locality
domains begins again from the original locality domain. The ldom argument is
ignored.
MPC_SETPROCESS_FILL
This call establishes a fill first launch policy (
MPC_LAUNCH_POLICY_FILL
) for
the specified process. The successive child processes are launched on the same
locality domain as their parent process until one process has been created for each
available processor in the domain. At that point, a new locality domain is selected
and successive processes are launched there until there is one process per proces-
sor. All available locality domains will be used before the original domain is
selected again. The ldom argument is ignored.
MPC_SETPROCESS_PACKED
This call establishes a packed launch policy (MPC_LAUNCH_POLICY_PACKED
)
for the specified process. The successive child processes are launched on the same
locality domain as their parent process. The ldom argument is ignored.
MPC_SETPROCESS_LEASTLOAD
This call establishes a least loaded launch policy
(MPC_LAUNCH_POLICY_LEASTLOAD
) for the specified process. The successive
child processes are launched on the least loaded locality domain in the processor
set regardless of the location of their parent process. The ldom argument is
ignored.
MPC_SETPROCESS_RR_TREE
This call establishes a tree based round robin launch policy
(MPC_LAUNCH_POLICY_RR_TREE
) for the specified process. This request
differs from
MPC_SETPROCESS_RR
in which processes become part of the launch
tree. This launch policy includes all descendents of the target process in the
launch tree. The ldom argument is ignored.
MPC_SETPROCESS_FILL_TREE
This call establishes a tree based fill first launch policy
(MPC_LAUNCH_POLICY_FILL_TREE
) for the specified process. This request
differs from
MPC_SETPROCESS_FILL
in which processes become part of the
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 argument
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 to
indicate the current launch policy of the LWP specified by lwpid. Other launch
policies may be added in future releases and returned via this option. Applications
using this option should be written to handle other return values in order to con-
tinue working on future releases. The ldom argument is ignored.
HP-UX 11i Version 3: February 2007 − 9 − Hewlett-Packard Company 221