Manual Pages for UNIX Operating System command usage for man rsm_get_interconnect_topology

Remote Shared Memory Library Functions
                              rsm_get_interconnect_topology(3RSM)



NAME
     rsm_get_interconnect_topology,
     rsm_free_interconnect_topology  -  get  or free interconnect
     topology

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

     int rsm_get_interconnect_topology(rsm_topology_t **topology_data);


     void rsm_free_interconnect_topology(rsm_topology_t *topology_data);


DESCRIPTION
     The         rsm_get_interconnect_topology(3RSM)          and
     rsm_free_interconnect_topology(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 rsm_get_interconnect_topology() returns a pointer to the
     topology  data  in a location specified by the topology_data
     argument.


     The  rsm_free_interconnect_topology()  frees  the  resources
     allocated by rsm_get_interconnect_topology().

RETURN VALUES
     Upon successful completion,  rsm_get_interconnect_topology()
     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
                              rsm_get_interconnect_topology(3RSM)



ERRORS
     The rsm_get_interconnect_topology() function can return  the
     following errors:

     RSMERR_BAD_TOPOLOGY_PTR     Invalid topology pointer.


     RSMERR_INSUFFICIENT_MEM     Insufficient memory.


     RSMERR_BAD_ADDR             Bad address.


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



     ____________________________________________________________
    | ATTRIBUTE TYPE              | ATTRIBUTE VALUE             |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|


SEE ALSO
     attributes(5)
























SunOS 5.11           Last change: 8 Jun 2001                    2






Remote Shared Memory Library Functions
                              rsm_get_interconnect_topology(3RSM)






















































SunOS 5.11           Last change: 8 Jun 2001                    3