---
title: "Syntax for Stringified Proxies"
url: https://docs.zeroc.com/ice/3.8/runtime/invocation/syntax-for-stringified-proxies
docs_index: https://docs.zeroc.com/llms.txt
---

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

# Syntax for Stringified Proxies

## Synopsis

`identity [options]`

`identity [options] @ adapter_id`

`identity [options] : endpoint[:endpoint...]`

## Description

A stringified proxy consists of an identity, optional proxy options, and optional addressing information. The three forms of the synopsis represent:

- a [well-known proxy](https://docs.zeroc.com/ice/3.8/runtime/invocation/proxy-endpoints.md#well-known-proxy), with an identity and no addressing information
- a [proxy with an adapter ID](https://docs.zeroc.com/ice/3.8/runtime/invocation/proxy-endpoints.md#proxy-with-an-adapter-id)
- a direct proxy, with an identity and one or more endpoints

The first two are indirect proxies, which Ice resolves with the [locator](https://docs.zeroc.com/ice/3.8/runtime/locators.md).

White space separates the components of a stringified proxy. The proxy options follow the identity and precede the `@` or `:` separator.

## Options

| Option | Description |
| --- | --- |
| `-f facet` | Sets the [facet](https://docs.zeroc.com/ice/3.8/runtime/facets.md) of the target object. |
| `-e encoding` | Sets the encoding version that invocations on this proxy use to marshal parameters. The default is the value of [Ice.Default.EncodingVersion](https://docs.zeroc.com/ice/3.8/property-reference/ice-default-properties.md#ice.default.encodingversion). |
| `-p protocol` | Sets the Ice protocol version of the requests sent with this proxy. The default is `1.0`, the only version Ice supports. |
| `-t` | Configures the proxy for twoway invocations (default). |
| `-o` | Configures the proxy for oneway invocations. |
| `-O` | Configures the proxy for batch oneway invocations. |
| `-d` | Configures the proxy for datagram invocations. |
| `-D` | Configures the proxy for batch datagram invocations. |

Use at most one of `-t`, `-o`, `-O`, `-d`, and `-D`.

## Identity, Facet, and Adapter ID

The identity has the form `[category/]name`, where `category` and `name` are strings encoded as described in [Object Identity](https://docs.zeroc.com/ice/3.8/runtime/object-identity.md): a slash (`/`) in `category` or `name` is escaped as `\/`. The facet and the adapter ID are strings encoded like a [Slice string literal](https://docs.zeroc.com/ice/3.8/slice/constants-and-literals.md).

Enclose the identity or the facet in quotes if it contains white space, `:`, or `@`, and the adapter ID if it contains white space. Double quotes let the value contain a single quote, and single quotes let it contain a double quote. For example:

```text
"store/item one" -f 'admin:read' : tcp -h localhost -p 4061
store/item @ "Adapter A"
```

## Endpoints

The endpoints of a direct proxy are separated with a colon (`:`) and formatted as described in [Endpoint Syntax](https://docs.zeroc.com/ice/3.8/runtime/endpoint-syntax.md).

## See Also

- [Endpoint Syntax](https://docs.zeroc.com/ice/3.8/runtime/endpoint-syntax.md)
- [Ice.Default.\*](https://docs.zeroc.com/ice/3.8/property-reference/ice-default-properties.md)
