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