1rsm_memseg_import_opeRne_mboatreriSehra(r3eRdSMM)emory Lirbsrma_rmyemFsuengc_tiimopnosrt_open_barrier(3RSM)
2
3
4

NAME

6       rsm_memseg_import_open_barrier,        rsm_memseg_import_order_barrier,
7       rsm_memseg_import_close_barrier - remote memory access error  detection
8       functions
9

SYNOPSIS

11       cc [ flag... ] file... -lrsm [ library... ]
12       #include <rsmapi.h>
13
14       int rsm_memseg_import_open_barrier(rsmapi_barrier_t *barrier);
15
16
17       int rsm_memseg_import_order_barrier(rsmapi_barrier_t *barrier);
18
19
20       int rsm_memseg_import_close_barrier(rsmapi_barrier_t *barrier);
21
22

DESCRIPTION

24       The  rsm_memseg_import_open_barrier() and  rsm_memseg_import_close_bar‐
25       rier() functions provide a means of remote memory access  error  detec‐
26       tion  when  the  barrier mode is set to RSM_BARRIER_MODE_EXPLICIT. Open
27       and close barrier operations define a span-of-time interval  for  error
28       detection.  A  successful  close  barrier guarantees that remote memory
29       access covered between the open barrier and  close  barrier  have  com‐
30       pleted  successfully.  Any  individual  failures which may have occured
31       between the open barrier and close barrier occur without any  notifica‐
32       tion and the failure is not reported until the close barrier.
33
34
35       The  rsm_memseg_import_order_barrier()  function  imposes the order-of-
36       write completion whereby, with an order barrier, the  write  operations
37       issued before the order barrier are all completed before the operations
38       after the order barrier. Effectively, with the order barrier call,  all
39       writes  within  one  barrier scope are ordered with respect to those in
40       another barrier scope.
41

RETURN VALUES

43       Upon successful completion, these functions  return  0.  Otherwise,  an
44       error value is returned to indicate the error.
45

ERRORS

47       The    rsm_memseg_import_open_barrier(),   rsm_memseg_import_order_bar‐
48       rier(), and rsm_memseg_import_close_barrier() functions can return  the
49       following errors:
50
51       RSMERR_BAD_SEG_HNDL        Invalid segment handle
52
53
54       RSMERR_BAD_BARRIER_PTR     Invalid barrier pointer.
55
56
57
58       The rsm_memseg_close_barrier() and rsm_memseg_order_barrier() functions
59       can return the following errors:
60
61       RSMERR_BARRIER_UNINITIALIZED
62
63           Barrier not initialized.
64
65
66       RSMERR_BARRIER_NOT_OPENED
67
68           Barrier not opened.
69
70
71       RSMERR_BARRIER_FAILURE
72
73           Memory access error.
74
75
76       RSMERR_CONN_ABORTED
77
78           Connection aborted.
79
80

ATTRIBUTES

82       See attributes(5) for descriptions of the following attributes:
83
84
85
86
87       ┌─────────────────────────────┬─────────────────────────────┐
88ATTRIBUTE TYPE               ATTRIBUTE VALUE              
89       ├─────────────────────────────┼─────────────────────────────┤
90       │Interface Stability          │Evolving                     │
91       ├─────────────────────────────┼─────────────────────────────┤
92       │MT-Level                     │MT-Safe                      │
93       └─────────────────────────────┴─────────────────────────────┘
94

SEE ALSO

96       rsm_memseg_import_init_barrier(3RSM), rsm_memseg_import_set_mode(3RSM),
97       attributes(5)
98
99
100
101SunOS 5.11                        8 Jun 200r1sm_memseg_import_open_barrier(3RSM)
Impressum