sends a TIPC datagram to one or more destinations. Like its UDP
counterpart, Data is a string, atom or code-list providing the
data to be sent. To is a name/3, name_seq/3, or port_id/2
address structure. See tipc_overview.txt, for more information
on TIPC Address Structures. Options is currently unused.
A simple example to send a connectionless TIPC datagram is:
send(Message) :-
tipc_socket(S, dgram),
tipc_send(S, Message, name(18888, 10,0), []),
tipc_close_socket(S).
Messages are delivered silently unless some form of congestion
was encountered and the dest_droppable(false) option was
issued on the sender's socket. In this case, the send succeeds
but a notification in the form of an empty message is returned
to the sender from the receiver, indicating some kind of
delivery failure. The port-id of the receiver is returned in
congestion conditions. A port_id(0,0), is returned if the
destination address was invalid. Senders and receivers should
beware of this possibility.
