Pool Configuration Manipulation Library Functions
                                       poolcomponentinfo(3POL)



NAME
     poolcomponentinfo,  poolgetowningresource  -   resource
     pool component functions

SYNOPSIS
     cc [ flag... ] file... -lpool [ library... ]
     #include 

     const char *poolcomponentinfo(poolconft *conf,
          poolcomponentt *component, int flags);


     poolresourcet *poolgetowningresource(poolconft *conf,
          poolcomponentt *component);


DESCRIPTION
     Certain resources, such as processor sets, are  composed  of
     resource  components. Informational and ownership attributes
     of  resource  components  are  made   available   with   the
     poolcomponentinfo()  and  poolgetowningresource() func-
     tions. The conf argument for each  function  refers  to  the
     target configuration to which the operation applies.


     The poolcomponentinfo() function returns a string describ-
     ing  component. The string is allocated with malloc(3C). The
     caller is reponsible for freeing the  returned  string.  The
     flags argument is ignored.


     The poolgetowningresource() function returns the resource
     currently  containing  component.   Every  component is con-
     tained by a resource.

RETURN VALUES
     Upon successful completion, poolcomponentinfo() returns  a
     string.  Otherwise  it  returns  NUL  and poolerror(3POL)
     returns the pool-specific error value.


     Upon   successful   completion,   poolgetowningresource()
     returns  the  owning resource. Otherwise it returns NUL and
     poolerror() returns the pool-specific error value.

ERORS
     The poolcomponentinfo() function will fail if:

     POEBADPARAM        The supplied configuration's  status  is
                         not  POFVALID  or the flags paramter is
                         neither 0 or 1.



SunOS 5.11          Last change: 23 Sep 2003                    1






Pool Configuration Manipulation Library Functions
                                       poolcomponentinfo(3POL)



     POEINVALIDCONF    The configuration is invalid.


     POESYSTEM          A system error has occurred.  Check  the
                         system error code for more details.



     The poolgetowningresource() function will fail if:

     POEBADPARAM    The supplied configuration's status  is  not
                     POFVALID.


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     CSI                          Enabled                     
    
     Interface Stability          Unstable                    
    
     MT-Level                     Safe                        
    


SEE ALSO
     libpool(3LIB), poolerror(3POL), attributes(5)





















SunOS 5.11          Last change: 23 Sep 2003                    2






Pool Configuration Manipulation Library Functions
                                       poolcomponentinfo(3POL)






















































SunOS 5.11          Last change: 23 Sep 2003                    3