Next: 8.20 fluke_ipc_side_send_over_receive: send a
Up: 8 Interprocess Communication
Previous: 8.18 fluke_ipc_side_receive: receive data
fluke_error_t
fluke_ipc_side_send(fluke_ipc_params_t *ipc_params);
This function sends the specified data words and references
across one of the current thread's reliable IPC connections.
A client thread uses fluke_ipc_client_send
to send data to its server,
while a server thread uses fluke_ipc_server_send
to send data back to its client.
- ipc_params
-
A pointer to a structure describing data and references to send.
Only the send parameter fields in this structure are used;
the receive parameter fields are ignored.
All fields remain unmodified.
Returns one of the following codes:
All of these have an implicit FLUKE_ prefix.
- SUCCESS
-
All of the specified data was sent successfully.
(Note that this does not necessarily mean
that it has already been delivered to the final receiver.)
- IPC_SEND_DISCONNECTED
-
The IPC connection on which the transfer is to take place
does not exist, or has been broken for some reason,
such as by the receiver being terminated.
If any of the following errors is detected by the Fluke
implementation,
it causes the current thread to take a synchronous exception
with one of the following codes. All of these have an
implicit FLUKE_INSANITY_ prefix.
- NOT_SENDER
-
The current thread is not the sender
on the specified IPC connection.
- NO_OBJECT
-
A pointer in the ipc_params
send reference array
does not refer to an active object.
- NOT_REF
-
An object in the ipc_params
send reference array
is not a reference object.
- INVALID_OBJECT
-
The state of an object in the ipc_params
send reference array
is invalid.
- BUFFER_UNALIGNED
-
A message buffer was not aligned properly
according to the architecture-specific requirements.
fluke_ipc_side_receive
Next: 8.20 fluke_ipc_side_send_over_receive: send a
Up: 8 Interprocess Communication
Previous: 8.18 fluke_ipc_side_receive: receive data
Utah Flux Research Group