Remote Shared Memory Library Functions
                              rsmgetinterconnecttopology(3RSM)



NAME
     rsmgetinterconnecttopology,
     rsmfreeinterconnecttopology  -  get  or free interconnect
     topology

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

     int rsmgetinterconnecttopology(rsmtopologyt **topologydata);


     void rsmfreeinterconnecttopology(rsmtopologyt *topologydata);


DESCRIPTION
     The         rsmgetinterconnecttopology(3RSM)          and
     rsmfreeinterconnecttopology(3RSM)  functions  provide for
     access to the interconnect controller and  connection  data.
     The  key  interconnect  data  required for export and import
     operations includes the respective cluster nodeids  and  the
     controller  names.  To facilitate applications in the estab-
     lishment of proper and efficient export and import policies,
     a  delineation  of  the interconnect topology is provided by
     this interface. The data  provided  includes  local  nodeid,
     local controller name, its hardware address, and remote con-
     nection specification for each local controller.  An  appli-
     cation  component  exporting memory can thus find the set of
     existing local controllers and correctly assign  controllers
     for  the  creation and publishing of segments. Exported seg-
     ments may also be efficiently distributed over  the  set  of
     controllers  consistent  with  the hardware interconnect and
     application software. An application component which  is  to
     import  memory  must  be  informed  of the segment id(s) and
     controller(s) used in the exporting of memory, this needs to
     be  done using some out-of-band mechanism. The topology data
     structures are defined in the  header.


     The rsmgetinterconnecttopology() returns a pointer to the
     topology  data  in a location specified by the topologydata
     argument.


     The  rsmfreeinterconnecttopology()  frees  the  resources
     allocated by rsmgetinterconnecttopology().

RETURN VALUES
     Upon successful completion,  rsmgetinterconnecttopology()
     returns 0. Otherwise, an error value is returned to indicate
     the error.



SunOS 5.11           Last change: 8 Jun 2001                    1






Remote Shared Memory Library Functions
                              rsmgetinterconnecttopology(3RSM)



ERORS
     The rsmgetinterconnecttopology() function can return  the
     following errors:

     RSMERBADTOPOLOGYPTR     Invalid topology pointer.


     RSMERINSUFICIENTMEM     Insufficient memory.


     RSMERBADADR             Bad address.


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



     
     ATRIBUTE TYPE               ATRIBUTE VALUE             
    
     Interface Stability          Evolving                    
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     attributes(5)
























SunOS 5.11           Last change: 8 Jun 2001                    2






Remote Shared Memory Library Functions
                              rsmgetinterconnecttopology(3RSM)






















































SunOS 5.11           Last change: 8 Jun 2001                    3