...
Proxy options configure the invocation mode:
| Select a facet of the Ice object. |
| Configures the proxy for twoway invocations (default). |
| Configures the proxy for oneway invocations. |
| Configures the proxy for batch oneway invocations. |
| Configures the proxy for datagram invocations. |
| Configures the proxy for batch datagram invocations. |
| Configures the proxy for secure invocations. |
The proxy options -t
, -o
, -O
, -d
, and -D
are mutually exclusive.
...
The presence (or absence) of the host
parameter has a significant influence on the behavior of the Ice run time. The table below describes these semantics:
Value | Client Semantics | Server Semantics |
---|---|---|
None | If | If |
Host name | The host name is resolved via DNS. Outgoing connections are attempted to each address returned by the DNS query. | The host name is resolved via DNS, and the object adapter listens on the network |
interface corresponding to |
the first address returned by the DNS query. The specified host name is embedded in proxies created by the adapter. | ||
IPv4 address | An outgoing connection is attempted to the given address. | The object adapter listens on the network interface corresponding to the address. The specified address is embedded in proxies created by the adapter. |
IPv6 address | An outgoing connection is attempted to the given address. | The object adapter listens on the network interface corresponding to the address. The specified address is embedded in proxies created by the adapter. |
| A "wildcard" IPv4 address that causes Ice to try all local interfaces when establishing an outgoing connection. | Equivalent to * (see below). |
| A "wildcard" IPv6 address that causes Ice to try all local interfaces when establishing an outgoing connection. | Equivalent to * (see below). |
| Not supported in proxies. | The adapter listens on all network interfaces (including the loopback interface), that is, binds to INADDR_ANY for the enabled protocols (IPv4 and/or IPv6). Endpoints for all addresses except loopback and IPv6 link-local are published in proxies (unless loopback is the only available interface, in which case only loopback is published). |
There is one additional benefit in specifying a wildcard address for host
(or not specifying it at all) in an object adapter's endpoint: if the list of network interfaces on a host may change while the application is running, using a wildcard address for host
ensures that the object adapter automatically includes the updated interfaces. Note however that the list of published endpoints is not changed automatically; rather, the application must explicitly refresh the object adapter's endpoints. For diagnostic purposes, you can set the configuration property Ice.Trace.Network=3
to cause Ice to log the current list of local addresses that it is substituting for the wildcard address.
...
A tcp
endpoint supports the following options:
Option | Description | Client Semantics | Server Semantics |
---|---|---|---|
| Specifies the host name or IP address of the endpoint. If not specified, the value of | See #Address Syntax. | See #Address Syntax. |
| Specifies the port number of the endpoint. | Determines the port to which a connection attempt is made (required). | The port will be selected by the operating system if this option is not specified or |
| Specifies the endpoint timeout in milliseconds. | If | If |
| Specifies bzip2 compression. | Determines whether compressed requests are sent. | Determines whether compression is advertised in proxies created by the adapter. |
UDP Endpoint Syntax
Synopsis
...
A udp
endpoint supports the following options:
Option | Description | Client Semantics | Server Semantics |
---|---|---|---|
| The protocol version to use when sending a request to the target object. This option is deprecated as of Ice 3.5. Its default value is 1.0; if specified, it must be set to 1.0 as well. |
|
|
| The encoding version to use when sending a request to the target object. This option is deprecated as of Ice 3.5. Its default value is 1.0; if specified, it must be set to 1.0 as well. |
|
|
| Specifies the host name or IP address of the endpoint. If not specified, the value of | See Address Syntax. | See Address Syntax. |
| Specifies the port number of the endpoint. | Determines the port to which datagrams are sent (required). | The port will be selected by the operating system if this option is not specified or port is zero. |
| Specifies bzip2 compression. | Determines whether compressed requests are sent. | Determines whether compression is advertised in proxies created by the adapter. |
| Specifies the time-to-live (also known as "hops") of multicast messages. | Determines whether multicast messages are forwarded beyond the local network. If not specified, or the value of | N/A |
| Specifies the network interface or group for multicast messages (see below). | Selects the network interface for outgoing multicast messages. If not specified, multicast messages are sent using the default interface. | Selects the network interface to use when joining the multicast group. If not specified, the group is joined on the default network interface. |
Multicast Interfaces
When host
denotes a multicast address, the --interface
INTF
option selects a particular network interface to be used for communication. The format of INTF
depends on the language and IP version:
...
An ssl
endpoint supports the following options:
Option | Description | Client Semantics | Server Semantics |
---|---|---|---|
| Specifies the host name or IP address of the endpoint. If not specified, the value of | See #Address Syntax. | See #Address Syntax. |
| Specifies the port number of the endpoint. | Determines the port to which a connection attempt is made (required). | The port will be selected by the operating system if this option is not specified or port is zero. |
| Specifies the endpoint timeout in milliseconds. | If | If |
| Specifies bzip2 compression. | Determines whether compressed requests are sent. | Determines whether compression is advertised in proxies created by the adapter. |
Ztop |
---|
Opaque Endpoint Syntax
...
An opaque
endpoint supports the following options:
Option | Description |
---|---|
| Specifies the transport for the endpoint. Transports are indicated by positive integers (1 for TCP, 2 for SSL, and 3 for UDP). |
| Specifies the marshaled encoding of the endpoint (including its enclosing encapsulation) in base-64 encoding. |
Exactly one each of the -t
and -v
options must be present in an opaque endpoint.
...