processor_sets(4)processor_sets(4)NAMEprocessor_sets - Collections of processors
DESCRIPTION
A processor set is a collection of processors. When a processor set is
first created, it does not contain any processors. You can add proces‐
sors to a processor set, remove processors from a processor set, and
also destroy the processor set. In addition, you can assign specific
processes to a processor set.
When the system is booted, all its processors are assigned to the
default processor set. Each processor in a system can be a member of
only one processor set at one time.
In addition, when you create a process, it is assigned to a processor
set. Unless you indicate a specific processor set, a process is
assigned to the default processor set. A process can execute only on
an processor that is included in the processor set to which the process
is assigned. If you assign a process to an empty processor set, it
will not execute until a processor is assigned to the processor set or
until the process is assigned to another processor set.
Use the pset_create command or the create_pset function to create a
processor set. When you first create a processor set, it does not con‐
tain any processors.
Use the pset_assign_cpu command or the assign_cpu_to_pset function to
assign processors to a specific processor set. When you assign a pro‐
cessor to a specific processor set, the processor is removed from its
current processor set.
Use the pset_destroy command or the destroy_pset function to destroy a
processor set. Processors that belong to a destroyed processor set
are assigned to the default processor set.
Use the pset_assign_pid command or the assign_pid_to_pset function to
assign a process to a specific processor set. In addition, you can
request that a process has exclusive access to a processor set. If a
process has exclusive access to a processor set, no other process is
able to use that processor set. If a process has exclusive access to a
processor set, that access will be cleared automatically when the
process exits. Note that if a process is already assigned to a proces‐
sor set, a request for exclusive access to that processor set will be
denied.
Use the pset_info command to display the status of each processor set
on the system as well as the status of each processor.
You must be root to create and destroy processor sets and to assign a
processor to a processor set. Processor set creation and destruction
and processor assignments to processor sets are logged in the
/var/adm/wtmp file.
RESTRICTIONS
The following restrictions apply:
An error message is displayed if you try to move the primary processor
to another set. This is because the primary processor is always a mem‐
ber of the default processor set.
When a halted processor is restarted, it is returned to membership of
the set from which it was halted. If that set no longer exists, it is
returned to the default set.
FILES
/var/adm/wtmp
RELATED INFORMATION
Commands: pset_create(1), pset_destroy(1), pset_info(1),
pset_assign_pid(1), pset_assign_cpu(1), runon(1), psrinfo(1), psradm(8)
Functions: assign_pid_to_pset(3), assign_cpu_to_pset(3), cre‐
ate_pset(3), destroy_pset(3) delim off
processor_sets(4)