Datagram Invocations

2 min read

2 min read

2 min read

2 min read

2 min read

2 min read

2 min read

2 min read

A datagram invocation is an invocation made with a datagram proxy, a proxy whose invocation mode is datagram. It sends the request over UDP without waiting for a reply, and completes as soon as the client's local transport accepts the request. ice_datagram returns a datagram proxy.

UDP does not guarantee delivery: a datagram request can be lost, duplicated, or delivered out of order, so the server can dispatch a request more than once, or not at all, and in any order. Design your application to tolerate lost, duplicated, and reordered requests.

A datagram request, including its Ice message header, cannot exceed 65,507 bytes, the largest UDP payload, and must also fit in the UDP send buffer of the client and the UDP receive buffer of the object adapter.

A datagram invocation can reach any number of servers with IP multicast: set the host of the UDP endpoint to an IPv4 or IPv6 multicast address. For example:

Properties
# Object adapter endpoint:
Discover.Endpoints=udp -h 239.255.1.1 -p 10000
# Corresponding proxy endpoint:
Discover.Proxy=discover:udp -h 239.255.1.1 -p 10000

UDP Endpoint Syntax describes the options of a UDP endpoint, including its multicast options.

The IceDiscovery plug-in uses UDP multicast to locate object adapters and well-known objects.