txrxCall, txrxRegister, txrxDeregister - user level commands to setup RPC processing using portmapper services
txrxCall protocol host procedure ?args?
txrxRegister protocol channel program version
txrxDeregister protocol program version
txrxCall performs an RPC call to host and uses the portmapper services on host to find the service address. txrxCall opens a channel to the server and keeps it open for further RPC requests. Calls for the same program version will use the same open channel. txrxCall returns the result of the remote procedure call. If the remote server is not registered with the portmapper service an error will be returned.
When the protocol description is deleted with txrxDelete the open channels to all remote services are close automatically.
txrxRegister registers with the portmapper on a given host the intention of a server to service RPC's for a given server channel. The program and version arguments specify what service is provided. A protocol description may contain multiple programs and each program may contain multiple versions.
txrxDeregister performs the oposite function of txrxRegister. It contacts the portmapper service running on the local host and removes the information about the program and version from the list of services making it impossible for client programs to contact the service using txrxCall.
Deregistration is performed automatically when a protocol description is deleted. It is the responsibility of the user to close the server channel. Note that on SUN OS the server socket must be closed before deregistration, otherwise the portmapper will refuse to delete the map.
remote procedure call, channel, external data representation, client-server, communication