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_listList of process identification numbers to assign to the specified processor set. 

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

pset_idProcessor set, which is returned by a successful create_pset call. 

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