cpusetGetProperties(3x)cpusetGetProperties(3x)NAMEcpusetGetProperties - 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>.
NOTEScpusetGetProperties is found in the library "libcpuset.so", and will be
loaded if the option -lcpuset is used with cc(1) or ld(1).
Page 1
cpusetGetProperties(3x)cpusetGetProperties(3x)SEE ALSOcpuset(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
