cpusetDestroy(3x)                                            cpusetDestroy(3x)


NAME
     cpusetDestroy - destroy a cpuset

SYNOPSIS
     #include <cpuset.h>

     int cpusetDestroy(char *qname);

DESCRIPTION
     The cpusetDestroy function is used to destroy the specified cpuset The
     qname argument is the name of the cpuset that will be destroyed. Only
     processes running with root user ID are allowed to destroy cpuset queues.
     A cpuset can only be destroyed if there are no threads currently attached
     to it.

EXAMPLES
     This example Destroys the cpuset queue named mpi_set.

               char *qname = "mpi_set";

               /* Destroy, if error - print error & exit */
               if (!cpusetDestroy(qname)) {
                   perror("cpusetDestroy");
                   exit(1);
               }


NOTES
     cpusetDestroy 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, cpusetDestroy returns a 1.  If cpusetDestroy fails, it
     returns the value 0 and errno is set to indicate the error.  The values
     for errno are the same as those returned by sysmp(2).


                                                                        Page 1