rpc(3C)

Requires Optional NFS Services Software

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_control() change or retrieve information associated with a client handle.

clnt_create() create RPC client using the transport specified by the caller.

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 explaining why an RPC call failed.

clnt_spcreateerror() returns a pointer to a null-delimited string which tells why the client handle creation failed.

clnt_sperrno() returns a pointer to a null-delimited string which contains a message that corresponds to the error value passed to this function.

clnt_sperror() returns a pointer to a null-delimited string which tells why an 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_fdset() global array with RPC service file descriptor mask that can handle up to NOFILE socket descriptors (NOFILE is defined in header file <sys/parm.h>).

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_getreqset() 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.

svcfd_create() creates an RPC service from an existing socket.

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

EXTERNAL INFLUENCES

International Code Set Support

Single- and multi-byte character codes sets are supported.

AUTHOR

rpc was developed by Sun Microsystems, Inc.

Museum

Related Articles