unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



processor_sets(4)					    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 des-
  troy 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 pro-
  cessor 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 proces-
  sor 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 pro-
  cessor set.

  Use the pset_destroy command or the destroy_pset function to destroy a pro-
  cessor 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	pro-
  cessor to a processor	set.  Processor	set creation and destruction and pro-
  cessor 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)