PreviousNext

rpcentry show

Returns a list that contains the binding information in the specified RPC entries. The syntax is:

rpcentry show entry_name_list -interface interface_id_list
[-object object_uuid_list] [-noupdate]

Options

-interface interface_id_list
Declares a list of one or more interface identifiers of RPC interfaces.

See Data Structures for the format of the interface identifier.

-object object_uuid_list
Declares the UUID of an object. Accepts a list of up to 32 object UUIDs. The UUID is a hexadecimal string.

See Data Structures for the format of the object UUID.

-noupdate
Normally, name service data is cached locally on each machine in a cell. If a name service inquiry can be satisfied by data in the local CDS cache, this cached data is returned. However, locally cached copies of name service data might not include a recent CDS update. If the -noupdate option is not specified, dcecp goes to a CDS server(s) to retrieve the required data, updating the local CDS cache. Use the -noupdate option (to avoid taking the time to update the local cache) when you believe that the local cache is up to date.

Description
The rpcentry show operation returns a list that contains the binding information in the specified RPC entry. The argument is a list of one or more names of server entries to return information about.

The returned list consists of two lists. Each item in the first list is also a list, where the first two elements are the interface identifier (the UUID and then the version), and the rest of the elements are string bindings in Tcl syntax. The second list is a list of Object UUIDs exported by the server. The order of the data returned is arbitrary.

Privileges Required
You need r (read) permission to the CDS object entry (the target name service entry).

Examples
The following command uses the dcecp string syntax to show the name service entry:

dcecp> rpcentry show /.:/subsys/applications/bbs_server
{458ffcbe-98c1-11cd-bd93-0000c08adf56 1.0
{ncacn_ip_tcp 130.105.1.227}}
{76030c42-98d5-11cd-88bc-0000c08adf56}
dcecp>

The following command operates from the system prompt to show the name service entry:

% dcecp> rpcentry show /.:/subsys/applications/bbs_server
{458ffcbe-98c1-11cd-bd93-0000c08adf56 1.0
{ncacn_ip_tcp 130.105.1.227}}
{76030c42-98d5-11cd-88bc-0000c08adf56}
%