osf1 man page for assign_pid_to_pset

assign_pid_to_pset(3)					     Library Functions Manual					     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
       List  of  process  identification  numbers  to assign to the specified processor set.  Number of process identification numbers in the list
       specified by the pid_list variable.  Processor set, which is returned by a successful create_pset call.	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 pro-
       cessor 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) delim off

															     assign_pid_to_pset(3)