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. 

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. 

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)