Index for Section 3

Alphabetical listing for R

Bottom of page

rpc(3)
NAME
  rpc, rpc_functions - library routines for ONC 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.

  The RPC subroutines and macros are grouped in the following categories:

  Client RPC routines (described in  rpc_clnt(3))

	  callrpc
	      Calls a remote procedure on a remote system.

	  clnt_broadcast
	      Broadcasts a call message to all locally connected broadcast
	      nets.

	  clnt_call
	      Calls the remote procedure that is associated with a specified
	      client handle.

	  clnt_create
	      Creates a generic RPC client.

	  clnt_control
	      Change or retrieves various information about a client object.

	  clnt_destroy
	      Destroys the client's RPC handle.

	  clnt_freeres
	      Frees any data allocated by the RPC/XDR system.

	  clnt_geterr
	      Copies the error structure out of the client handle.

	  clnt_pcreateerror
	      Prints a message to standard error indicating why a client RPC
	      handle could not be created.

	  clnt_perrno
	      Prints a message to standard error corresponding to a
	      condition.

	  clnt_perror
	      Prints a message to standard error indicating why an RPC call
	      failed.

	  clnt_spcreateerror
	      Returns a string indicating why a client RPC handle could not
	      be created.

	  clnt_sperrno
	      Returns a pointer to a string that indicates why an RPC call
	      failed.

	  clnt_sperror
	      Returns a string that indicates why an RPC call failed.

	  clntraw_create
	      Creates a toy RPC client for a remote program.

	  clnttcp_create
	      Creates an RPC client that uses the TCP/IP transport.

	  clntudp_create
	      Creates an RPC client that uses the UDP/IP transport.

  Server RPC routines (described in  rpc_svc(3))

	  svc_destroy
		  Destroys the RPC service transport handle.

	  svc_fdset
		  Specifies the RPC service side's read file descriptor bit
		  mask.

	  svc_freeargs
		  Frees any data allocated by the RPC/XDR system.

	  svc_getargs
		  Decodes the arguments of an RPC request.

	  svc_getcaller
		  Gets the network address of the caller.

	  svc_getreq
		  Services an RPC request.

	  svc_getreqset
		  Services an RPC request.

	  svc_register
		  Maps a program with a service dispatch procedure.

	  svc_run Waits and services RPC requests.

	  svc_sendreply
		  Send the results of a remote procedure call.

	  svc_unregister
		  Removes the mapping of program to service dispatch
		  procedures.

	  svcerr_auth
		  Processes incorrect authentication errors.

	  svcerr_decode
		  Processes parameter decoding errors.

	  svcerr_noproc
		  Processes procedure number errors.

	  svcerr_noprog
		  Processes program registration errors.

	  svcerr_progvers
		  Processes program registration errors.

	  svcerr_systemerr
		  Processes system errors.

	  svcerr_weakauth
		  Processes insufficient authentication errors.

	  svcfd_create
		  Creates an RPC service on top of any open descriptor.

	  svcraw_create
		  Creates a toy RPC service transport.

	  svctcp_create
		  Creates a TCP/IP-based RPC service transport.

	  svcudp_create
		  Creates a UDP/IP-based RPC service transport.

  RPC XDR routines (described in  rpc_xdr(3))

	  xdr_accepted_reply
		  Encodes RPC reply messages.

	  xdr_authunix_parms
		  Describes UNIX credentials.

	  xdr_callhdr
		  Describes RPC call header messages.

	  xdr_callmsg
		  Describes RPC call messages.

	  xdr_opaque_auth
		  Describes RPC authentication information messages.

	  xdr_rejected_reply
		  Describes RPC reply messages.

	  xdr_replymsg
		  Describes RPC reply messages.

  Miscellaneous RPC routines (described in  rpc_misc(3))

	  auth_destroy
		  Destroys authentication information.

	  authnone_create
		  Creates and returns an RPC authentication handle.

	  authunix_create
		  Creates and returns an ONC RPC authentication handle that
		  contains authentication information.

	  authunix_create_default
		  Creates and returns an ONC RPC authentication handle that
		  contains default authentication information.

	  get_myaddress
		  Retrieves the machine's IP address.

	  getnetname
		  Retrieves the network name of the caller.

	  host2netname
		  Converts from a domain-specific host name to an operating-
		  system independent network name.

	  netname2host
		  Converts from an operating-system independent network name
		  to a domain-specific host name.

	  netname2user
		  Converts from an operating-system independent network name
		  to a domain-specific user ID.

	  pmap_getmaps
		  Returns a list of the current RPC program-to-port mappings
		  on the host located at a specified IP address.

	  pmap_getport
		  Returns the port number on which waits a service that
		  supports a specified program number and transport protocol.

	  pmap_rmtcall
		  Instructs portmap on a remote host to make an RPC call.

	  pmap_set
		  Maps a program to a port.

	  pmap_unset
		  Destroys the mapping of a program to a port.

	  registerrpc
		  Registers a procedure with the RPC service package.

	  rpc_createrr
		  Specifies an error value that is set by an RPC client
		  creation routine.

	  usr2netname
		  Converts from a domain-specific user name to an operating-
		  system independent network name.

	  xprt_register
		  Register transport handle with service.

	  xprt_unregister
		  Unregister transport handle with service.

SEE ALSO
  rpc_clnt(3), rpc_misc(3), rpc_svc(3), rpc_xdr(3), xdr(3)

  Remote Procedure Calls: Protocol Specification -- RFC 1050

Index for Section 3

Alphabetical listing for R

Top of page