PreviousNext

show group(8rpc)

Shows the members of a group

Synopsis

rpccp show group group-entry-name
[-m member] [-r [integer]]
[-s syntax] [-u]

Options

-m
Declares the name of a single group member.

-r
Indicates that the show group operation recurses. If any members of a group are also groups, their entries are shown. By default, the -r option causes the show group operation to recurse until all nested groups are expanded; for example, -r shows the members of the specified group and all nested groups.

You can limit recursion to one or more levels by specifying a decimal integer as part of the -r option. For example, -r 1 shows the members of the specified group and, for members that are groups, the command also shows their members; then recursion stops.

Without the -r option, only the members of the specified group are shown.

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

-u
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 to retrieve the required data and 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 and then update the local CDS cache.

Arguments

group-entry-name
Indicates the name of the target group. For an entry in the local cell, you can omit the cell name and specify only the cell-relative name.

Description
The show group command shows the members of a group in the name service database. The entry name of the group is required. Unless it is limited to a specific member (by the -m option), the show group command shows all members. The command shows only the members in the specified group; the -r option enables you to show members of nested groups.

Privileges Required
You need read permission to the CDS object entry (the target group entry). If you use the -r option, you need read permission to any nested groups.

Notes
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 example shows all the members of the group /.:/LandS/anthro/Calendar_group, in the order in which they were added to the group:

rpccp> show group /.:/LandS/anthro/Calendar_group

The following command operates from the system prompt to show a specific member of the group /.:/LandS/dept/Calendar_group:

$ rpccp show group \
> -m /.:/LandS/anthro/Cal_host_2 \
> /.:/LandS/anthro/Calendar_group

Related Information
Commands:

add member(8rpc)

remove group(8rpc)

remove member(8rpc)