...
Proxy options configure the invocation mode:
| Select a facet of the Ice object. |
| Specify the Ice encoding version to use when an invocation on this proxy marshals parameters. |
| Specify the Ice protocol version to use when sending a request with this proxy. |
| 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 |
---|---|---|---|
| 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. |
Info | ||
---|---|---|
| ||
With the 1.0 encoding, UDP endpoints supported 2 additional options: the -e major.minor and -v major.minor options. These 2 options specified which encoding and protocol was supported by the endpoint. These two options are deprecated with the 1.1 encoding and are ignored (a deprecation warning will be emitted when parsed by the communicator |
...
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). |
-e encoding | Specifies the encoding version used to encode the endpoint marshaled data. |
| Specifies the marshaled encoding of the endpoint in base-64 encoding. |
Exactly one each of the -t
and -v
options must be present in an opaque endpoint. If -e
is not specified, the current encoding supported by the Ice runtime is assumed.
...