.\" This page was taken from the 4.4BSD-Lite CDROM (BSD license)
.\"
+.\" %%%LICENSE_START(BSD_ONELINE_CDROM)
+.\" This page was taken from the 4.4BSD-Lite CDROM (BSD license)
+.\" %%%LICENSE_END
+.\"
.\" @(#)rpc.3n 2.4 88/08/08 4.0 RPCSRC; from 1.19 88/06/24 SMI
.\"
.\" 2007-12-30, mtk, Convert function prototypes to modern C syntax
.TH RPC 3 2008-07-17 "" "Linux Programmer's Manual"
.SH NAME
rpc \- library routines for remote procedure calls
-.SH "SYNOPSIS AND DESCRIPTION"
+.SH SYNOPSIS AND 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.
typedef int \fIbool_t\fP;
-typedef bool_t (*\fIxdrproc_t\fP) (XDR *, void *,...);
+typedef bool_t (*\fIxdrproc_t\fP) (XDR *, void *, ...);
typedef bool_t (*\fIresultproc_t\fP) (caddr_t resp,
struct sockaddr_in *raddr);
.BR clnt_control ().
.IP
Warning: Using UDP has its shortcomings.
-Since UDP-based RPC messages can only hold up to 8 Kbytes of encoded data,
+Since UDP-based RPC messages can hold only up to 8 Kbytes of encoded data,
this transport cannot be used for procedures that take
large arguments or return huge results.
.LP
The total time for the call to time out is specified by
.BR clnt_call ().
.IP
-Warning: since UDP-based RPC messages can only hold up to 8 Kbytes
+Warning: since UDP-based RPC messages can hold only up to 8 Kbytes
of encoded data, this transport cannot be used for procedures
that take large arguments or return huge results.
.LP
read file descriptor bit mask; it is suitable as a parameter to the
.BR select (2)
system call.
-This is only of interest if a service implementor does not call
+This is of interest only if a service implementor does not call
.BR svc_run (),
but rather does his own asynchronous event processing.
This variable is read-only (do not pass its address to
.BI "void svc_getreqset(fd_set *" rdfds );
.fi
.IP
-This routine is only of interest if a service implementor does not call
+This routine is of interest only if a service implementor does not call
.BR svc_run (),
but instead implements custom asynchronous event processing.
It is called when the
.BI "bool_t xdr_authunix_parms(XDR *" xdrs ", struct authunix_parms *" aupp );
.fi
.IP
-Used for describing Unix credentials.
+Used for describing UNIX credentials.
This routine is useful for users
who wish to generate these credentials without using the RPC
authentication package.
This routine modifies the global variable
.IR svc_fds .
Service implementors usually do not need this routine.
-.SH "SEE ALSO"
+.SH SEE ALSO
.\" We don't have an rpc_secure.3 page in the set at the moment -- MTK, 19 Sep 05
.\" .BR rpc_secure (3),
.BR xdr (3)
-.br
+
The following manuals:
.RS
Remote Procedure Calls: Protocol Specification
rpcgen Programming Guide
.br
.RE
+
.IR "RPC: Remote Procedure Call Protocol Specification" ,
RFC\ 1050, Sun Microsystems, Inc.,
USC-ISI.