mpsched(1)

mpsched(1)

NAME

mpsched - control the processor or locality domain on which a speci®c process executes

SYNOPSIS

mpsched -h

mpsched -s

mpsched [-g][-Ppolicy] [-Tpolicy] [-llocality-domain-id][-cspu] command

mpsched [-qu][-Ppolicy] [-llocality-domain-id][-cspu] {-ppid}...

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, or by setting the launch policy for the process.

The command may be invoked in four manners.

With -h, it prints a help message.

With -s, it returns the hardware con®guration of the system. This includes information about the number of locality domains and processors active in the system.

With a command and its arguments, it applies the binding or launch policy to this command.

With -p, it applies the binding or launch policy to the speci®ed pid.

Options

The command-line options are:

-c spu

Bind the speci®ed processes to the spu listed. This will ensure that the processes always run on the indicated processor. This option may be used with the -P, -T, and -poptions.

-gEnable gang scheduling on th No other options may be used with -g. -hPrint a help message.

-llocality-domain-id

Bind the speci®ed processes to the locality-domainlisted. This will ensure that the processes always run on the indicated domain. This option may be used with the -P, -T, and -poptions.

-p pid

Specify process ID, pid. To use the pid 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 -poption does not require special privileges. Multiple -poptions may be speci®ed per command line, although each -poption can take only a single process ID.

-qQuery 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 -pthen only those processes speci®ed are queried. If this option is speci®ed alone, then the status of all processes on the system that differ from the default settings are displayed.

-sPrint the system hardware con®guration. No other options may be speci®ed.

-uUnbind the processes from any processor or locality domain bindings that may be present. This option can be used only with -pand no other options may be speci®ed.

-Ppolicy

Apply the speci®ed policy to the processes. Launch policies affect the locality domain on which a process is spawned. This option may be used with the -T, -p, -c, and -loptions. policy is one of the following values.

RRRound robin launch policy. Under this policy, successive child processes are launched in a round robin fashion across the other locality domains in the system relative to creating thread.

LLLeast loaded launch policy. Under this policy, child processes are launched on the least loaded node in the system at the time of creation.

HP-UX Release 11i: December 2000

− 1 −

Section 1549

m