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 information. 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-ver-
sion The version numbers are optional. If you omit a version number, the default is 0. The UUID is a hexadecimal string and the complete
version number is a decimal string. For example: -interface ec1eeb60-5943-11c9-a309-08002b102989,3.11 Leading zeros in version numbers 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 operation 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/Calendar_group: dcecp> rpcgroup create /.:/LandS/anthro/Calendar_group
dcecp>
rpcgroup delete
Removes the specified group from CDS. The syntax is as follows: rpcgroup 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 inter-
face_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
member_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 /.:/subsys/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/applications/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 command.
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 mem-
ber_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/applications/video_server from the RPC group /.:/subsys/applications/infobases: dcecp>
rpcgroup remove /.:/subsys/applications/infobases > -member /.../my_cell.goodcompany.com/subsys/applications/video_server dcecp>
RELATED INFORMATION
Commands: dcecp(1m), dcecp_endpoint(1m), dcecp_rpcentry(1m), dcecp_rpcprofile(1m).
rpcgroup(1m)