cpusetAttach(3x)                                              cpusetAttach(3x)


NAME
     cpusetAttach - attach the current process to a cpuset

SYNOPSIS
     #include <cpuset.h>

     int cpusetAttach(char *qname);

DESCRIPTION
     The cpusetAttach function is used to attach the current process to the
     cpuset identified by qname.  Every cpuset queue has a file that defines
     access permissions to the queue.  The execute permissions for that file
     will determine if a process owned by a specific user can attach a process
     to the cpuset queue.

     The qname argument is the name of the cpuset to which the current process
     should be attached.

EXAMPLES
     This example attaches the current process to a cpuset queue named
     mpi_set.

               char *qname = "mpi_set";

               /* Attach to cpuset, if error - print error & exit */
               if (!cpusetAttach(qname)) {
                   perror("cpusetAttach");
                   exit(1);
               }


NOTES
     cpusetAttach is found in the library "libcpuset.so", and will be loaded
     if the option -lcpuset is used with cc(1) or ld(1).

SEE ALSO
     cpuset(1), cpusetCreate(3x), cpuset(5).

DIAGNOSTICS
     If successful, cpusetAttach returns a 1.  If cpusetAttach fails, it
     returns the value 0 and errno is set to indicate the error.  The possible
     values for errno are the same as those used by sysmp(2).


                                                                        Page 1