HELPLIB.HLB  —  DCE  DCE_RPC, rpccp  ARGUMENTS  show_group
 NAME
   show group - 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(s) to retrieve the required
             data.  rpccp 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.  rpccp then
             updates 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.

   Privilege Required

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

 NOTE
   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
        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
             remove group
             remove member
Close Help