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

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 );

LIBRARY
  Pset Library (libpset)

  Mach Library (libmach)

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.

SEE ALSO
  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