1rsm_intr_signal_post(R3eRmSoMt)e Shared Memory Library Funcrtsimo_nisntr_signal_post(3RSM)
2
3
4

NAME

6       rsm_intr_signal_post,  rsm_intr_signal_wait  -  signal  or  wait for an
7       event
8

SYNOPSIS

10       cc [ flag... ] file... -lrsm [ library... ]
11       #include <rsmapi.h>
12
13       int rsm_intr_signal_post(void *memseg, uint_t flags);
14
15
16       int rsm_intr_signal_wait(void *memseg, int timeout);
17
18

DESCRIPTION

20       The  rsm_intr_signal_post() and  rsm_intr_signal_wait()  functions  are
21       event  functions  that allow synchronization between importer processes
22       and exporter processes.  A process may block to wait for an event occu‐
23       rance by calling rsm_intr_signal_wait(). A process can signal a waiting
24       process when an event occurs by calling rsm_intr_signal_post().
25
26
27       The rsm_intr_signal_post() function signals an event occurance.  Either
28       an import segment handle (rsm_memseg_import_handle_t) or an export seg‐
29       ment handle (rsm_memseg_export_handle_t) may be type  cast  to  a  void
30       pointer  for the memseg argument. If memseg refers to an import handle,
31       the exporting process is signalled. If memseg refers to an export  han‐
32       dle,  all  importers  of that segment are signalled. The flags argument
33       may be set to RSM_SIGPOST_NO_ACCUMULATE; this will cause this event  to
34       be discarded if an event is already pending for the target segment.
35
36
37       The  rsm_intr_signal_wait() function allows a process to block and wait
38       for an event occurance.  Either  an  import  segment  handle  (rsm_mem‐
39       seg_import_handle_t)    or   an   export   segment   handle   (rsm_mem‐
40       seg_export_handle_t) may be type cast to a void pointer for the  memseg
41       argument.  The  process  blocks  for  up to timeout milliseconds for an
42       event to occur; if the timeout value is -1, the process blocks until an
43       event occurs or until interrupted.
44

RETURN VALUES

46       Upon  successful  completion,  these functions return 0.  Otherwise, an
47       error value is returned to indicate the error.
48

ERRORS

50       The rsm_intr_signal_post() and   rsm_intr_signal_wait()  functions  can
51       return the following error:
52
53       RSMERR_BAD_SEG_HNDL     Invalid segment handle.
54
55
56
57       The rsm_intr_signal_post() function can return the following error:
58
59       RSMERR_CONN_ABORTED
60
61           Connection aborted.
62
63
64       RSMERR_REMOTE_NODE_UNREACHABL
65
66           Remote node not reachable.
67
68
69
70       The rsm_intr_signal_wait() function can return the following errors:
71
72       RSMERR_INTERRUPTED     Wait interrupted.
73
74
75       RSMERR_TIMEOUT         Timer expired.
76
77

ATTRIBUTES

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

SEE ALSO

93       rsm_memseg_get_pollfd(3RSM), attributes(5)
94
95
96
97SunOS 5.11                        7 Nov 2002        rsm_intr_signal_post(3RSM)
Impressum