NAME

import  - Imports binding information and an object UUID from a server entry

SYNOPSIS

rpccp import starting-entry-name -i if-id [-v versions] [-e] [-n [integer]]
[-o object-uuid] [-s syntax] [-u]

OPTIONS

-i if-idDefines an interface identifier to be imported (required).  You can import only one interface at a time. 

The 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, as in the following example:

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

Leading zeros in version numbers are ignored. 

-v versionsIndicates how a specified interface version is used (optional).  If it is used without the ­-i option, the ­-v option is ignored.  The possible combinations of versions for the ­-v option and their actions are as follows:

allThe interface version is ignored. 

exactBoth the major and minor versions must match the specified versions. 

compatibleThe major version must match the specified version, and the minor version must be greater than or equal to the specified version. 

major_only
The major version must match the specified version; the minor version is ignored.

uptoThe major version must be less than or equal to that specified.  If the major versions are equal, the minor version must be less than or equal to that specified. 

If the ­-v option is absent, the command shows compatible version numbers. 

-eShows the name of the entry where the binding is found (optional). 

-n [integer]Declares that the import operation is to continue until no more potential bindings are found (optional).  Providing a numeric value to this option restricts the number of imported bindings.  If you omit the number, only one binding is imported.  If repeated, this operation may return the same binding.  For example, -n imports all available bindings, and -n 5 imports up to five bindings.  Note that the imported bindings are displayed as string bindings. 

-o object-uuid
Declares the UUID of an object to be imported (optional). Only one UUID can occur in a single operation.

If an object is specified, the import operation limits its search to server entries that contain both the specified interface identifier and object UUID when searching for a potential binding.  Without the ­-o option, the import operation ignores object UUIDs. 

The UUID is a hexadecimal string, as in the following example:

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

-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 Firectory 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 caches is then updated by rpccp. 

ARGUMENTS

starting-entry-name
Indicates the name of the server entry where the import operation starts. For an entry in the local cell, you can omit the cell name and specify only the cell-relative name.

DESCRIPTION

The import command imports binding information and a remote procedure call (RPC) object UUID for a specific RPC interface from a server entry.  The name of the entry and the interface identifier are required.  The entry name can refer to a server entry, a group, or a profile. 

Privileges Required

You need r (read) permission to the specified CDS object entry (the starting name service entry) and to any CDS object entry in the resulting search path. 

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 commandd imports an interface and object:

rpccp> import -i ec1eeb60-5943-11c9-a309-08002b102989,1.1 \
       -o 30dbeea0-fb6c-11c9-8eea-08002b0f4528 /.:/LandS/anthro/Cal_host_3

RELATED INFORMATION

Commands:

rpccp_export(8rpc), rpccp_show_server(8rpc), unexport(8rpc).