Command Reference Guide

ManualsBrandsHP ManualsSoftwareHP HP-UX Operating Systems

571

572

573

574

575

576

577

578

579

580

__________________________________________________________________________________________________________________________________________________________________________________________________

STANDARD Printed by: Nora Chuang [nchuang] STANDARD

/build/1111/BRICK/man1/!!!intro.1

________________________________________________________________

___ ___

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][-P policy][-T policy][-l locality-domain-id][-c spu] command

mpsched [-qu][-P policy][-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, or by setting the launch pol-

icy 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 -p

options.

-g Enable gang scheduling on th No other options may be used with -g.

-h Print a help message.

-l locality-domain-id

Bind the speciﬁed processes to the locality-domain listed. This will ensure that the processes always

run on the indicated domain. This option may be used with the

-P, -T, and

-p options.

-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 com-

mand instead of the

-p option does not require special privileges. Multiple -p options may be

speciﬁed 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 poli-

cies for the processes. If this option is used in conjunction with

-p then 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.

-s Print the system hardware conﬁguration. No other options may be speciﬁed.

-u Unbind the processes from any processor or locality domain bindingsthat may be present. This option

can be used only with -p and no other options may be speciﬁed.

-P policy

Apply the speciﬁed policy to the processes. Launch policies affect the locality domain on which a pro-

cess is spawned. This option may be used with the -T, -p, -c, and -l options. policy is one of the

following values.

RR Round 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.

LL Least 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 1−−549

___