HP-UX Reference (11i v1 05/09) - 1 User Commands A-M (vol 1)

m
mpsched(1) mpsched(1)
NAME
mpsched - control the processor or locality domain on which a specific process executes
SYNOPSIS
mpsched -h
mpsched -s
mpsched -g
command
mpsched [-P policy][-f
][-T policy][-l locality-domain-id][
-c spu] command
mpsched [-q][-u
][-P policy][-f][-l locality-domain-id][
-c
spu]{-p pid}...
DESCRIPTION
mpsched controls the processor (spu), or locality domain (locality-domain-id) on which a process executes.
It can do this by binding a process to a particular processor or locality domain (ldom), or by setting the
launch policy for the process.
The command can be invoked in five manners.
• With
-h, it prints a help message.
• With -s, it returns the hardware configuration of the system. This includes information about the
number of locality domains and processors active in the system.
• With -g, it enables gang scheduling for a command and its arguments. See gang_sched(7).
• With
-P, -T,or-l plus a command and its arguments, it applies the binding or launch policy to the
command.
• With -p, it applies the binding or launch policy to the specified pid.
Options
The command-line options are:
-c spu Bind the specified processes to the spu listed. This will ensure that the processes always run
on the indicated processor. In the ProcessorSet (pset) configured system, binding will be suc-
cessful, if spu belongs to same pset, where process is bound.
This option can be used with the -P, -T, and -p
options.
-f Allows processes to bind to spu or ldom, when PRM is installed in the system.
-g Enable gang scheduling on the process. No other options should be used with -g
.
-h Print a help message.
-l locality-domain-id
Bind the specified processes to the locality-domain listed. This will ensure that the processes
always run on the indicated domain. In the ProcessorSet (pset) configured system, binding
will be successful, if ldom to the process is in same pset where process was bound.
This option can be used with the
-P, -T, and -p options.
-p pid Specify process ID, pid. To use the -p option, the caller must be a member of a group having
PRIV_MPCTL access, be superuser, or have the same effective user ID as the pid.Specifying
a command instead of the -p option does not require special privileges. Multiple -p options
can be specified per command line, although each -p option can take only a single process ID.
-q Query the system regarding process bindings. This will return information about whether
processes 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 -p then
only those processes specified are queried. If this option is specified alone, then the status of
all processes on the system that differ from the default settings are displayed.
-s Print the system hardware configuration. No other options should be specified.
-u Unbind the processes from any processor or locality domain bindings that can be present. This
option can be used only with -p and no other options should be specified.
-P policy Apply the specified policy to the processes. Launch policies affect the locality domain on which
a process is spawned. This option can be used with the -T, -p, -c, and -l options. policy is
HP-UX 11i Version 1: September 2005 − 1 − Hewlett-Packard Company Section 1−−569