import(1m)																import(1m)

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

       Defines 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 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.	 Indicates  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:

						   +-----------+-------------------------------------+
						   |Versions   | Action 			     |
						   +-----------+-------------------------------------+
						   |all        | The interface version is ignored.   |
						   |exact      | Both the major and  minor  versions |
						   |	       | must match the specified versions.  |
						   |compatible | The  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 ver- |
						   |	       | sion is ignored.		     |
						   |upto       | The 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.  Shows  the  name  of	the  entry  where  the	binding  is  found
       (optional).   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.  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, for example: -o 3c6b8f60-5945-11c9-a236-08002b102989

       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.  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 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.  rpccp then updates the  local
       CDS cache.

ARGUMENTS

       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 an 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.

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

NOTE

       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 run RPCCP and import an interface and object: $ rpccp rpccp>  import -i ec1eeb60-5943-11c9-a309-08002b102989,1.1  >
       -o 30dbeea0-fb6c-11c9-8eea-08002b0f4528	 > /.:/LandS/anthro/Cal_host_3

RELATED INFORMATION

       Commands: export(1m), show server(1m), unexport(1m)

																	import(1m)