Index for Section 4

Alphabetical listing for P

Bottom of page

processor_sets(4)
NAME
  processor_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 processors
  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 contain
  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 processor
  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 processor 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 member 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), create_pset(3),
  destroy_pset(3)

Index for Section 4

Alphabetical listing for P

Top of page