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 receipt 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 UNIX permissions
authunix_create_default()return default UNIX 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 corresponding to condition given
clnt_perror()print message to stderr about why RPC call failed
clntraw_create()create toy RPC client for simulation
clnttcp_create()create RPC client using TCP transport
clntudp_create()create RPC client using UDP transport
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 service package
rpc_createerrglobal variable indicating reason why client creation failed
svc_destroy()destroy RPC service transport handle
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 sockets have been serviced
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 procedure call
svc_unregister()remove mapping of [prognum,versnum] to dispatch routines
svcerr_auth()called when refusing service because of authentication error
svcerr_decode()called when service cannot decode its parameters
svcerr_noproc()called when service hasn’t implemented the desired procedure
svcerr_noprog()called when program is not registered with RPC package
svcerr_progvers()called when version is not registered with RPC package
svcerr_systemerr()called when service detects system error
svcerr_weakauth()called when refusing service because of insufficient authentication
svcraw_create()creates a toy RPC service transport 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 UNIX credentials without using RPC package
xdr_callhdr()generates RPC-style headers without using RPC package
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

Remote Procedure Call Programming Guide, in the NFS Technical Reference.

Revision 5 June 1986  —  5 June 1986