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

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

# IceLocatorDiscovery.\*

This page describes the properties supported by the IceLocatorDiscovery 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.

## IceLocatorDiscovery.Address

`IceLocatorDiscovery.Address=addr`

Specifies the multicast IP address to use for sending [multicast discovery queries](https://docs.zeroc.com/ice/3.8/plugins/icelocatordiscovery.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, IceLocatorDiscovery uses the IPv6 address `ff15::1`
- Otherwise IceLocatorDiscovery uses `239.255.0.1`

This property is used to compose the value of [IceLocatorDiscovery.Lookup](#icelocatordiscovery.lookup).

## IceLocatorDiscovery.InstanceName

`IceLocatorDiscovery.InstanceName=name`

Specifies the name of a locator instance. If you have multiple unrelated locators deployed that use the same multicast address and port, you can define this property to limit your discovery results only to those locators deployed for the given instance. If not defined, the plug-in adopts the instance name of the first locator to respond to a query; if a subsequent query discovers a locator with a different instance name, the plug-in ignores the result. It traces the mismatch when `IceLocatorDiscovery.Trace.Lookup` is `3` or greater.

The instance name is the category of the discovered locator's identity. The plug-in also uses the configured name as the identity category of its own locator object, or a UUID if this property is not set.

## IceLocatorDiscovery.Interface

`IceLocatorDiscovery.Interface=intf`

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

## IceLocatorDiscovery.Lookup

`IceLocatorDiscovery.Lookup=endpoints`

Specifies the multicast endpoints used to send [discovery queries](https://docs.zeroc.com/ice/3.8/plugins/icelocatordiscovery.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 [IceLocatorDiscovery.Interface](#icelocatordiscovery.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 [IceLocatorDiscovery.Address](#icelocatordiscovery.address), `port` is the value of [IceLocatorDiscovery.Port](#icelocatordiscovery.port), and `intf` identifies the interface.

## IceLocatorDiscovery.Port

`IceLocatorDiscovery.Port=port`

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

## IceLocatorDiscovery.Reply.*AdapterProperty*

`IceLocatorDiscovery.Reply.AdapterProperty=value`

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

`udp -h "intf"`

Here, `intf` is [IceLocatorDiscovery.Interface](#icelocatordiscovery.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.

## IceLocatorDiscovery.RetryCount

`IceLocatorDiscovery.RetryCount=num`

Specifies the maximum number of times that the plug-in will retry sending UDP multicast queries before giving up. The [IceLocatorDiscovery.Timeout](#icelocatordiscovery.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.

## IceLocatorDiscovery.RetryDelay

`IceLocatorDiscovery.RetryDelay=num`

If the plug-in fails to receive any responses to a query after retrying the number of times specified by [IceLocatorDiscovery.RetryCount](#icelocatordiscovery.retrycount), the plug-in waits at least `num` milliseconds before a later locator request can start another round of query attempts. If not defined, the default value is `2000`.

## IceLocatorDiscovery.Trace.Lookup

`IceLocatorDiscovery.Trace.Lookup=num`

Controls lookup tracing in the `Lookup` trace category:

| Value | Description |
| --- | --- |
| `0` | No lookup trace (default). |
| `1` | Trace lookup success, failure and timeout. |
| `2` | Like `1`, and trace lookup invocations. |
| `3` | Like `2`, and trace replies ignored because their instance name does not match. |

## IceLocatorDiscovery.Timeout

`IceLocatorDiscovery.Timeout=num`

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