PreviousNext

rpcprofile import

Returns a string binding from the specified RPC profile. The syntax is:

rpcprofile import profile_name_list -interface interface_id
[-object object_uuid] [-max integer] [-noupdate]

Options

-interface interface_id
Declares the interface identifier of an RPC interface. The import operation allows you to specify only one interface_id, not a list.

See Data Structures for the format of the interface identifier.

-object object_uuid_list
Declares the UUID of an object. Each import operation accepts a list of up to 32 object UUIDs. The UUID is a hexadecimal string.

-max integer
Specifies the maximum number of string bindings to return. A value greater than 1 returns a list containing up to the number of bindings specified by the value.

-noupdate
Usually, 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 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 have reason to believe that the local cache is up to date.

Description
The import operation returns a string binding from the specified RPC profile. The profile_name_list argument is a list of names of RPC profiles to import from. Uses the -interface and -object options to specify matching bindings. Each of these options takes only one value, not a list of values. The import operation also accepts the -max option to specify a number of string bindings to return. If the value is greater than 1, a list of as many matching bindings less than or equal to the value is returned. The order of bindings returned is arbitrary.

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.

Examples
The following example imports a binding:

dcecp> rpcprofile import /.:/cell_profile \
> -interface {458ffcbe-98c1-11cd-bd93-0000c08adf56 1.0}
{ncacn_ip_udp 15.22.48.25}
{ncacn_ip_udp 15.22.50.213}
{ncacn_ip_tcp 15.22.28.25}
{ncacn_ip_tcp 15.22.50.213}
dcecp>