PreviousNext

Viewing Information in The Endpoint Map

For the most part, the endpoint map on each host takes care of itself, purging stale entries when necessary and removing the endpoint information each time the host reboots. So there's really no administration needed for the endpoint map.

However, when client/server communication problems arise, the information stored in the endpoint map might be useful to administrators, particularly for determining whether servers are supplying the correct endpoint information to clients. In this case, you can use the endpoint object to view endpoint map information. Besides its use in troubleshooting, you can also use the endpoint object for other specialized server operations such as adding new object UUIDs to existing mappings.

Endpoints are not protected by ACLs. This means anyone who can run dcecp can use an endpoint show operation on their host to view endpoint information on any other host in the cell. Other endpoint operations such as creating or deleting endpoints can be performed only by users that are logged into the local host. No other special privileges, such as system administrator or root privileges, are needed for local access to endpoint information.

You can view information stored in a host's endpoint map database by using an endpoint show operation. The following example shows the endpoint map information for the video_clip server on a remote host megazoid. Omit the hostname argument to operate on the local endpoint map.

dcecp> endpoint show /.:/hosts/megazoid \

> -interface {2fa417e8-bb4c-11cd-831b-0000c08adf56 1.0} \

{{object 99ff4fb8-c042-11cd-91cd-0000c08adf56}

{interface {2fa417e8-bb4c-11cd-831b-0000c08adf56 1.0}}

{binding {ncacn_ip_tcp 130.105.1.227 1028}}

{annotation {Text Development Utilities}}}

dcecp>

You can view all of the endpoints in an endpoint map by not using any options with the endpoint show operation.