---
title: "IceDiscovery.*"
url: https://docs.zeroc.com/ice/3.8/property-reference/icediscovery-properties
docs_index: https://docs.zeroc.com/llms.txt
---

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

# IceDiscovery.\*

This page describes the properties supported by the [IceDiscovery](https://docs.zeroc.com/ice/3.8/plugins/icediscovery.md) plug-in.

These properties configure the C++, C#, and Java plug-ins. Python, Ruby, PHP, MATLAB, and Swift use the C++ plug-in. JavaScript does not support this plug-in.

## IceDiscovery.Address

`IceDiscovery.Address=addr`

Specifies the multicast IP address to use for sending or receiving [multicast discovery queries](https://docs.zeroc.com/ice/3.8/plugins/icediscovery.md). If not defined, the default value depends on other property settings:

- If [Ice.PreferIPv6Address](https://docs.zeroc.com/ice/3.8/property-reference/ice-properties.md) is enabled or [Ice.IPv4](https://docs.zeroc.com/ice/3.8/property-reference/ice-properties.md) is disabled, IceDiscovery uses the IPv6 address `ff15::1`
- Otherwise IceDiscovery uses `239.255.0.1`

This property is used to compose the value of [IceDiscovery.Lookup](#icediscovery.lookup) and [IceDiscovery.Multicast.Endpoints](#icediscovery.multicast.adapterproperty).

## IceDiscovery.DomainId

`IceDiscovery.DomainId=id`

Specifies the domain ID used to locate objects and object adapters. The IceDiscovery plug-in only responds to requests from clients with the same domain ID and ignores requests from clients with a different domain ID. If not defined, the default domain ID is an empty string.

## IceDiscovery.Interface

`IceDiscovery.Interface=intf`

Specifies the IP address of the interface to use for sending or receiving [multicast discovery queries](https://docs.zeroc.com/ice/3.8/plugins/icediscovery.md). If not defined, the discovery will use all the network interfaces available on the system to send and receive UDP multicast datagrams. This property is used to compose the value of [IceDiscovery.Lookup](#icediscovery.lookup), [IceDiscovery.Reply.Endpoints](#icediscovery.reply.adapterproperty) and [IceDiscovery.Multicast.Endpoints](#icediscovery.multicast.adapterproperty).

## IceDiscovery.Lookup

`IceDiscovery.Lookup=endpoints`

Specifies the multicast endpoints used to send [discovery queries](https://docs.zeroc.com/ice/3.8/plugins/icediscovery.md). The plug-in sends each query on every endpoint in this list.

When this property is not set, the plug-in creates one endpoint per multicast-capable interface selected by [IceDiscovery.Interface](#icediscovery.interface), or per available multicast-capable interface if that property is not set. It joins these endpoints with colons. Each endpoint has the form:

`udp -h "addr" -p port --interface "intf"`

Here, `addr` is the value of [IceDiscovery.Address](#icediscovery.address), `port` is the value of [IceDiscovery.Port](#icediscovery.port), and `intf` identifies the interface.

## IceDiscovery.Multicast.*AdapterProperty*

`IceDiscovery.Multicast.AdapterProperty=value`

IceDiscovery creates an object adapter named `IceDiscovery.Multicast` for receiving discovery queries from clients. When [IceDiscovery.Multicast.Endpoints](https://docs.zeroc.com/ice/3.8/property-reference/object-adapter-properties.md#adapter.endpoints) is not set, the plug-in sets it to:

`udp -h "addr" -p port [--interface "intf"]`

where `addr` is the value of [IceDiscovery.Address](#icediscovery.address), `port` is the value of [IceDiscovery.Port](#icediscovery.port), and `intf` is the value of [IceDiscovery.Interface](#icediscovery.interface).

## IceDiscovery.LatencyMultiplier

`IceDiscovery.LatencyMultiplier=num`

Specifies the multiplier to apply to the latency of the first discovery request-reply for replica groups. When IceDiscovery receives a reply for a discovery request and this reply indicates that the adapter ID is a replica group, it waits for an additional time interval for other responses from replicated servers. This time interval is based on the latency of the first request-reply and the latency multiplier. For example, if the first reply is received after 15 milliseconds and the multiplier is set to `4`, IceDiscovery will wait for an additional 60 milliseconds for replies from other servers. If not defined, the default is `1`. `num` must be `1` or greater.

## IceDiscovery.Port

`IceDiscovery.Port=port`

Specifies the multicast port to use for sending or receiving multicast requests. If not set, the default value is `4061`.

## IceDiscovery.Reply.*AdapterProperty*

`IceDiscovery.Reply.AdapterProperty=value`

IceDiscovery creates an object adapter named `IceDiscovery.Reply` for receiving replies to [multicast requests](https://docs.zeroc.com/ice/3.8/plugins/icediscovery.md). If not otherwise defined by `IceDiscovery.Reply.Endpoints`, the endpoint for this object adapter is composed as follows:

`udp -h "intf"`

Here, `intf` is [IceDiscovery.Interface](#icediscovery.interface). When that property is unset, the plug-in uses `udp -h *` to bind to all local interfaces. The [object adapter properties](https://docs.zeroc.com/ice/3.8/property-reference/object-adapter-properties.md) configure the other settings of this adapter.

## IceDiscovery.RetryCount

`IceDiscovery.RetryCount=num`

Specifies the maximum number of times that the plug-in will retry sending UDP multicast requests before giving up. The [IceDiscovery.Timeout](#icediscovery.timeout) property determines how long the plug-in waits for a reply before trying again. If not defined, the default retry count is `3`, for a total of four attempts. A value of `0` sends only the initial query.

## IceDiscovery.Timeout

`IceDiscovery.Timeout=num`

Specifies the time interval in milliseconds to wait for replies to UDP multicast requests. If no server replies during this time interval, the client will retry the request the number of times specified by [IceDiscovery.RetryCount](#icediscovery.retrycount). If not defined, the default timeout is `300`. `num` must be greater than `0`.
