endpoint show

endpoint show [host_address] [-uuid]

-interface interface_id [-version versions] [-object object_uuid_list]]

Options

-uuid
Specifies that the UUID of the endpoint map is to be returned. It cannot be used with -interface, -version, or -object.

-interface interface_id
This option specifies the interface identifier of a single RPC interface for which you want to see the endpoint mapping information.

See Data Structures for the format of the interface identifier.

-version versions
Specifies interface version numbers to be returned with the show operation.

See Data Structures for the exact behavior of the version values.

-object object_uuid_list
Declares the UUID of an object. Each show operation accepts a list of up to 32 object UUIDs.

See Data Structures for the format of the object UUID.

Description
The endpoint show operation returns a list of information about endpoints in the endpoint map of a local or remote host. With no options, it returns all the local endpoint mappings. The -interface, -version, and -object options can be used so that only those endpoint mappings matching the supplied values are returned. The -object option accepts a list as a value; the others do not. The optional host_address argument is the address of the host whose endpoint map is to be shown. If no argument is supplied, the local host's endpoint map is used. See Data Structures for the format of a host address.

If the -uuid option is specified, then the UUID of the specified host's endpoint map is to be returned, rather than any information about the endpoints themselves. Each endpoint map is given a UUID on creation. If you know the current UUID of an endpoint map, you can delete any other stale UUIDs that may be in the RPC entry. If you specify the -uuid option, you must not specify any other options.

Privileges Required
No special privileges are needed to use the endpoint show command.

Examples
The following example uses the dcecp string syntax to specify an interface for which to show local endpoint map information.

dcecp> endpoint show -interface {458ffcbe-98c1-11cd-bd93-0000c08adf56 1.0}
{{object 76030c42-98d5-11cd-88bc-0000c08adf56}
{interface {458ffcbe-98c1-11cd-bd93-0000c08adf56 1.0}}
{binding {ncacn_ip_tcp 130.105.1.227 1072}}
{annotation {Bulletin Board Server, Version 1.3a}}}
dcecp>

The following command shows the endpoint objects in the local endpoint map that contain the specified interface identifier. This interface supports two object UUIDs on two protocol sequences.

dcecp> endpoint show -interface 257df1c9-c6d3-11ca-8554-08002b1c8f1f,1.0
{{object a57104f4-dfd0-11ca-b428-08002b1c8a62}
{interface {257df1c9-c6d3-11ca-8554-08002b1c8f1f 1.0}}
{binding {ncacn_ip_tcp 130.105.1.227 1040}}
{annotation {cdsd [910]}}}{{object a57104f4-dfd0-11ca-b428-08002b1c8a62}
{interface {257df1c9-c6d3-11ca-8554-08002b1c8f1f 1.0}}
{binding {ncadg_ip_udp 130.105.1.227 1163}}
{annotation {cdsd [910]}}}{{object b32648c6-928d-11cd-b4b5-0000c08adf56}
{interface {257df1c9-c6d3-11ca-8554-08002b1c8f1f 1.0}}
{binding {ncacn_ip_tcp 130.105.1.227 1042}}
{annotation cds_clerkserver}}{{object b32648c6-928d-11cd-b4b5-0000c08adf56}
{interface {257df1c9-c6d3-11ca-8554-08002b1c8f1f 1.0}}
{binding {ncadg_ip_udp 130.105.1.227 1168}}
{annotation cds_clerkserver}}
dcecp>

The following command shows the UUID of the endpoint map on the host with the specified network address.

dcecp> endpoint show ncadg_ip_udp:130.105.1.227 -uuid
7273c754-e51c-11cd-bc0e-0000c08de054
dcecp>