cpusetSetNodeList(3x)                                    cpusetSetNodeList(3x)


NAME
     cpusetSetNodeList - set the list of nodes assigned to a cpuset

SYNOPSIS
     #include <cpuset.h>

     int cpusetSetNodeList(cpuset_QueueDef_t *qdef, int count,
                                         cnodeid_t *nodes);

DESCRIPTION
     The cpusetSetNodeList function is used to set the list of nodes that will
     be assigned to a cpuset.  The assignment of a node to a cpuset results in
     the assignment of all of the CPU and memory resources on the node to the
     cpuset.  The benefit of specifying resource assignments by node is that
     it ensures none of the resources on the nodes will be shared by multiple
     cpusets, provided the cpuset attribute flags indicate the resources
     should be exclusive to the cpuset (see cpusetSetFlags(3x)).

     The count argument is the number of node IDs provided in the list.  The
     nodes argument is the list of node IDs provided in a memory array.  The
     qdef argument references a block of memory that stores the various
     attributes and resource lists that describe a cpuset.  It must be
     allocated using the cpusetAllocQueueDef(3x) function in order to use
     cpusetSetNodeList.  The list of nodes will be copied into the memory
     referenced by the qdef argument.

     The list of nodes will be used during a subsequent call to
     cpusetCreate(3x) to determine what resources, CPU and memory, should be
     assigned to the cpuset being created.

EXAMPLES
     This example set the list of nodes assigned to the cpuset mpi_set.

               cpuset_QueueDef_t *qdef;
               int               count = 4;
               int               nodes = {2,3,4,5}

               /* Create a cpuset definition with 0 CPUs defined */
               qdef = cpusetAllocQueueDef(0);
               /* Get the list of nodes else print error & exit */
               if ( !cpusetSetNodeList(qdef, count, nodes) ) {
                   perror("cpusetSetNodeList");
                   exit(1);
               }
               /* Set other cpuset attributes */

               if (!cpusetCreate("mpi_set", qdef)) {
                   perror("cpusetCreate");
                   exit(1);
               }


NOTES
     cpusetSetNodeList 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), cpusetAllocQueueDef(3x), cpusetCreate(3x), cpusetSetFlags(3x),
     cpuset(5).

DIAGNOSTICS
     If successful, cpusetSetNodeList returns 1.  If cpusetSetNodeList fails,
     it returns 0 and errno is set to indicate the error.


                                                                        Page 2