rpcgroup(1m)rpcgroup(1m)NAME
rpcgroup - A dcecp object that manages an RPC group entry in CDS
SYNOPSIS
rpcgroup add rpcgroup_name_list -member member_name_list
rpcgroup create rpcgroup_name_list
rpcgroup delete rpcgroup_name_list
rpcgroup help [operation | -verbose]
rpcgroup import rpcgroup_name_list -interface interface_id [-object
object_uuid] [-max integer] [-noupdate]
rpcgroup list rpcgroup_name_list [-member member_name_list] [-noupdate]
rpcgroup operations
rpcgroup remove rpcgroup_name_list -member member_name_list
ARGUMENTS
The name of the rpcgroup operation for which to display help informa‐
tion. Specifies a list of one or more names of the RPC groups to be
operated on.
DESCRIPTION
The rpcgroup object represents a remote procedure call (RPC) group
entry in the Cell Directory Service (CDS). Each RPC group is named in
the DCE namespace; therefore, each operation takes as an argument a
list of names of group entries to manipulate. An RPC group is a con‐
tainer that contains only the names of RPC server entries or the names
of other RPC groups; it contains no other data.
DATA STRUCTURES
The interface identifier of an RPC interface. The interface identifier
takes the following form: interface-uuid,major-version.minor-version
The version numbers are optional. If you omit a version number, the
default is 0. The UUID is a hexadecimal string and the complete ver‐
sion number is a decimal string. For example: -interface
ec1eeb60-5943-11c9-a309-08002b102989,3.11 Leading zeros in version num‐
bers are ignored.
Alternatively, you can use Tcl syntax. For example: -interface
{458ffcbe-98c1-11cd-bd93-0000c08adf56 1.0} The UUID of an object. The
UUID is a hexadecimal string, for example: -object
3c6b8f60-5945-11c9-a236-08002b102989
Alternatively, you can use Tcl syntax. For example: -object
{3c6b8f60-5945-11c9-a236-08002b102989}
OPERATIONS
rpcgroup add
Adds a member to the specified group entry in CDS. The syntax is as
follows: rpcgroup add rpcgroup_name_list -member member_name_list
Options
This required option declares the name of a member to be added to the
specified group entry. The member_name_list argument is a list of
names of one or more members to be added to all of the specified
groups. (The names need not exist when they are added.) All members
are added to all groups.
The add operation adds a member to the specified group entry in CDS.
The required rpcgroup_name_list argument is a list of one or more full
CDS names of the groups to which you want to add members. This opera‐
tion returns an empty string on success. If member_name_list contains
the names of duplicate or existing members, the duplicates are ignored
and no errors are generated.
Privileges Required
You need i (insert) permission to the parent directory. You also need
both r (read) permission and w (write) permission to the CDS object
entry (the target group entry).
Examples
The following command adds the member /.:/LandS/anthro/Cal_host_3 to
the group /.:/LandS/anthro/Calendar_group: dcecp> rpcgroup add
/.:/LandS/anthro/Calendar_group \ > -member /.:/LandS/anthro/Cal_host_3
dcecp>
rpcgroup create
Creates an empty RPC group entry in CDS. The syntax is as follows:
rpcgroup create rpcgroup_name_list
The create operation creates a new (empty) RPC group entry in CDS.
Since an empty group is the same as an empty RPC entry or RPC profile,
calling rpcgroup create is the same as calling rpcentry create or
rpcprofile create. The rpcgroup_name_list argument is a list of names
of RPC groups to be created. This operation returns an empty string on
success. If the RPC group already exists, an error is returned.
Privileges Required
You need i (insert) permission to the parent directory.
Examples
The following command creates a new group called /.:/LandS/anthro/Cal‐
endar_group: dcecp> rpcgroup create /.:/LandS/anthro/Calendar_group
dcecp>
rpcgroup delete
Removes the specified group from CDS. The syntax is as follows: rpc‐
group delete rpcgroup_name_list
The delete operation removes the specified group entry from CDS. The
rpcgroup_name_list argument is a list of names of RPC group entries to
be deleted. This operation returns an empty string on success. If the
RPC group entry does not exist, an error is generated.
Privileges Required
You need w (write) permission to the CDS object entry (the target group
entry).
Examples
The following command removes the group /.:/LandS/anthro/Calendar_group
from CDS. dcecp> rpcgroup delete /.:/LandS/anthro/Calendar_group
dcecp>
rpcgroup help
Returns help information about the rpcgroup object and its operations.
The syntax is as follows: rpcgroup help [operation | -verbose] Options
Displays information about the rpcgroup object.
Used without an argument or option, the rpcgroup help command returns
brief information about each rpcgroup operation. The optional opera‐
tion argument is the name of an operation about which you want detailed
information. Alternatively, you can use the -verbose option for more
detailed information about the rpcgroup object itself.
Privileges Required
No special privileges are needed to use the rpcgroup help command.
Examples dcecp> rpcgroup help add Adds members to a
list of RPC groups. create Creates a list of empty RPC
groups. delete Deletes a list of RPC groups. import
Returns the bindings from a list of RPC groups. list
Returns the members of a list of RPC groups. remove
Removes members from a list of RPC groups. help Prints
a summary of command-line options. operations Returns a list
of the valid operations for this command. dcecp>
rpcgroup import
Returns a string binding from the specified RPC group. The syntax is
as follows: rpcgroup import rpcgroup_name_list -interface interface_id
[-object object_uuid] [-max integer] [-noupdate]
Options
Declares the interface identifier of a single RPC interface.
See DATA STRUCTURES for the format of an interface identifier.
Declares the UUID of an object. The UUID is a hexadecimal string.
See DATA STRUCTURES for the format of an object UUID. 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. Normally, 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 one or more CDS
servers 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.
The import operation returns a string binding from the specified RPC
group. The rpcgroup_name_list argument is a list of names of RPC
groups to import from. The operation uses the -interface and -object
options to specify matching bindings. The operation 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 result‐
ing search path.
Examples
The following command imports a binding: dcecp> rpcgroup import
/.:/ortho_group \ > -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>
rpcgroup list
Returns a list of the names of all members of the specified group. The
syntax is as follows: rpcgroup list rpcgroup_name_list [-member mem‐
ber_name_list] [-noupdate]
Options
Specifies a list of names of one or more members to be returned from
all groups named in the rpcgroup_name_list argument. Use this option
to check for specific member names. The member_name_list argument
specifies a list of names of RPC entries, RPC groups, or RPC profiles;
they are only references stored in the RPC group and do not have to
exist outside of the group. All members specified are listed from all
RPC groups specified in the argument. Use -noupdate to avoid taking
the time to update the local cache.
See rpcgroup import for more information.
The list operation returns a list of the names of all members of the
specified group. The names returned are fully qualified and are
returned in an arbitrary order. The rpcgroup_name_list argument is a
list of names of RPC groups whose members' names are to be returned.
Privileges Required
You need r (read) permission to the CDS object entry (the target group
entry).
Examples
The following example lists all the members of the group /.:/sub‐
sys/applications/infobases, in the order in which they were added to
the group: dcecp> rpcgroup list /.:/subsys/applications/infobases
/.../my_cell.goodcompany.com/subsys/applications/video_server
/.../my_cell.goodcompany.com/subsys/applications/bbs_server
/.../my_cell.goodcompany.com/subsys/applications/audio_server1
/.../my_cell.goodcompany.com/subsys/applications/audio_server2
/.../my_cell.goodcompany.com/subsys/applications/clipart_server
/.../my_cell.goodcompany.com/subsys/applications/photo_server1
/.../my_cell.goodcompany.com/subsys/applications/photo_server2 dcecp>
The following example uses the -member option to list a specific member
of the group /.:/subsys/applications/infobases: dcecp> rpcgroup list
/.:/subsys/applications/infobases \ > -member /.:/subsys/applica‐
tions/bbs_server /.../my_cell.goodcompany.com/subsys/applica‐
tions/bbs_server dcecp>
rpcgroup operations
Returns a list of the operations supported by the rpcgroup object. The
syntax is as follows: rpcgroup operations
The list of available operations is in alphabetical order except for
help and operations, which are listed last.
Privileges Required
No special privileges are needed to use the rpcgroup operations com‐
mand.
Examples
dcecp> rpcgroup operations add create delete import list remove help
operations dcecp>
rpcgroup remove
Removes one or more members from the specified group. The syntax is as
follows: rpcgroup remove rpcgroup_name_list -member member_name_list
Options
This required option lets you specify a list of names of one or more
members to be removed from all groups named in the rpcgroup_name_list
argument. The member_name_list argument specifies a list of names of
RPC entries, RPC groups, or RPC profiles; these are only references
stored in the RPC group and need not exist outside of the group. All
members specified are removed from all RPC groups specified in the
argument.
The remove operation removes one or more members from the specified
group. The rpcgroup_name_list argument is a list of names of RPC
groups from which to have members removed. The value of the required
-member option is a list of names of RPC entries, RPC groups, or RPC
profiles. If a specified member does not exist in an RPC group, an
error is returned. This operation returns an empty string on success.
Privileges Required
You need r (read) permission and w (write) permission to the CDS object
entry (the target group entry).
Examples
The following command removes the member /.:/subsys/applica‐
tions/video_server from the RPC group /.:/subsys/applica‐
tions/infobases: dcecp> rpcgroup remove /.:/subsys/applica‐
tions/infobases \ > -member /.../my_cell.goodcompany.com/subsys/appli‐
cations/video_server dcecp>
RELATED INFORMATION
Commands: dcecp(1m), dcecp_endpoint(1m), dcecp_rpcentry(1m),
dcecp_rpcprofile(1m).
rpcgroup(1m)