cpusetGetProperties(3x)                                cpusetGetProperties(3x)


NAME
     cpusetGetProperties - retrieve various properties associated with a
     cpuset

SYNOPSIS
     #include <cpuset.h>

     cpuset_Properties_t * cpusetGetProperties(char *qname);


DESCRIPTION
     The cpusetGetProperties function is used retrieve various properties
     identified by qname and returns a pointer to a cpuset_Properties_t
     structure.  Every cpuset queue has a file that defines access permissions
     to the queue.  The read permissions for that file will determine if a
     process owned by a specific user can retrieve the properties from the
     cpuset.

     The qname argument is the name of the cpuset to which the properties
     should be retrieved.

EXAMPLES
     This example retrieves the properties of a cpuset queue named mpi_set.

                char *qname = "mpi_set";
                cpuset_Properties_t      *csp;


                /* Get properties, if error - print error & exit */
                csp=cpusetGetProperties(qname);
                if (!csp) {
                     perror("cpusetGetProperties");
                     exit(1);
                }
                .
                .
                .
                cpusetFreeProperties(csp);


      Once a valid pointer is returned, a check against the extFlags member
      must be made with the flags CPUSET_ACCESS_ACL, CPUSET_DEFAULT_ACL, and
      CPUSET_MAC_LABEL to see if any valid ACLs or a valid MAC label was
      returned.  The check flags can be found in <sys\cpuset.h>.

NOTES
     cpusetGetProperties 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), cpusetFreeProperties(3x), cpuset(5).

DIAGNOSTICS
     If successful, cpusetGetProperties returns a pointer to a
     cpuset_Properties_t structure. If cpusetGetProperties fails, it returns a
     NULL and errno is set to indicate the error.  The possible values for
     errno are the same as those used by sysmp(2).


                                                                        Page 2