rpc(3N) rpc(3N)NAME rpc - library routines for remote procedure calls DESCRIPTION These routines allow C programs to make procedure calls on other machines across the network. First, the client calls a procedure to send a data packet to the server. Upon re- ceipt of the packet, the server calls a dispatch routine to perform the requested service, and then sends back a reply. Finally, the procedure call returns to the client. FUNCTIONS auth_destroy() destroy authentication information handle authnone_create() return RPC authentication handle with no checking authunix_create() return RPC authentication handle with A/UX permissions authunix_create_default() return default A/UX authentication handle callrpc() call remote procedure, given [prognum,versnum,procnum] clnt_broadcast() broadcast remote procedure call everywhere clnt_call() call remote procedure associated with client handle clnt_destroy() destroy client's RPC handle clnt_freeres() free data allocated by RPC/XDR system when decoding results clnt_geterr() copy error information from client handle to error structure clnt_pcreateerror() print message to stderr about why client handle creation failed clnt_perrno() print message to stderr correspon- ing to condition given clnt_perror() print message to stderr about why RPC call failed clnt_sperrno() print message to a string corresponding to condition given April, 1990 1
rpc(3N) rpc(3N)clnt_sperror() print message to a string clntraw_create() create toy RPC client for simula- tion clnttcp_create() create RPC client using TCP tran- sport clntudp_create() create RPC client using UDP tran- sport get_myaddress() get the machine's IP address pmap_getmaps() return list of RPC program-to-port mappings pmap_getport() return port number on which waits supporting service pmap_rmtcall() instructs portmapper to make an RPC call pmap_set() establish mapping between [prognum,versnum,procnum] and port pmap_unset() destroy mapping between [prognum,versnum,procnum] and port registerrpc() register procedure with RPC ser- vice package rpc_createerr global variable indicating reason why client creation failed svc_destroy() destroy RPC service transport han- dle svc_fds global variable with RPC service file descriptor mask svc_freeargs() free data allocated by RPC/XDR system when decoding arguments svc_getargs() decodes the arguments of an RPC request svc_getcaller() get the network address of the caller of a procedure svc_getreq() returns when all associated sock- ets have been serviced 2 April, 1990
rpc(3N) rpc(3N)svc_register() associates prognum and versnum with service dispatch procedure svc_run() wait for RPC requests to arrive and call appropriate service svc_sendreply() send back results of a remote pro- cedure call svc_unregister() remove mapping of [prognum,versnum] to dispatch rou- tines svcerr_auth() called when refusing service be- cause of authentication error svcerr_decode() called when service cannot decode its parameters svcerr_noproc() called when service hasn't imple- mented the desired procedure svcerr_noprog() called when program is not re- gistered with RPC package svcerr_progvers() called when version is not re- gistered with RPC package svcerr_systemerr() called when service detects system error svcerr_weakauth() called when refusing service be- cause of insufficient authentica- tion svcraw_create() creates a toy RPC service tran- sport for testing svctcp_create() creates an RPC service based on TCP transport svcudp_create() creates an RPC service based on UDP transport xdr_accepted_reply() generates RPC-style replies without using RPC package xdr_authunix_parms() generates A/UX credentials without using RPC package xdr_callhdr() generates RPC-style headers without using RPC package April, 1990 3
rpc(3N) rpc(3N)xdr_callmsg() generates RPC-style messages without using RPC package xdr_opaque_auth() describes RPC messages, externally xdr_pmap() describes parameters for portmap procedures, externally xdr_pmaplist() describes a list of port mappings, externally xdr_rejected_reply() generates RPC-style rejections without using RPC package xdr_replymsg() generates RPC-style replies without using RPC package xprt_register() registers RPC service transport with RPC package xprt_unregister() unregisters RPC service transport from RPC package SEE ALSO A/UX Network Applications Programming. 4 April, 1990