next up previous contents
Next: 8.20 fluke_ipc_side_send_over_receive: send a Up: 8 Interprocess Communication Previous: 8.18 fluke_ipc_side_receive: receive data

8.19 fluke_ipc_side_send: send data across a reliable IPC connection

SYNOPSIS

fluke_error_t fluke_ipc_side_send(fluke_ipc_params_t *ipc_params);

DESCRIPTION

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.

PARAMETERS

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

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.

ERRORS

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.

RELATED INFORMATION

fluke_ipc_side_receive


next up previous contents
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