cpusetGetProperties - retrieve various properties associ
ated with a cpuset
SYNOPSIS
#include <cpuset.h>
cpuset_Properties_t * cpusetGetProperties(char *qname);
DESCRIPTION
The cpusetGetProperties function is used retrieve various
properties identified by qqnnaammee 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 qqnnaammee 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
<<ssnn//ccppuusseett..hh>>.
NOTES
cpusetGetProperties is found in the library "libc
puset.so", and will be loaded if the option --llccppuusseett is
used with cc(1) or ld(1).
Not all of the above capabilities are implemented. See
the RESTRICTIONS secion in manual entry cpuset(4) for
details.
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.
Man(1) output converted with
man2html