assign_pid_to_pset(3)assign_pid_to_pset(3)NAMEassign_pid_to_pset - Assigns a process identification number to a pro‐
cessor 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
List of process identification numbers to assign to the specified pro‐
cessor set. Number of process identification numbers in the list spec‐
ified by the pid_list variable. Processor set, which is returned by a
successful create_pset() call. Mask of options. Currently this func‐
tion 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 speci‐
fied 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 proces‐
sor set is being used by another process, a request for exclusive
access returns an error, and exclusive access is not enabled.
SEE ALSObind_to_cpu(3), create_pset(3), destroy_pset(3), assign_cpu_to_pset(3),
print_pset_error(3), processor_sets(4), pset_create(1)assign_pid_to_pset(3)