psrset.1m (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

psrset(1M) psrset(1M)

-a pset_id processor_list

Assigns processor_list to pset_id . processor_list is the list of processors, and pset_id is

the processor set identiﬁcation number. The processors are taken out of their current

processor set and are reassigned to the speciﬁed processor set. Processor 0 may not be

reassigned.

If the processor being reassigned is the last processor in its current processor set, the

behavior is deﬁned by the

LASTSPU

attribute. See the -t option to deﬁne LASTSPU.

The possible attribute values for

LASTSPU are as follows:

DFLTPSET Default behavior. Reassign the processor to the speciﬁed processor set, and

return the active processes/threads in the processor set to the default set.

FAIL Fail the request.

-b pset_id pid_list

Binds pid_list to pset_id . pid_list is the speciﬁed list of processes (including all their

threads), and pset_id is the speciﬁed processor set. Bindings are inherited, so newly

created threads and processes will inherit their processor set binding from their parents.

If the target processor (pset_id ) has no processors assigned, the behavior is deﬁned by the

EMPTY attribute. See the -t option to deﬁne

EMPTY. The possible attribute values for

EMPTY are as follows:

FAIL Default behavior. Fail the request.

-c [processor_list

]

Creates a new processor set and displays the processor set identiﬁcation number

(pset_id ) for the new processor set. If a list of processors (processor_list) are speciﬁed on

the command line, they are assigned to the newly created processor set.

-d pset_list

-d all Destroys the speciﬁed list of processor sets (pset_list ). When the all

option is speciﬁed,

all the processor sets in the system are destroyed. When the processor set has processors

assigned, or there are active processes/threads bound to the processor set, the behavior is

deﬁned by the value of the

NONEMPTY attribute. See the -t option to deﬁne

NONEMPTY. The possible attribute values for NONEMPTY are as follows:

DFLTPSET Default behavior. Return all processors and threads/processes in the pro-

cessor set to the default set.

FAIL Fail the request if processor set has any processor assigned, or has active

processes or threads.

FAILBUSY Fail the request if there are active processes or threads bound to the pro-

cessor set.

-e pset_id command [ argument_list ]

Executes the speciﬁed command in the speciﬁed processor set (pset_id ). The effect is the

same as binding your shell to the target processor set, executing the command, and

changing back to your original processor set. The command may have arguments listed

in argument_list.

-f Forces the operation if the HP Process Resource Manager (HP PRM) is installed and

conﬁgured. The processor sets can also be conﬁgured by PRM. HP Process Resource

Manager is documented in the HP Process Resource Manager User’s Guide.

This option is applicable to all the conﬁguration options to override the PRM. If the force

ﬂag is not used with conﬁguration options in the presence of PRM, then

psrset exits

with an error message.

IMPORTANT: If used, the

-f option must be speciﬁed before any other arguments are

speciﬁed to the psrset command.

-g pset_id pgid

Binds all the processes (including all their threads) belonging to the process group (pgid)

to the speciﬁed processor set (pset_id ). This option is like explicitly listing all these

processes with the -b option.

-i [pset_list] Displays the processor assignments and attribute values for all processor sets speciﬁed in

the list (pset_list ) or for all sets by default. It will also list the Locality Domains that

2 Hewlett-Packard Company − 2 − HP-UX 11i Version 3: September 2010