1rsm_get_interconnect_RteompootleogSyh(a3rReSdM)Memory Librrsamr_ygeFtu_nicnttieorncsonnect_topology(3RSM)
2
3
4

NAME

6       rsm_get_interconnect_topology,  rsm_free_interconnect_topology - get or
7       free interconnect topology
8

SYNOPSIS

10       cc [ flag... ] file... -lrsm [ library... ]
11       #include <rsmapi.h>
12
13       int rsm_get_interconnect_topology(rsm_topology_t **topology_data);
14
15
16       void rsm_free_interconnect_topology(rsm_topology_t *topology_data);
17
18

DESCRIPTION

20       The   rsm_get_interconnect_topology(3RSM)    and     rsm_free_intercon‐
21       nect_topology(3RSM)  functions  provide  for access to the interconnect
22       controller and connection data. The key interconnect data required  for
23       export  and  import  operations includes the respective cluster nodeids
24       and the controller names. To facilitate applications in the  establish‐
25       ment  of proper and efficient export and import policies, a delineation
26       of the interconnect topology is provided by this  interface.  The  data
27       provided  includes  local  nodeid,  local controller name, its hardware
28       address, and remote connection specification for each local controller.
29       An  application  component  exporting  memory  can thus find the set of
30       existing local controllers and correctly  assign  controllers  for  the
31       creation  and  publishing  of  segments.  Exported segments may also be
32       efficiently distributed over the set of controllers consistent with the
33       hardware  interconnect  and application software. An application compo‐
34       nent which is to import memory must be informed of  the  segment  id(s)
35       and  controller(s)  used  in  the exporting of memory, this needs to be
36       done using some out-of-band mechanism. The topology data structures are
37       defined in the <rsmapi.h> header.
38
39
40       The  rsm_get_interconnect_topology()  returns a pointer to the topology
41       data in a location specified by the topology_data argument.
42
43
44       The  rsm_free_interconnect_topology() frees the resources allocated  by
45       rsm_get_interconnect_topology().
46

RETURN VALUES

48       Upon  successful completion, rsm_get_interconnect_topology() returns 0.
49       Otherwise, an error value is returned to indicate the error.
50

ERRORS

52       The rsm_get_interconnect_topology() function can return  the  following
53       errors:
54
55       RSMERR_BAD_TOPOLOGY_PTR     Invalid topology pointer.
56
57
58       RSMERR_INSUFFICIENT_MEM     Insufficient memory.
59
60
61       RSMERR_BAD_ADDR             Bad address.
62
63

ATTRIBUTES

65       See attributes(5) for descriptions of the following attributes:
66
67
68
69
70       ┌─────────────────────────────┬─────────────────────────────┐
71       │ATTRIBUTE TYPE               │ATTRIBUTE VALUE              │
72       ├─────────────────────────────┼─────────────────────────────┤
73       │Interface Stability          │Evolving                     │
74       ├─────────────────────────────┼─────────────────────────────┤
75       │MT-Level                     │MT-Safe                      │
76       └─────────────────────────────┴─────────────────────────────┘
77

SEE ALSO

79       attributes(5)
80
81
82
83SunOS 5.11                        8 Jun 2001rsm_get_interconnect_topology(3RSM)
Impressum