RPC(3N) COMMAND REFERENCE 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 sending a data packet to the server. Upon receipt of the packet, the server calls a dispatch routine performing 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 UNIXr permissions authunix_create_default() return default UNIXr 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 Printed 5/12/88 1
RPC(3N) COMMAND REFERENCE RPC(3N) clnt_sperrno() print message to a string corresponding to condition given clnt_sperror() print message to a string 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_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 Printed 5/12/88 2
RPC(3N) COMMAND REFERENCE RPC(3N) 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 UNIXr 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 Printed 5/12/88 3
RPC(3N) COMMAND REFERENCE RPC(3N) 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 RPC Programming Guide in The Network File System, Tektronix part number 070-6628-00. Printed 5/12/88 4
%%index%% na:240,101; de:341,2291;2944,2314;5570,2248;8130,874; se:9004,280; %%index%%000000000100