cpusetAttach(3x)					      cpusetAttach(3x)

NAME    [Toc]    [Back]

     cpusetAttach - attach the current process to a cpuset

SYNOPSIS    [Toc]    [Back]

     #include <cpuset.h>

     int cpusetAttach(char *qname);

DESCRIPTION    [Toc]    [Back]

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

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

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

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

DIAGNOSTICS    [Toc]    [Back]

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


									PPPPaaaaggggeeee 1111