---
title: "Datagram Invocations"
url: https://docs.zeroc.com/ice/3.8/runtime/invocation/invocation-mode/datagram-invocations
docs_index: https://docs.zeroc.com/llms.txt
---

> For an index of every page, see [llms.txt](https://docs.zeroc.com/llms.txt).

# Datagram Invocations

This page is written for C++, C#, Java, MATLAB, PHP, Python, Ruby, and Swift.

A datagram invocation is an invocation made with a datagram proxy, a proxy whose [invocation mode](https://docs.zeroc.com/ice/3.8/runtime/invocation/invocation-mode.md) 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](https://docs.zeroc.com/ice/3.8/property-reference/ice-udp-properties.md#ice.udp.sndsize) of the client and the [UDP receive buffer](https://docs.zeroc.com/ice/3.8/property-reference/ice-udp-properties.md#ice.udp.rcvsize) of the object adapter.

## UDP Multicast

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:

```config
# 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](https://docs.zeroc.com/ice/3.8/runtime/endpoint-syntax.md#udp-endpoint-syntax) describes the options of a UDP endpoint, including its multicast options.

The [IceDiscovery](https://docs.zeroc.com/ice/3.8/plugins/icediscovery.md) plug-in uses UDP multicast to locate object adapters and well-known objects.
