rpc_intro(1m) [hpux man page]
rpc_intro(1m) rpc_intro(1m) NAME
rpc_intro - Introduction to DCE RPC daemon and RPC control program commands DESCRIPTION
DCE RPC provides two administrative facilities, the RPC daemon and the RPC control program. These facilities are superceded by the DCE Host daemon (dced) and the DCE control program (dcecp) for OSF DCE version 1.1. The RPC daemon is a process that provides the Endpoint Map Service, which maintains the local endpoint map for local RPC servers and looks up endpoints for RPC clients. An endpoint is the address of a specific instance of a server executing in a particular address space on a given system (a server instance). Each endpoint can be used on a system by only one server at a time. An endpoint map is a database where servers register their binding information, including endpoints, for each of their RPC interfaces and the associated RPC objects. Each combination of binding information, interface identifier, and object UUID uses a distinct element in the local endoint map. The rpcd command starts the RPC daemon. The control program provides a set of commands for accessing the operations of the RPC name ser- vice interface (NSI). For managing endpoint maps, the control program supports showing endpoint map elements and removing any set of map elements from the local endpoint map or from any remote endpoint map. The rpccp command starts the RPC control program (RPCCP). EXIT VALUES
The RPC control program reports DCE error messages on the command line. If the command executes successfully, the internal value returned is 0 (zero); otherwise, the value is -1 (negative one). RELATED INFORMATION
Commands: dced, dcecp, rpcd(1m), rpccp(1m) Books: , , rpc_intro(1m)
Check Out this Related Man Page
show mapping(1m) show mapping(1m) NAME
show mapping - Shows the elements of the either the local or a remote endpoint map SYNOPSIS
rpccp show mapping [host-address] [-i if-id [-v versions]] [-o object-uuid [ -o object-uuid...]] OPTIONS
Defines an interface identifier to be shown (optional). Only one interface can be shown in a single operation. If specified, only ele- ments containing this interface identifier are shown. The -i option can be qualified by the -v option. The value has the following form: interface-uuid,major-version.minor-version 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. Indicates how a specified interface version is used (optional). If it is used without the -i option, the -v option is ignored. The possible combinations of versions for the -v option and their actions are described in the fol- lowing table. --------------------------------------------------- +-----------+-------------------------------------+ |Versions | Action | +-----------+-------------------------------------+ |all | The interface version is ignored. | |exact | Both the major and minor versions | | | must match the specified versions. | |compatible | The major version must match the | | | specified version, and the minor | | | version must be greater than or | | | equal to the specified version. | |major_only | The major version must match the | | | specified version; the minor ver- | | | sion is ignored. | |upto | The major version must be less than | | | or equal to that specified. If the | | | major versions are equal, the minor | | | version must be less than or equal | | | to that specified. | +-----------+-------------------------------------+ +-----------+-------------------------------------+ If the -v option is absent, the command shows compatible version numbers. Defines an object to be shown (optional). Each show mapping command accepts up to 32 -o options. The UUID is a hexadecimal string, for example: -o 3c6b8f60-5945-11c9-a236-08002b102989 ARGUMENTS
The host-address argument is a string binding that indicates where to find the target endpoint map. When accessing the local endpoint map, you can specify which protocol sequence to use (optional); for example, ncadg_ip_udp: When accessing a remote endpoint map, you must spec- ify both a protocol sequence and a network address for the remote system (required); for example, ncadg_ip_udp:16.20.16.44 An endpoint is unnecessary in local or remote host addresses, and the remove mapping command ignores any endpoint specified as part of a host address. DESCRIPTION
The show mapping command shows elements of an endpoint map. Each element corresponds to an object UUID, interface identifier, annotation, and binding information. The binding information contains an RPC protocol sequence, a network address, and an endpoint within square brack- ets (rpc- prot-seq:network-addr[endpoint]). The endpoint map can be either the local endpoint map or the endpoint map of a specified remote host. If entered without a remote host address, the command accesses the local endpoint map. For the local endpoint map, a show mapping command without any options displays all the map elements. For a remote endpoint map, map elements are accessible only for protocol sequences that are supported on both your system and the remote system. The options list a selected subset of map elements. The - i option selects a specific interface, and the -v option qualifies the -i option. The -o object selects a specific object. You can use from 0 to 32 -o options per command. The options work together to specify the subset of elements for the target protocol sequence(s). NOTES
Note that to ensure that you can remotely display all map elements from every remote endpoint map, run the RPC control program on a system that supports all of the protocol sequences available in your network environment. 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 commands start the control program and show the map elements in the local endpoint map that contain the specified interface identifier: $ rpccp rpccp> show mapping -i ec1eeb60-5943-11c9-a309-08002b102989,1.1 The following rpccp show mapping command operates from the system prompt. The command accesses the endpoint map of the remote host speci- fied by the host address (ncadg_ip_udp:16.20.16.44) and displays the one map element that contains both the specified interface identifier and the specified object UUID: $ rpccp show mapping > -i ec1eeb60-5943-11c9-a309-08002b102989,1.1 > -o 30dbeea0-fb6c-11c9-8eea-08002b0f4528 > ncadg_ip_udp:16.20.16.44 RELATED INFORMATION
Commands: remove mapping(1m), show server(1m) show mapping(1m)