Click this button to go to the index for this section.

assign_cpu_to_pset(3)
NAME
  assign_cpu_to_pset -	Assigns a processor to a processor set

LIBRARY
  Pset Library (libpset.a)

  Mach Library (libmach.a)

SYNOPSIS
  #include <sys/types.h>
  #include <sys/processor.h>

  int assign_cpu_to_pset(
	  long cpu,
	  long pset_id ,
	  long option );

PARAMETERS
  cpu	    Processor or processors to assign to the specified processor set.

  pset_id   Processor set identifier, which is returned by the create_pset
	    function.

  option    Specifies a bit mask.  Currently, only the ANY_CPU bit is
	    supported.	If this bit is set, the value specified by the cpu
	    variable is the number of processors to be assigned to the
	    specified processor set from the default processor set.  If the
	    ANY_CPU bit is not set, the value specified by the cpu variable
	    is the mask of processors to be assigned to the processor set.

DESCRIPTION
  The assign_cpu_to_pset function removes processors from their current
  processor set and assigns them to the processor set specified by the
  pset_id variable.   This function requires root privileges.

  If the ANY_CPU option is specified, the number of processors specified by
  the cpu variable are assigned from the default processor set to the
  processor set that is specified with the pset_id variable.  If the
  specified number of processors are not available in the default processor
  set, an error is returned and no processors are assigned.

  If the ANY_CPU option is not set, the value specified by the cpu variable
  is a mask of processors to be assigned to the specified processor set.  For
  example, if you specify a cpu value of 6, then processors 2 and 3 are
  assigned to the processor set.

  Processor assignments are logged in the /var/adm/wtmp file.

RETURN VALUES
  If the processor assignment is successful, the assign_cpu_to_pset function
  returns zero (0).  If the assignment is unsuccessful, the function returns
  a negative number.  Use the print_pset_error function to print a message
  that describes the error.

FILES
  /var/adm/wtmp

RELATED INFORMATION
  bind_to_cpu(3), create_pset(3), destroy_pset(3), assign_pid_to_pset(3),
  print_pset_error(3), processor_sets(4), pset_create(1)