cpusetGetProperties(3x)				       cpusetGetProperties(3x)

NAME    [Toc]    [Back]

     cpusetGetProperties - retrieve various properties associated with a
     cpuset

SYNOPSIS    [Toc]    [Back]

     #include <cpuset.h>

     cpuset_Properties_t * cpusetGetProperties(char *qname);

DESCRIPTION    [Toc]    [Back]

     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    [Toc]    [Back]

     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    [Toc]    [Back]

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

DIAGNOSTICS    [Toc]    [Back]

     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).


									PPPPaaaaggggeeee 2222