mpsched(1)mpsched(1)NAMEmpsched - control the processor or locality domain on which a specific
process/lightweight process (LWP) executes
SYNOPSIS
cpu
command
policy] policy] locality-domain-id] spu] command
policy] locality-domain-id] spu] pid}...
locality-domain-id] spu] lwpid}...
DESCRIPTION
controls the processor (spu), or locality domain (locality-domain-id)
on which a process/LWP executes. It can do this by binding a
process/LWP to a particular processor or locality domain (ldom), or by
setting the launch policy for the process.
The command can be invoked in the following manners.
· With it prints a help message.
· With it returns the hardware configuration of the system. This
includes information about the number of locality domains and
processors active in the system.
· With it returns the system topology at the locality domain,
proximity set, socket and core level. This includes information
about the number of locality domains and processors active in
the system. Processors on the same front side bus (FSB) form a
proximity set.
· With it returns the system topology at the socket level.
· With it returns the system topology at the proximity set level.
· With it returns the processors in the same locality domain as
the processors specified in the arguments.
· With it returns the processors in the same proximity set as the
processors specified in the arguments.
· With it returns the processors in the same socket as the proces‐
sors specified in the arguments.
· With it returns the processors in the same core as the proces‐
sors specified in the arguments.
· With it enables gang scheduling for a command and its arguments.
See gang_sched(7).
· With or plus a command and its arguments, it applies the binding
or launch policy to the command.
· With it applies the binding or launch policy to the specified
pid.
· With it applies the binding to the specified lwpid.
Options
The command-line options are:
Bind the specified processes/LWPs to the
spu listed. This will ensure that the processes/LWPs
always run on the specified processor. In the Processor
Set (pset) configured system, binding will be successful,
if spu belongs to same pset where process/LWP is bound.
This option can be used with the and options.
Allows processes/LWPs to bind to
spu or ldom, when PRM is installed in the system.
Enable gang scheduling on the process.
No other options should be used with
Print a help message.
Bind the specified processes/LWPs to the
locality-domain listed. This will ensure that the pro‐
cesses/LWPs always run on a processor within the specified
locality domain. In the Processor Set (pset) configured
system, binding will be successful, if ldom to the
process/LWP is in same pset where process/LWP was bound.
This option can be used with the and options.
Specify process ID,
pid. To use the option, the caller must be a member of a
group having access, be superuser, or have the same effec‐
tive user ID as the pid. Specifying a command instead of
the option does not require special privileges. Multiple
options can be specified per command line, although each
option can take only a single process ID.
Specify lightweight process ID,
lwpid. To use the option, the caller must be a member of a
group having access, be superuser, or have the same effec‐
tive user ID as the lwpid. Multiple options can be speci‐
fied per command line, although each option can take only a
single lightweight process ID. The target LWP (lwpid) can
be in any process.
Query the system regarding process/LWP bindings.
This will return information about whether processes/LWP
are bound to a processor or locality domain. It will also
report on the thread and process launch policies for the
processes.
If this option is used in conjunction with then only those
processes/LWPs specified are queried respectively. If this
option is specified alone, then the status of all processes
on the system that differ from the default settings are
displayed.
Print the system hardware configuration.
No other options should be specified.
Print the system topology at the locality domain, proximity set, socket
and
core level. No other options should be specified.
Print the system topology at the socket level.
No other options should be specified.
Print the system topology at the proximity set level.
No other options should be specified.
Print the processors in the same locality domain as the processors
specified
in the arguments. This option can be used with the and
options.
Print the processors in the same proximity set as the processors speci‐
fied
in the arguments. This option can be used with the and
options.
Print the processors in the same socket as the processors specified in
the
arguments. This option can be used with the and options.
Print the processors in the same core as the processors specified in
the
arguments. This option can be used with the and options.
Unbind the specified processes/LWPs from any processor or
locality domain bindings that can be present. This option
can be used only with or and no other options can be speci‐
fied.
Apply the specified
policy to the processes. Launch policies affect the local‐
ity domain on which a process is spawned. Refer to
mpctl(2) manpage for details on launch policies.
This option can be used with the and options.
policy is one of the following values:
Round robin launch policy.
Under this policy, successive direct child pro‐
cesses of the specified command or process are
launched in a round robin fashion across the
other locality domains in the system relative
to creating process.
Tree based round robin launch policy.
Under this policy, successive child processes
and their descendents are launched in a round
robin fashion across the other locality domains
in the system relative to creating process.
Least loaded launch policy.
Under this policy, child processes are launched
on the least loaded locality domain in the sys‐
tem at the time of creation.
Fill first launch policy.
Under this policy, successive direct child pro‐
cesses of the specified command or process are
launched on the same locality domain as their
parent until one has been launched on each pro‐
cessor in the locality domain. At that point,
new processes are created on the next locality
domain.
Tree based Fill first launch policy.
Under this policy, successive child processes
and their descendents are launched on the same
locality domain as their parent until one has
been launched on each processor in the locality
domain. At that point, new processes are cre‐
ated on the next locality domain.
Packed launch.
Under this policy, successive processes are
launched on the same locality domain as their
parent. A different domain is never selected.
No special policy.
The default HP-UX launch policy is used.
Apply the specified
policy to the threads of the process. The scheduling poli‐
cies are the same as for the option except that they apply
to newly created threads instead of processes. Also,
thread policies can only be specified on commands launched
from the command line of The option can be used with the
and options.
Operands
The command-line operands are:
command A command including its arguments.
RETURN VALUE
returns exit status 0 if command is successfully scheduled or -1 if it
fails.
EXAMPLES
Execute the file on processor 2:
Set the process launch policy for the existing process with pid 24217
to round robin:
Bind the processes with pids 1247 and 1842 to processor 4:
Bind the Lightweight Processes with lwpids 12345 and 12346 to locality
domain 2:
Print the processors in the same proximity set as processors 0 and 4:
Print the system topology at the locality domain, proximity set,
socket, core and processor level:
AUTHOR
was developed by HP.
SEE ALSOgetprivgrp(1), setprivgrp(1M), fork(2), getprivgrp(2), mpctl(2),
pstat_getlwp(2), privgrp(4), gang_sched(7).
mpsched(1)