NAME    [Toc]    [Back]

       assign_pid_to_pset - Assigns a process identification number
 to a processor set

SYNOPSIS    [Toc]    [Back]

       #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    [Toc]    [Back]

       Pset Library (libpset)

       Mach Library (libmach)

PARAMETERS    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       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)



                                            assign_pid_to_pset(3)