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

gettransient() get a program number in the transient range

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_createerr global 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

AUTHOR

Sun Microsystems, Inc. 

SEE ALSO

Programming and Protocols for NFS Services.

INTERNATIONAL SUPPORT

8-bit data, 16-bit data, messages

Hewlett-Packard Company  —  May 11, 2021