rpc(3)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:
Calls a remote procedure on a remote system. Broadcasts a call message
to all locally connected broadcast nets. Calls the remote procedure
that is associated with a specified client handle. Creates a generic
RPC client. Change or retrieves various information about a client
object. Destroys the client's RPC handle. Frees any data allocated by
the RPC/XDR system. Copies the error structure out of the client han‐
dle. Prints a message to standard error indicating why a client RPC
handle could not be created. Prints a message to standard error corre‐
sponding to a condition. Prints a message to standard error indicating
why an RPC call failed. Returns a string indicating why a client RPC
handle could not be created. Returns a pointer to a string that indi‐
cates why an RPC call failed. Returns a string that indicates why an
RPC call failed. Creates a toy RPC client for a remote program. Cre‐
ates an RPC client that uses the TCP/IP transport. Creates an RPC
client that uses the UDP/IP transport. Destroys the RPC service trans‐
port handle. Specifies the RPC service side's read file descriptor bit
mask. Frees any data allocated by the RPC/XDR system. Decodes the
arguments of an RPC request. Gets the network address of the caller.
Services an RPC request. Services an RPC request. Maps a program with
a service dispatch procedure. Waits and services RPC requests. Send
the results of a remote procedure call. Removes the mapping of program
to service dispatch procedures. Processes incorrect authentication
errors. Processes parameter decoding errors. Processes procedure num‐
ber errors. Processes program registration errors. Processes program
registration errors. Processes system errors. Processes insufficient
authentication errors. Creates an RPC service on top of any open
descriptor. Creates a toy RPC service transport. Creates a TCP/IP-
based RPC service transport. Creates a UDP/IP-based RPC service trans‐
port. Encodes RPC reply messages. Describes UNIX credentials.
Describes RPC call header messages. Describes RPC call messages.
Describes RPC authentication information messages. Describes RPC reply
messages. Describes RPC reply messages. Destroys authentication
information. Creates and returns an RPC authentication handle. Cre‐
ates and returns an ONC RPC authentication handle that contains authen‐
tication information. Creates and returns an ONC RPC authentication
handle that contains default authentication information. Retrieves the
machine's IP address. Retrieves the network name of the caller. Con‐
verts from a domain-specific host name to an operating-system indepen‐
dent network name. Converts from an operating-system independent net‐
work name to a domain-specific host name. Converts from an operating-
system independent network name to a domain-specific user ID. Returns
a list of the current RPC program-to-port mappings on the host located
at a specified IP address. Returns the port number on which waits a
service that supports a specified program number and transport proto‐
col. Instructs portmap on a remote host to make an RPC call. Maps a
program to a port. Destroys the mapping of a program to a port. Reg‐
isters a procedure with the RPC service package. Specifies an error
value that is set by an RPC client creation routine. Converts from a
domain-specific user name to an operating-system independent network
name. Register transport handle with service. Unregister transport
handle with service.
SEE ALSOrpc_clnt(3), rpc_misc(3), rpc_svc(3), rpc_xdr(3), xdr(3)
Remote Procedure Calls: Protocol Specification -- RFC 1050
rpc(3)