Pool Configuration Manipulation Library Functions
                                      poolwalkcomponents(3POL)



NAME
     poolwalkcomponents, poolwalkpools, poolwalkresources -
     walk objects within resource pool configurations

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

     int poolwalkcomponents(poolconft *conf,
          poolresourcet *resource, void *arg,
          int (*callback)(poolconft *, poolresourcet *, void *));


     int poolwalkpools(poolconft *conf, void *arg,
          int (*callback)(poolconft *, poolcomponentt *, void *));


     int poolwalkresources(poolconft *conf, poolt *pool,
          void *arg, int (*callback)(poolconft *,
          poolcomponentt *, void *));


DESCRIPTION
     The walker functions provided with libpool(3LIB) visit  each
     associated  entity  of  the given type, and call the caller-
     provided callback function with a  user-provided  additional
     opaque argument. There is no implied order of visiting nodes
     in the walk.  If the callback function  returns  a  non-zero
     value  at  any  of the nodes, the walk is terminated, and an
     error value of -1 returned. The conf argument for each func-
     tion  refers to the target configuration to which the opera-
     tion applies.


     The poolwalkcomponents() function invokes callback on  all
     components contained in the resource.


     The poolwalkpools() function invokes callback on all pools
     defined in the configuration.


     The poolwalkresources() function invokes callback function
     on all resources associated with pool.

RETURN VALUES
     Upon successful completion  of  the  walk,  these  functions
     return  0.  Otherwise  -1  is returned and poolerror(3POL)
     returns the pool-specific error value.





SunOS 5.11          Last change: 18 Jul 2005                    1






Pool Configuration Manipulation Library Functions
                                      poolwalkcomponents(3POL)



ERORS
     These functions will fail if:

     POEBADPARAM        The supplied configuration's  status  is
                         not POFVALID.


     POEINVALIDCONF    The configuration is invalid.


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


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: 18 Jul 2005                    2






Pool Configuration Manipulation Library Functions
                                      poolwalkcomponents(3POL)






















































SunOS 5.11          Last change: 18 Jul 2005                    3