show server(8rpc)

Synopsis

rpccp show server server-entry-name
[-i [if-id]] [-o [object-uuid]] [-s syntax] [-u]

Options

-i
Shows interface identifiers from binding information found in the entry (optional). Without the -i option, the command displays all interface identifiers.

To display a specific interface, supply its identifier as the value. The value has the following form:

interface-uuid,major-version.minor-version

The UUID is a hexadecimal string and the version numbers are decimal strings, for example:

-i ec1eeb60-5943-11c9-a309-08002b102989,1.1

Leading zeros in version numbers are ignored.

-o
Shows object UUIDs found in the entry (optional). Without the -o option, the command displays all object UUIDs. To display a specific object UUID, supply its string representation as the value, for example:

-o 3c6b8f60-5945-11c9-a236-08002b102989

-s
Indicates the name syntax of the entry name (optional). The only value for this option is the dce name syntax, which is the default name syntax. Until an alternative name syntax becomes available, specifying the -s option is unnecessary.

-u
Updates the local CDS cache copy of name service data (optional).

Name service data is cached locally on each machine in a cell. If an rpccp inquiry can be satisfied by data in the local CDS cache, this cached data is returned. Locally cached copies of name service data might not include a recent CDS update, however. If the required data is not available in the local CDS cache, rpccp goes to a CDS serve to retrieve the required data and then updates the local CDS cache.

Using the -u option bypasses the local cache, allowing rpccp to go directly to a CDS server for the inquiry and then update the local CDS cache.

Arguments

server-entry-name
Indicates the name of the target server. For an entry in the local cell, you can omit the cell name and specify only the cell-relative name.

Description
The show server command shows the RPC binding information, interface identifiers, and object UUIDs in a server entry. The entry name of the server entry is required.

This operation shows all of the potential bindings for an interface. By default, this command displays bindings for the specified version of the interface and for upwardly compatible versions of the interface. The -v option controls which versions are targeted by this command.

Privileges Required
You need read permission to the CDS object entry (the target server entry).

Notes
This command is replaced at Revision 1.1 by the dcecp command and may not be provided in future releases of DCE.

Examples
The following commands start the control program and show the server entry /.:/LandS/anthro/Cal_host_2 in the local cell:

rpccp> show server /.:/LandS/anthro/Cal_host_2

The following command operates from the system prompt to display a specific object and interface from the server entry /.:/LandS/anthro/Cal_host_2 in the local cell:

rpccp show server \
> /.:/LandS/anthro/Cal_host_2 \
> -o 16977538-e257-11c9-8dc0-08002b0f4528 \
> -i ec1eeb60-5943-11c9-a309-08002b102989,1.1

Related Information
Commands:

export(8rpc)

import(8rpc)

unexport(8rpc)