*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->HP-UX 11i man pages -> rpccp (1m)              


 rpccp(1m)                Open Software Foundation                 rpccp(1m)

 NAME    [Toc]    [Back]
      rpccp - Starts the RPC control program

 SYNOPSIS    [Toc]    [Back]
      rpccp  [rpccp-command]

 ARGUMENTS    [Toc]    [Back]
                Specifies one of the following control program commands:

                add element
                          Adds an element to a profile in a name service
                          entry; if the specified entry does not exist,
                          creates the entry.

                add entry Adds an entry to the name service database.

                add mapping
                          Adds or replaces server address information in the
                          local endpoint map.

                add member
                          Adds a member to a group in a name service entry;
                          if the specified entry does not exist, creates the

                exit      Leaves the RPC control program.

                export    Exports binding information for an interface
                          identifier, object UUIDs, or both to a server
                          entry; if the specified entry does not exist,
                          creates the entry.

                help      Displays a list of commands or the possible
                          options of a specified command.

                import    Imports binding information and an object UUID
                          from a server entry.

                quit      Leaves the RPC control program.

                remove element
                          Removes selected elements from a profile.

                remove entry
                          Removes an entry from the name service database.

                remove group
                          Removes all group members and the group from the

 Hewlett-Packard Company            - 1 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96

 rpccp(1m)                Open Software Foundation                 rpccp(1m)

                          specified entry.

                remove mapping
                          Removes specified elements from the local endpoint
                          map or from the endpoint map of a specified remote

                remove member
                          Removes a selected member from a group.

                remove profile
                          Removes all profile elements and the profile from
                          the specified entry.

                show entry
                          Shows the NSI attributes of an entry.

                show group
                          Shows the members of a group.

                show mapping
                          Shows the elements of the local endpoint map.

                show profile
                          Shows the elements of a profile.

                show server
                          Shows the binding information, interface
                          identifier, and object UUIDs in a server entry.

                unexport  Removes binding information, interface
                          identifiers, and object UUIDs from a server entry.

 NOTES    [Toc]    [Back]
      This facility is superceded by the DCE control program (dcecp) for OSF
      DCE version 1.1.

      A server entry equates to an NSI binding attribute and, optionally, an
      object attribute; a group equates to an NSI group attribute; and a
      profile equates to an NSI profile attribute.  Typically, each server's
      entries, groups, and profiles reside in distinct name service entries.

 NOTES    [Toc]    [Back]
      With the exception of the rpccp_help subcommand, this command is
      replaced at Revision 1.1 by the dcecp command.  This command may be
      fully replaced by the dcecp command in a future release of DCE, and
      may no longer be supported at that time.

 DESCRIPTION    [Toc]    [Back]

 Hewlett-Packard Company            - 2 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96

 rpccp(1m)                Open Software Foundation                 rpccp(1m)

      The RPC control program (RPCCP) provides a set of commands for
      managing name service use for RPC applications and for managing the
      endpoint map.

      You can use control program commands from within the control program
      or from the system prompt (represented here as a $).

      To use the control program commands from inside the control program,
      Start and enter the control program using the rpccp command alone,
      without any argument. The control program then displays the control
      program prompt (pccp>), as follows:


      You can then enter any control program command, for example:

      pccp> show entry /.:/LandS/anthro/pr_server_node3

      You leave the control program and return to the system prompt using
      the exit or quit command.

      If you enter invalid input, the control program displays the valid

      To use the control program commands from the system prompt, enter the
      rpccp command with an internal command of the control program as the
      first argument.  You can do this either interactively or in a command
      procedure.  For example, you can enter the show entry command as

       rpccp show entry /.:/LandS/anthro/pr_server_node3

    Arguments and Options    [Toc]    [Back]
      Except for the exit and quit commands, rpccp commands have one or more
      options.  Each option is identified by a - (dash) followed by a
      letter; for example, -s. Some options require arguments.

      Commands that access NSI operations also require the name of a name
      service entry as an argument.  The order of arguments and the entryname
 option is arbitrary; for example, the following placements of
      arguments and options are equivalent:

      pccp> add element  /.:/LandS/anthro/mis_node_2  \
       -i ec1eeb60-5943-11c9-a309-08002b102989,1.0

      pccp> add element -i ec1eeb60-5943-11c9-a309-08002b102989,1.0 \

 Hewlett-Packard Company            - 3 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96

 rpccp(1m)                Open Software Foundation                 rpccp(1m)

    Environmental Influences on Command Syntax    [Toc]    [Back]
      There are variations in the action of the control program, depending
      on whether commands are entered from the system prompt or from within
      the control program.  For example, entering the annotation field of
      profile elements from the system prompt allows you to include internal
      spaces in an annotation.

           Function          At System Prompt   Inside Control Program
          |Strings within  | Supported        | Not required           |
          |quotation marks |                  |                        |
          |                |                  |                        |
          |Wildcard        | Supported        | Unsupported            |
          |substitution    |                  |                        |

      Note:  Some UNIX systems require that you place an escape
             symbol (\) before string binding delimiters such as
             brackets ([ ]) or that you place the delimiters within
             quotation marks (' ' or '' '') at the system prompt.

      The following table describes the scope of the RPC control program

                          Scope          Command

                          All entries    add entry
                                         remove entry
                                         show entry

                          Server entry   export
                                         show server

                          Group          add member
                                         remove group
                                         remove member
                                         show group

                          Profile        add element
                                         remove element
                                         remove profile
                                         show profile

                          Endpoint map   add mapping
                                         remove mapping
                                         show mapping

 Hewlett-Packard Company            - 4 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96

 rpccp(1m)                Open Software Foundation                 rpccp(1m)

                         |             |                |
                         |             |                |
    Environment Variables|             |                |
      The control program|supports environment variables.  Using environment
      variables facilitates interactive|use of the control program.
                         |             |                |
      To distinguish environment variables, rpccp*(1m) reference pages
      follow the convention of using all uppercase letters for examples of
      environment variables.  Note that|UNIX environment|variables are case
      sensitive.         |             |                |
                         |             |                |
                         |             |                |
      User-defined environment variables                |
           You can set an|environment variable to represent values to rpccp.
           Using an environment variable is helpful for specifying a long
           string such as|the following:                |
                         |             |                |
                         |             |                |
             +  A string representation|of binding information (binding
                string)  |             |                |
                         |             |                |
             +  A string representation|of an object or interface UUID
                (string UUID)          |                |
                         |             |                |
             +  An interface identifier|(the interface UUID and version

             +  The name of a name service entry

                For example, in the following example, the environment
                variable JANE_CAL represents an object UUID; the target name
                service entry, /.:/LandS/anthro/Cal_host_2, is in the local

                 export JANE_CAL

                pccp> export  -o JANE_CAL /.:/LandS/anthro/Cal_host_2

      DCE RPC environment variables    [Toc]    [Back]

           NLSPATH   The environment variable NLSPATH must point to the
                     location of dcerpc.cat and dcedcs.cat. Otherwise, any
                     run-time status codes returned by the control program
                     will be hexadecimal, rather than textual.  form. The
                     value of this variable must include both the pathname
                     of the directory where the .cat files reside and the
                     string %N.

 Hewlett-Packard Company            - 5 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96

 rpccp(1m)                Open Software Foundation                 rpccp(1m)

           RPC_DEFAULT_ENTRY_SYNTAX    [Toc]    [Back]
                     The dce name syntax is the only syntax currently
                     supported by the DCE Cell Directory Service (CDS).
                     However, the Name Service Interface (NSI) is
                     independent of any specific name service and, in the
                     future, may support name services that use other name
                     syntaxes.  When alternative name syntaxes are
                     supported, you can override the standard default with a
                     process-specific default by setting the
                     RPC_DEFAULT_ENTRY_SYNTAX environment variable. When
                     this variable is set for a process, the control program
                     uses it to find out the default syntax for the process.
                     You can override this default in any NSI command of the
                     control program by using the -s option to specify an
                     alternative entry syntax.  Setting
                     RPC_DEFAULT_ENTRY_SYNTAX requires specifying the
                     integer 3 to indicate the dce syntax. To set
                     RPC_DEFAULT_ENTRY_SYNTAX, use the name=value command to
                     define an environment variable.  The following command
                     specifies dce as the default name syntax in a login
                     command file:

                     # .login command file
                     # setting dce as default name syntax,

           RPC_DEFAULT_ENTRY    [Toc]    [Back]
                     For the import command, you can use this environment
                     variable to indicate the entry where the search
                     operation starts.  Usually, the starting entry is a

    The Name Service Interface    [Toc]    [Back]
      The remainder of this description contains information to help you use
      commands that call the name service interface to access name service
      entries (NSI commands).

      The DCE RPC name service interface (NSI) is independent of any
      particular name service. CDS, however, is the only name service
      available for DCE RPC Version 1.0 applications.  For more details on
      the name service interface, see the .  For a description of the DCE
      Cell Directory Service, see the .

    Name Service Entries    [Toc]    [Back]
      To store information about RPC servers, interfaces, and objects, the
      NSI defines the following name service entries:

 Hewlett-Packard Company            - 6 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96

 rpccp(1m)                Open Software Foundation                 rpccp(1m)

      server entry
                Stores binding information, interface identifiers, and
                object UUIDs for an RPC server

      group     Corresponds to one or more RPC servers that offer a common
                RPC interface, type of RPC object, or both

      profile   Defines search paths for looking in a name service database
                for a server that offers a particular RPC interface and

      Note that when the NSI is used with the Cell Directory Service, the
      name service entries are CDS object entries

    Structure of Entry Names    [Toc]    [Back]
      Each entry in a name service database is identified by a unique global
      name made up of a cell name and a cell-relative name.

      A  cell is a group of users, systems, and resources that share common
      DCE services. A cell configuration includes at least one cell
      directory server, one security server, and one time server.  A cell's
      size can range from one system to thousands of systems. For
      information on cells, see the CDS portion of this book.

      The following is an example of a global name:


      The parts of a global name are as follows:

      Cell name (using X.500 name syntax)
                For example:


                The symbol /... begins a cell name.  The letters before the
                equal signs (=) are abbreviations for country (C),
                organization (O), and organization unit (OU).

                For entries in the local cell, the cell name can be
                represented by a /.: prefix, in place of the actual cell
                name; for example,


                For NSI operations on entries in the local cell you can omit
                the cell name.

 Hewlett-Packard Company            - 7 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96

 rpccp(1m)                Open Software Foundation                 rpccp(1m)

      Cell-relative name    [Toc]    [Back]

                Each name service entry requires a cell-relative name, which
                contains a directory pathname and a leaf name.

                directory pathname
                          Follows the cell name and indicates the
                          hierarchical relationship of the entry to the cell

                          The directory pathname is the middle portion of
                          the global name.  The cell name is to the left of
                          the directory pathname, and the leaf name is to
                          the right, as follows:

                          cell-name + directory-pathname + leaf-name

                          The directory pathname contains the names of any
                          subdirectories in the path; each subdirectory name
                          begins with a slash (/), as follows:


                          Directory paths are created by name service
                          administrators. If an appropriate directory path
                          does not exist, ask your name service
                          administrator to extend an existing path or create
                          a new path. In a directory path, the name of a
                          subdirectory should reflect its relationship to
                          its parent directory (the directory that contains
                          the subdirectory).

                leaf name Identifies the specific entry.  The leaf name is
                          the right-hand part of global name beginning with
                          the rightmost slash.

                In the following example,  /.../C=US/O=uw/OU=MadCity is the
                cell name,  /LandS/anthro is the directory pathname, and
                /Cal_host_4 is the leaf name.


                If a name service entry is located at the cell root, the
                leaf name directly follows the cell name; for example,

 Hewlett-Packard Company            - 8 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96

 rpccp(1m)                Open Software Foundation                 rpccp(1m)

      Note that when the NSI is used with CDS, the cell-relative name is a
      CDS name.

    Guidelines for Constructing Names of Name Service Entries    [Toc]    [Back]
      A global name includes both a cell name and a cell-relative name
      composed of a directory pathname and a leaf name. The cell name is
      assigned to a cell root at its creation. When you specify only a
      cell-relative name to an NSI command, the NSI automatically expands
      the name into a global name by inserting the local cell name. When
      returning the name of a name service entry, a group member, or member
      in a profile element, NSI operations return global names.

      The directory pathname and leaf name uniquely identify a name service
      entry. The leaf name should somehow describe the entry; for example,
      by identifying its owner or its contents. The remainder of this
      section contains guidelines for choosing leaf names.  Note that
      directory pathnames and leaf names are case sensitive.

      Naming a Server Entry    [Toc]    [Back]

                For a server entry that advertises an RPC interface or
                service offered by a server, the leaf name must distinguish
                the entry from the equivalent entries of other servers. When
                a single server instance runs on a host, you can ensure a
                unique name by combining the name of the service, interface
                (from the interface definition), or the system name for the
                server's host system.

                For example, consider two servers, one offering a calendar
                service on host JULES and one, on host VERNE.

                The server on JULES uses the following leaf name:


                The server on VERNE uses the following leaf name:


                For servers that perform tasks on or for a specific system,
                an alternative approach is to create server entries in a
                system-specific host directory within the name service
                database.  Each host directory takes the name of the host to
                which it corresponds.  Because the directory name identifies
                the system, the leaf name of the server entry name need not
                include the host name, for example:


 Hewlett-Packard Company            - 9 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96

 rpccp(1m)                Open Software Foundation                 rpccp(1m)

                To construct names for the server entries used by
                distinctive server instances on a single host, you can
                construct unique server entry names by combining the
                following information: the name of the server's service,
                interface, or object; the system name of the server's host
                system, and a reusable instance identifier, such as an

                For example, the following leaf names distinguish two
                instances of a calendar service on the JULES system:



                Avoid automatically generating entry names for the server
                entries of server instances, for example, by using unique
                data such as a time stamp (calendar_verne_15OCT91_21:25:32)
                or a process identifier (calendar_jules_208004D6). When a
                server incorporates such unique data into its server entry
                names, each server instance creates a separate server entry,
                causing many server entries.  When a server instance stops
                running, it leaves an obsolete server entry that is not
                reused. The creation of a new entry whenever a server
                instance starts may impair performance.

                A server can use multiple server entries to advertise
                different combinations of interfaces and objects. For
                example, a server can create a separate server entry for a
                specific object (and the associated interfaces).  The name
                of such a server entry should correspond to a well-known
                name for the object. For example, consider a server that
                offers a horticulture bulletin board known to users as
                horticulture_bb.  The server exports the horticulture_bb
                object, binding information, and  the associated bulletinboard
 interface to a server entry whose leaf name identifies
                the object, as follows:


                Note that an RPC server that uses RPC authentication can
                choose identical names for its principal name and its server
                entry. Use of identical names permits a client that calls
                the rpc_binding_set_auth_info routine to automatically
                determine a server's principal name (the client will assume
                the principal name to be the same as the server's entry
                name). If a server uses different principal and server entry
                names, users must explicitly supply the principal name. For
                an explanation of principal names, see the DCE Security
                Service part of the DCE Application Development Guide.

 Hewlett-Packard Company           - 10 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96

 rpccp(1m)                Open Software Foundation                 rpccp(1m)

      Naming a Group    [Toc]    [Back]

                The leaf name of a group should indicate the interface,
                service, or object that determines membership in the group.
                For example, for a group whose members are selected because
                they advertise an interface named Statistics, the following
                is an effective leaf name:

                Statistics    [Toc]    [Back]

                For a group whose members advertise laser-printer print
                queues as objects, the following is an effective leaf name:


      Naming a Profile    [Toc]    [Back]

                The leaf name of a profile should indicate the profile
                users; for example, for a profile that serves the members of
                an accounting department, the following is an effective leaf


    Privilege Required    [Toc]    [Back]
      To use the NSI commands to access entries in a CDS database, you need
      access control list (ACL) permissions.  Depending on the NSI
      operation, you need ACL permissions to the parent directory or the CDS
      object entry (the name service entry) or both.  The ACL permissions
      are as follows:

        +  To create an entry, you need insert permission to the parent

        +  To read an entry, you need read permission to the CDS object

        +  To write to an entry, you need write permission to the CDS object

        +  To delete an entry, you need delete permission either to the CDS
           object entry or to the parent directory.

      Note that write permission does not imply read permission.

      ACL permissions for the NSI commands of the control program are
      described in the reference pages.

 Hewlett-Packard Company           - 11 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96

 rpccp(1m)                Open Software Foundation                 rpccp(1m)

 EXAMPLES    [Toc]    [Back]
      The following command starts the RPC control program:


      The following command at the system prompt removes the entry

       rpccp remove entry  \

      Commands: dcecp, add element(1m), add entry(1m), add mapping(1m), add
      member(1m), export(1m), import(1m), remove element(1m), remove
      entry(1m), remove group(1m), remove mapping(1m), remove member(1m),
      remove profile(1m), show entry(1m), show group(1m), show mapping(1m),
      show profile(1m), show server(1m), unexport(1m)

 Hewlett-Packard Company           - 12 -OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96
[ Back ]
 Similar pages
Name OS Title
cdscp HP-UX Starts the CDS control program
setmemwindow HP-UX changes the window id of a running program or starts a program in a particular memory window
pppctl FreeBSD PPP control program
camcontrol FreeBSD CAM control program
pppctl OpenBSD PPP control program
dtscp HP-UX DTS control program
timedc IRIX timed control program
iopctl OpenBSD a program to control IOP devices
stacker IRIX robotics control program
ndc FreeBSD name daemon control program
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service