rpcgroup import

rpcgroup import rpcgroup_name_list [-interface interface_id]
[-object object_uuid] [-max integer] [-noupdate]

Options

-interface interface_id
Declares the interface identifier of one RPC interface.

See Data Structures for the format of the interface identifier.

-object object_uuid
Declares the UUID of one object. The UUID is a hexadecimal string.

See Data Structures for the format of the object UUID.

-max integer
Specifies the maximum number of string bindings to return. A value greater than one 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 believe that the local cache is up to date.

Description
The rpcgroup import operation returns a string binding from the specified RPC group. The argument is a list of names of RPC groups to import from. Uses the -interface, -version, and -object options to specify matching bindings. Each of these takes only one value not a list of values. Also accepts the -max option to specify a number of string bindings to return. 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 command imports an interface and object:

dcecp> rpcgroup import /.:/LandS/anthro/Cal_host_3 \
> -interface {ec1eeb60-5943-11c9-a309-08002b102989 1.1} \
> -object {30dbeea0-fb6c-11c9-8eea-08002b0f4528}
{ncadg_ip_udp 15.22.48.25}
{ncacn_ip_tcp 15.22.48.25}
dcecp>