NAME

show entry - Shows the NSI attributes of a name service entry

SYNOPSIS

rpccp show entry entry-name [-i if-id] [-s syntax] [-u]

OPTIONS

-i if-idSelects a specified interface identifier (optional).  Only elements containing that identifier are shown.  The interface identifier value has the following form:

interface-uuid,major-version.minor-version

The Universal Unique Identifier (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. 

-s syntaxIndicates 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. 

-uUpdates the local Cell Directory Service (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 server(s) to retrieve the required data.  rpccp 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.  The local CDS cache is then updated by rpccp

ARGUMENTS

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

DESCRIPTION

The show entry command shows the Name Service Interface (NSI) attributes of a name service entry.  The name of the entry is required. 

Note that this operation shows all of the compatible bindings for a given interface. 

The show entry command shows the same list of string bindings as the import operation returns for the specified entry.  This list includes all string bindings that refer to a major version that matches the specified version and a minor version that is equal to or greater than the specified version.  The list may include string bindings exported for other versions of the interface that are upwardly compatible, rather than for this particular version of the interface. 

Privileges Required

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

NOTES

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

EXAMPLES

The following commands show the NSI attributes of name service entries:

rpccp show entry /.:/LandS/anthro/Cal_host_3
rpccp> show entry /.:/LandS/anthro/Calendar_group

RELATED INFORMATION

Commands:

rpccp_add_entry(8rpc), rpccp_remove_entry(8rpc).