1rsm_memseg_import_conRneemcott(e3RSShMa)red Memory LibraryrsFmu_nmcetmisoengs_import_connect(3RSM)
2
3
4

NAME

6       rsm_memseg_import_connect,  rsm_memseg_import_disconnect  -  create  or
7       break logical commection between import and export segments
8

SYNOPSIS

10       cc [ flag... ] file... -lrsm [ library... ]
11       #include <rsmapi.h>
12
13       int rsm_memseg_import_connect(
14            rsmapi_controller_handle_t controller,
15            rsm_node_id_t nodeid, rsm_memseg_id_t segment_id,
16            rsm_permission_t perm, rsm_memseg_import_handle_t *memseg);
17
18
19       int rsm_memseg_import_disconnect(
20            rsm_memseg_import_handle_t memseg);
21
22

DESCRIPTION

24       The rsm_memseg_import_connect() function provides a means  of  creating
25       an  import  segment called memseg and establishing a logical connection
26       with an export segment identified by the segment_id on the node  speci‐
27       fied  by  node_id.  The  controller specified by controller must have a
28       physical  connection  with  the   controller   (see   rsm_get_intercon‐
29       nect_topology(3RSM))  used  while  exporting  the segment identified by
30       segment_id on node specified by node_id. The  perm  argument  specifies
31       the mode of access that the importer is requesting for this connection.
32       In the connection process, the mode of access and the importers  userid
33       and  groupid  are compared with the access permissions specified by the
34       exporter. If the request mode is not valid, the connection  request  is
35       denied. The perm argument is limited to the following octal values:
36
37       0400    read mode
38
39
40       0200    write mode
41
42
43       0600    read/write mode
44
45
46
47       The  rsm_memseg_import_disconnect() function breaks the logical connec‐
48       tion between the import segment and the exported  segment  and  deallo‐
49       cates the resources associated with the import segment handle memseg.
50

RETURN VALUES

52       Upon  successful  completion,  these  functions return 0. Otherwise, an
53       error value is returned to indicate the error.
54

ERRORS

56       The  rsm_memseg_import_connect()   and   rsm_memseg_import_disconnect()
57       functions can return the following errors:
58
59       RSMERR_BAD_SEG_HNDL     Invalid segment handle.
60
61
62
63       The   rsm_memseg_import_connect()  function  can  return  the following
64       errors:
65
66       RSMERR_BAD_CTLR_HNDL
67
68           Invalid controller handle.
69
70
71       RSMERR_CTLR_NOT_PRESENT
72
73           Controller not present.
74
75
76       RSMERR_PERM_DENIED
77
78           Permission denied.
79
80
81       RSMERR_INSUFFICIENT_MEM
82
83           Insufficient memory.
84
85
86       RSMERR_INSUFFICIENT_RESOURCES
87
88           Insufficient resources.
89
90
91       RSMERR_SEG_NOT_PUBLISHED_TO_NODE
92
93           Segment not published to node.
94
95
96       RSMERR_SEG_NOT_PUBLISHED
97
98           Segment not published at all.
99
100
101       RSMERR_BAD_ADDR
102
103           Bad address.
104
105
106       RSMERR_REMOTE_NODE_UNREACHABLE
107
108           Remote not not reachable.
109
110
111       RSMERR_INTERRUPTED
112
113           Connection interrupted.
114
115
116
117       The rsm_memseg_import_disconnect() function can  return  the  following
118       errors:
119
120       RSMERR_SEG_STILL_MAPPED     Segment  still mapped, need to unmap before
121                                   disconnect.
122
123
124       RSMERR_POLLFD_IN_USE        Poll file descriptor in use.
125
126

ATTRIBUTES

128       See attributes(5) for descriptions of the following attributes:
129
130
131
132
133       ┌─────────────────────────────┬─────────────────────────────┐
134       │ATTRIBUTE TYPE               │ATTRIBUTE VALUE              │
135       ├─────────────────────────────┼─────────────────────────────┤
136       │Interface Stability          │Evolving                     │
137       ├─────────────────────────────┼─────────────────────────────┤
138       │MT-Level                     │MT-Safe                      │
139       └─────────────────────────────┴─────────────────────────────┘
140

SEE ALSO

142       rsm_memseg_import_map(3RSM), attributes(5)
143
144
145
146SunOS 5.11                        8 Jun 2001   rsm_memseg_import_connect(3RSM)