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

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


 add mapping(1m)          Open Software Foundation           add mapping(1m)

 NAME    [Toc]    [Back]
      add mapping - Adds or replaces server address information in the local
      endpoint map

 SYNOPSIS    [Toc]    [Back]
      rpccp add mapping -b string-binding -i interface-identifier [-a
      [-o object-uuid] [-N]

 OPTIONS    [Toc]    [Back]
      -b        Specifies a string representation of a binding over which
                the server can receive remote procedure calls. At least one
                binding is required.

                The value has the form of an RPC string binding, without an
                object UUID, for example:

                -b ncadg_ip_udp:[5347]

                Note that depending on your system, string binding
                delimiters such as brackets ([ ]) may need to be preceded by
                an escape symbol (\) or placed within quotation marks (' '
                or `` ''). Requirements vary from system to system, and you
                must conform to the usage rules of a system.

      -i        Specifies an interface identifier to register with the local
                endpoint map.  An interface identifier is required.  Only
                one interface can be added (i.e., registered) in a single
                operation.  The interface identifier has the following form:


                The UUID is a hexadecimal string and the version numbers are
                decimal strings, for example:

                -i ec1eeb60-5943-11c9-a309-08002b102989,1.1

                Leading zeros in version numbers are ignored.

      -a        Specifies a character string comment to be applied to each
                cross product element that is added to the local endpoint
                map. The string can be up to 64 characters long, including
                the NULL terminating character.

                The string is used by applications for informational
                purposes only. The RPC runtime does not use this string to
                determine which server instance a client communicates with,

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

 add mapping(1m)          Open Software Foundation           add mapping(1m)

                or for enumerating endpoint map elements.

      -o        Defines an object UUID that further determines the endpoint
                map elements that are removed (optional). Each add mapping
                command accepts up to 32 -o options.

                The UUID is a hexadecimal string, for example:

                -o 3c6b8f60-5945-11c9-a236-08002b102989

      -N        Specifies that existing elements in the local host's
                endpoint map should not be replaced when the new information
                is added.

 DESCRIPTION    [Toc]    [Back]
      The add mapping command adds to, replaces, or adds server address
      information to the local endpoint map.

      Each element in the local endpoint map logically contains the

        +  Interface ID, consisting of an interface UUID and versions (major
           and minor)

        +  Binding information

        +  Object UUID (optional)

        +  Annotation (optional)

      This command should be used without the -N option when only a single
      instance of the server in question runs on the server's host. Do not
      use the -N option if no more than one server instance on the host ever
      offers the same interface UUID, object UUID, and protocol sequence.

      When local endpoint map elements are not replaced, obsolete elements
      accumulate each time a server instance stops running without
      explicitly unregistering its endpoint map information.  Periodically,
      the RPC Daemon (RPCD) will identify these obsolete elements and remove
      them. However, during the interval between these removals, the
      presence of the obsolete elements increases the chance that clients
      will receive endpoints to nonexistent servers.  The clients will then
      waste time trying to communicate with these servers before giving up
      and obtaining another endpoint.

      Allowing RPCD to replace any existing local endpoint map elements (by
      not specifying -N) reduces the chance of this happening.

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

 add mapping(1m)          Open Software Foundation           add mapping(1m)

      For example, suppose an existing element in the local endpoint map
      matches the interface UUID, binding information exclusive of the
      endpoint, and object UUID of an element this routine provides. The
      routine changes the endpoint map according to the elements' interface
      major and minor version numbers.

 NOTE    [Toc]    [Back]
      This command is replaced at Revision 1.1 by the dcecp command and may
      not be provided in future releases of DCE.

 EXAMPLES    [Toc]    [Back]
      The following command operates from the system prompt to add a map
      element to the local endpoint map. The command adds the map element
      that contains the specified interface identifier, server address
      (specified as a string binding), and object UUIDs.

       rpccp add mapping -i ec1eeb60-5943-11c9-a309-08002b102989,1.1 -b ncadg_ip_udp:[5347]  \
         -o 005077d8-8022-1acb-9375-10005a4f533a -o 001bc29a-8041-1acb-b377-10005a4f533a \
         -a 'Calendar version 1.1'

      The previous command adds the following elements:

      interface ID

      string binding

      objects   005077d8-8022-1acb-9375-10005a4f533a

                Calendar version 1.1

      Commands: export(1m), remove mapping(1m), show mapping(1m), show

      Subroutines: rpc_ep_register, rpc_ep_register_no_replace

 Hewlett-Packard Company            - 3 -OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96
[ Back ]
 Similar pages
Name OS Title
dcecp_endpoint HP-UX A dcecp object that manages endpoint information in local RPC endpoint maps
show_cached_server HP-UX Displays address information of a server in the local clerk's cache
show_server HP-UX Displays attribute information about the server running on the local system
ypxfr Tru64 Transfer a Network Information Service (NIS) map from a NIS server to the local host
rpccp_remove_mapping HP-UX Removes specified elements from the local endpoint map
rpccp_show_mapping HP-UX Shows the elements of the either the local or a remote endpoint map
inet_lnaof Tru64 Translate an Internet address integer into its host (local) address component
t_bind Tru64 Bind an address to a transport endpoint
t_bind HP-UX bind an address to a transport endpoint
t_bind IRIX bind an address to a transport endpoint
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service