Index for Section 3

Alphabetical listing for A

Bottom of page

assign_pid_to_pset(3)
NAME
  assign_pid_to_pset -	Assigns a process identification number to a
  processor set

LIBRARY
  Pset Library (libpset.a)

  Mach Library (libmach.a)

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

  int assign_pid_to_pset(
	  pid_t pid_list,
	  long num_pids,
	  long pset_id ,
	  long flags )

PARAMETERS
  pid_list  List of process identification numbers to assign to the specified
	    processor set.

  num_pids  Number of process identification numbers in the list specified by
	    the pid_list variable.

  pset_id   Processor set, which is returned by a successful create_pset
	    call.

  flags	    Mask of options.  Currently this function supports only the
	    PSET_EXCLUSIVE option.

DESCRIPTION
  The assign_pid_to_pset function assigns the process identification number
  specified by the pid_list variable to the processor set specified by the
  pset_id variable.  This function requires root privileges.

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

  To enable exclusive use of a processor set, set the PSET_EXCLUSIVE bit in
  the mask of options specified by the flags variable.	If the processor set
  is being used by another process, a request for exclusive access returns an
  error, and exclusive access is not enabled.

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

Index for Section 3

Alphabetical listing for A

Top of page