summaryrefslogtreecommitdiffstats
path: root/lib/libc/rpc
diff options
context:
space:
mode:
authorru <ru@FreeBSD.org>2002-12-19 09:40:28 +0000
committerru <ru@FreeBSD.org>2002-12-19 09:40:28 +0000
commit51fe7c1a888747c57136cc34ec54a93a0487b745 (patch)
treef0781cb8e5be3a35234a6d0c123d6ae11ba70e40 /lib/libc/rpc
parent3424a53ebeadf7ab320c37cf93702953cee94efe (diff)
downloadFreeBSD-src-51fe7c1a888747c57136cc34ec54a93a0487b745.zip
FreeBSD-src-51fe7c1a888747c57136cc34ec54a93a0487b745.tar.gz
mdoc(7) police: "The .Fa argument.".
Diffstat (limited to 'lib/libc/rpc')
-rw-r--r--lib/libc/rpc/des_crypt.313
-rw-r--r--lib/libc/rpc/getnetconfig.34
-rw-r--r--lib/libc/rpc/rpc.34
-rw-r--r--lib/libc/rpc/rpc_clnt_auth.35
-rw-r--r--lib/libc/rpc/rpc_clnt_calls.321
-rw-r--r--lib/libc/rpc/rpc_clnt_create.343
-rw-r--r--lib/libc/rpc/rpc_secure.38
-rw-r--r--lib/libc/rpc/rpc_soc.381
-rw-r--r--lib/libc/rpc/rpc_svc_calls.310
-rw-r--r--lib/libc/rpc/rpc_svc_create.324
-rw-r--r--lib/libc/rpc/rpc_svc_err.36
-rw-r--r--lib/libc/rpc/rpc_svc_reg.36
-rw-r--r--lib/libc/rpc/rpcbind.37
-rw-r--r--lib/libc/rpc/rtime.32
14 files changed, 160 insertions, 74 deletions
diff --git a/lib/libc/rpc/des_crypt.3 b/lib/libc/rpc/des_crypt.3
index 39b927b..b40a62c 100644
--- a/lib/libc/rpc/des_crypt.3
+++ b/lib/libc/rpc/des_crypt.3
@@ -54,23 +54,23 @@ Also, regularities in the clear text will
not appear in the cipher text.
.Pp
Here is how to use these routines.
-The first parameter,
+The first argument,
.Fa key ,
is the 8-byte encryption key with parity.
To set the key's parity, which for
.Tn DES
is in the low bit of each byte, use
.Fn des_setparity .
-The second parameter,
+The second argument,
.Fa data ,
contains the data to be encrypted or decrypted.
The
-third parameter,
+third argument,
.Fa datalen ,
is the length in bytes of
.Fa data ,
which must be a multiple of 8.
-The fourth parameter,
+The fourth argument,
.Fa mode ,
is formed by
.Em OR Ns 'ing
@@ -95,8 +95,9 @@ in software and the routine returns
.Er DESERR_NOHWDEVICE .
For
.Fn cbc_crypt ,
-the parameter
+the
.Fa ivec
+argument
is the 8-byte initialization
vector for the chaining.
It is updated to the next initialization
@@ -110,7 +111,7 @@ Encryption succeeded, but done in software instead of the requested hardware.
.It Bq Er DESERR_HWERR
An error occurred in the hardware or driver.
.It Bq Er DESERR_BADPARAM
-Bad parameter to routine.
+Bad argument to routine.
.El
.Pp
Given a result status
diff --git a/lib/libc/rpc/getnetconfig.3 b/lib/libc/rpc/getnetconfig.3
index 241b946..e67b9bb 100644
--- a/lib/libc/rpc/getnetconfig.3
+++ b/lib/libc/rpc/getnetconfig.3
@@ -58,7 +58,9 @@ function
returns
.Dv NULL
at the end of the file.
+The
.Fa handlep
+argument
is the handle obtained through
.Fn setnetconfig .
.Pp
@@ -90,7 +92,9 @@ The
.Fn endnetconfig
function
should be called when processing is complete to release resources for reuse.
+The
.Fa handlep
+argument
is the handle obtained through
.Fn setnetconfig .
Programmers should be aware, however, that the last call to
diff --git a/lib/libc/rpc/rpc.3 b/lib/libc/rpc/rpc.3
index 835ae2d..b8688ad 100644
--- a/lib/libc/rpc/rpc.3
+++ b/lib/libc/rpc/rpc.3
@@ -33,7 +33,7 @@ be included.
Some of the high-level
RPC interface routines take a
.Fa nettype
-string as one of the parameters
+string as one of the arguments
(for example,
.Fn clnt_create ,
.Fn svc_create ,
@@ -42,7 +42,9 @@ string as one of the parameters
This string defines a class of transports which can be used
for a particular application.
.Pp
+The
.Fa nettype
+argument
can be one of the following:
.Bl -tag -width datagram_v
.It netpath
diff --git a/lib/libc/rpc/rpc_clnt_auth.3 b/lib/libc/rpc/rpc_clnt_auth.3
index 3a5b5b3..1412c61 100644
--- a/lib/libc/rpc/rpc_clnt_auth.3
+++ b/lib/libc/rpc/rpc_clnt_auth.3
@@ -72,8 +72,9 @@ This is the default authentication used by RPC.
Create and return an RPC authentication handle that contains
.Dv AUTH_SYS
authentication information.
-The parameter
+The
.Fa host
+argument
is the name of the machine on which the information was
created;
.Fa uid
@@ -87,7 +88,7 @@ refer to a counted array of groups to which the user belongs.
.It Fn authsys_create_default
Call
.Fn authsys_create
-with the appropriate parameters.
+with the appropriate arguments.
.El
.Sh SEE ALSO
.Xr rpc 3 ,
diff --git a/lib/libc/rpc/rpc_clnt_calls.3 b/lib/libc/rpc/rpc_clnt_calls.3
index 08435b8..0626d90 100644
--- a/lib/libc/rpc/rpc_clnt_calls.3
+++ b/lib/libc/rpc/rpc_clnt_calls.3
@@ -77,7 +77,7 @@ The remaining routines deal with error handling in the case of errors.
.Pp
Some of the routines take a
.Vt CLIENT
-handle as one of the parameters.
+handle as one of the arguments.
A
.Vt CLIENT
handle can be created by an RPC creation routine such as
@@ -107,16 +107,19 @@ client creation routine such as
.Fn clnt_create
(see
.Xr rpc_clnt_create 3 ) .
-The parameter
+The
.Fa inproc
-is the XDR function used to encode the procedure's parameters, and
+argument
+is the XDR function used to encode the procedure's arguments, and
.Fa outproc
is the XDR function used to decode the procedure's results;
.Fa in
is the address of the procedure's argument(s), and
.Fa out
is the address of where to place the result(s).
+The
.Fa tout
+argument
is the time allowed for results to be returned, which is overridden by
a time-out set explicitly through
.Fn clnt_control ,
@@ -128,8 +131,9 @@ otherwise an appropriate status is returned.
.It Fn clnt_freeres
A function macro that frees any data allocated by the
RPC/XDR system when it decoded the results of an RPC call.
-The parameter
+The
.Fa out
+argument
is the address of the results, and
.Fa outproc
is the XDR routine describing the results.
@@ -257,7 +261,9 @@ except that the initial timeout,
and the maximum timeout,
.Fa waittime
are specified in milliseconds.
+The
.Fa inittime
+argument
is the initial time that
.Fn rpc_broadcast_exp
waits before resending the request.
@@ -272,16 +278,19 @@ and
.Fa procnum
on the machine,
.Fa host .
-The parameter
+The
.Fa inproc
-is used to encode the procedure's parameters, and
+argument
+is used to encode the procedure's arguments, and
.Fa outproc
is used to decode the procedure's results;
.Fa in
is the address of the procedure's argument(s), and
.Fa out
is the address of where to place the result(s).
+The
.Fa nettype
+argument
can be any of the values listed on
.Xr rpc 3 .
This routine returns
diff --git a/lib/libc/rpc/rpc_clnt_create.3 b/lib/libc/rpc/rpc_clnt_create.3
index ca6f92e..c083c6f 100644
--- a/lib/libc/rpc/rpc_clnt_create.3
+++ b/lib/libc/rpc/rpc_clnt_create.3
@@ -73,7 +73,9 @@ to perform the requested service, and then sends a reply.
.It Fn clnt_control
A function macro to change or retrieve various information
about a client object.
+The
.Fa req
+argument
indicates the type of operation, and
.Fa info
is a pointer to the information.
@@ -98,7 +100,7 @@ If you set the timeout value to 0,
.Fn clnt_control
immediately returns an error
.Pq Dv RPC_TIMEDOUT .
-Set the timeout parameter to 0 for batching calls.
+Set the timeout argument to 0 for batching calls.
.Bl -column CLSET_FD_NCLOSE "struct timeval *" "do not close fd on destroy"
.It Dv CLGET_SVC_ADDR Ta "struct netbuf *" Ta "get servers address"
.It Dv CLGET_FD Ta "int *" Ta "get fd from handle"
@@ -132,10 +134,14 @@ Generic client creation routine for program
.Fa prognum
and version
.Fa versnum .
+The
.Fa host
+argument
identifies the name of the remote host where the server
is located.
+The
.Fa nettype
+argument
indicates the class of transport protocol to use.
The transports are tried in left to right order in
.Ev NETPATH
@@ -174,7 +180,7 @@ later (see
.It Fn clnt_create_timed
Generic client creation routine which is similar to
.Fn clnt_create
-but which also has the additional parameter
+but which also has the additional argument
.Fa timeout
that specifies the maximum amount of time allowed for
each transport class tried.
@@ -188,10 +194,14 @@ Generic client creation routine which is similar to
.Fn clnt_create
but which also checks for the
version availability.
+The
.Fa host
+argument
identifies the name of the remote host where the server
is located.
+The
.Fa nettype
+argument
indicates the class transport protocols to be used.
If the routine is successful it returns a client handle created for
the highest version between
@@ -199,7 +209,9 @@ the highest version between
and
.Fa vers_high
that is supported by the server.
+The
.Fa vers_outp
+argument
is set to this value.
That is, after a successful return
.Fa vers_low
@@ -241,7 +253,7 @@ the range supplied is supported by the server.
.It Fn clnt_create_vers_timed
Generic client creation routine which is similar to
.Fn clnt_create_vers
-but which also has the additional parameter
+but which also has the additional argument
.Fa timeout
that specifies the maximum amount of time allowed for
each transport class tried.
@@ -281,8 +293,9 @@ and version
the client uses a connectionless transport.
The remote program is located at address
.Fa svcaddr .
-The parameter
+The
.Fa fildes
+argument
is an open and bound file descriptor.
This routine will resend the call message in intervals of
15 seconds until a response is received or until the
@@ -297,10 +310,11 @@ The retry time out and the total time out periods can
be changed using
.Fn clnt_control .
The user may set the size of the send and receive
-buffers with the parameters
+buffers with the
.Fa sendsz
and
-.Fa recvsz ;
+.Fa recvsz
+arguments;
values of 0 choose suitable defaults.
This routine returns
.Dv NULL
@@ -365,7 +379,9 @@ is
.Dv NULL ,
.Dv RPC_UNKNOWNADDR
error is set.
+The
.Fa fildes
+argument
is a file descriptor which may be open, bound and connected.
If it is
.Dv RPC_ANYFD ,
@@ -385,10 +401,11 @@ error is set.
If
.Fa fildes
is unbound, then it will attempt to bind the descriptor.
-The user may specify the size of the buffers with the parameters
+The user may specify the size of the buffers with the
.Fa sendsz
and
-.Fa recvsz ;
+.Fa recvsz
+arguments;
values of 0 choose suitable defaults.
Depending upon the type of the transport (connection-oriented
or connectionless),
@@ -439,7 +456,7 @@ Like
.Fn clnt_tp_create
except
.Fn clnt_tp_create_timed
-has the extra parameter
+has the extra argument
.Fa timeout
which specifies the maximum time allowed for
for the creation attempt to succeed.
@@ -457,14 +474,16 @@ and version
the client uses a connection-oriented transport.
The remote program is located at address
.Fa svcaddr .
-The parameter
+The
.Fa fildes
+argument
is an open and bound file descriptor.
The user may specify the size of the send and receive buffers
-with the parameters
+with the
.Fa sendsz
and
-.Fa recvsz ;
+.Fa recvsz
+arguments;
values of 0 choose suitable defaults.
This routine returns
.Dv NULL
diff --git a/lib/libc/rpc/rpc_secure.3 b/lib/libc/rpc/rpc_secure.3
index 27b9870..559cb6b 100644
--- a/lib/libc/rpc/rpc_secure.3
+++ b/lib/libc/rpc/rpc_secure.3
@@ -68,7 +68,7 @@ The
function,
used on the client side, returns an authentication handle that
will enable the use of the secure authentication system.
-The first parameter
+The first argument
.Fa name
is the network name, or
.Fa netname ,
@@ -86,7 +86,7 @@ window is more secure than a large one, but choosing
too small of a window will increase the frequency of
resynchronizations because of clock drift.
The third
-parameter
+argument
.Fa addr
is optional. If it is
.Dv NULL ,
@@ -98,11 +98,11 @@ is supplied, however, then the system will use the address
for consulting the remote time service whenever
resynchronization
is required.
-This parameter is usually the
+This argument is usually the
address of the
.Tn RPC
server itself.
-The final parameter
+The final argument
.Fa ckey
is also optional. If it is
.Dv NULL ,
diff --git a/lib/libc/rpc/rpc_soc.3 b/lib/libc/rpc/rpc_soc.3
index 5bf4099..453c45d 100644
--- a/lib/libc/rpc/rpc_soc.3
+++ b/lib/libc/rpc/rpc_soc.3
@@ -156,8 +156,9 @@ Create and return an
authentication handle that contains
.Ux
authentication information.
-The parameter
+The
.Fa host
+argument
is the name of the machine on which the information was
created;
.Fa uid
@@ -179,7 +180,7 @@ It is easy to impersonate a user.
.Pp
Calls
.Fn authunix_create
-with the appropriate parameters.
+with the appropriate arguments.
.Pp
.It Xo
.Ft int
@@ -202,13 +203,14 @@ and
.Fa procnum
on the machine
.Fa host .
-The parameter
+The
.Fa in
+argument
is the address of the procedure's argument(s), and
.Fa out
is the address of where to place the result(s);
.Fa inproc
-is used to encode the procedure's parameters, and
+is used to encode the procedure's arguments, and
.Fa outproc
is used to decode the procedure's results.
This routine returns zero if it succeeds, or the value of
@@ -300,13 +302,14 @@ which is obtained with an
.Tn RPC
client creation routine such as
.Fn clnt_create .
-The parameter
+The
.Fa in
+argument
is the address of the procedure's argument(s), and
.Fa out
is the address of where to place the result(s);
.Fa inproc
-is used to encode the procedure's parameters, and
+is used to encode the procedure's arguments, and
.Fa outproc
is used to decode the procedure's results;
.Fa tout
@@ -341,10 +344,14 @@ Otherwise, the socket remains open.
.Xc
.Pp
Generic client creation routine.
+The
.Fa host
+argument
identifies the name of the remote host where the server
is located.
+The
.Fa proto
+argument
indicates which kind of transport protocol to use.
The
currently supported values for this field are
@@ -373,7 +380,9 @@ large arguments or return huge results.
.Pp
A macro used to change or retrieve various information
about a client object.
+The
.Fa req
+argument
indicates the type of operation, and
.Fa info
is a pointer to the information.
@@ -395,7 +404,7 @@ and their argument types and what they do are:
.Pp
Note: if you set the timeout using
.Fn clnt_control ,
-the timeout parameter passed to
+the timeout argument passed to
.Fn clnt_call
will be ignored in all future calls.
.Bl -column "CLSET_RETRY_TIMEOUT" "struct sockaddr_in"
@@ -431,8 +440,9 @@ A macro that frees any data allocated by the
system when it decoded the results of an
.Tn RPC
call.
-The parameter
+The
.Fa out
+argument
is the address of the results, and
.Fa outproc
is the
@@ -637,8 +647,9 @@ is zero, then it is set to the actual port that the remote
program is listening on (the remote
.Xr rpcbind 8
service is consulted for this information).
-The parameter
+The
.Fa sockp
+argument
is a socket; if it is
.Dv RPC_ANYSOCK ,
then this routine opens a new one and sets
@@ -649,10 +660,11 @@ Since
uses buffered
.Tn I/O ,
the user may specify the size of the send and receive buffers
-with the parameters
+with the
.Fa sendsz
and
-.Fa recvsz ;
+.Fa recvsz
+arguments;
values of zero choose suitable defaults.
This routine returns
.Dv NULL
@@ -689,8 +701,9 @@ is zero, then it is set to actual port that the remote
program is listening on (the remote
.Xr rpcbind 8
service is consulted for this information).
-The parameter
+The
.Fa sockp
+argument
is a socket; if it is
.Dv RPC_ANYSOCK ,
then this routine opens a new one and sets
@@ -744,8 +757,9 @@ is zero, then it is set to actual port that the remote
program is listening on (the remote
.Xr rpcbind 8
service is consulted for this information).
-The parameter
+The
.Fa sockp
+argument
is a socket; if it is
.Dv RPC_ANYSOCK ,
then this routine opens a new one and sets
@@ -791,8 +805,9 @@ the client uses
sockets as a transport.
The local program is located at the
.Fa *raddr .
-The parameter
+The
.Fa sockp
+argument
is a socket; if it is
.Dv RPC_ANYSOCK ,
then this routine opens a new one and sets
@@ -803,10 +818,11 @@ Since
uses buffered
.Tn I/O ,
the user may specify the size of the send and receive buffers
-with the parameters
+with the
.Fa sendsz
and
-.Fa recvsz ;
+.Fa recvsz
+arguments;
values of zero choose suitable defaults.
This routine returns
.Dv NULL
@@ -920,12 +936,13 @@ address
to make an
.Tn RPC
call on your behalf to a procedure on that host.
-The parameter
+The
.Fa portp
+argument
will be modified to the program's port number if the
procedure
succeeds.
-The definitions of other parameters are discussed
+The definitions of other arguments are discussed
in
.Fn callrpc
and
@@ -1002,11 +1019,11 @@ version
and procedure
.Fa procnum ,
.Fa procname
-is called with a pointer to its parameter(s);
+is called with a pointer to its argument(s);
.Fa progname
should return a pointer to its static result(s);
.Fa inproc
-is used to decode the parameters while
+is used to decode the arguments while
.Fa outproc
is used to encode the results.
This routine returns zero if the registration succeeded, \-1
@@ -1055,7 +1072,7 @@ is undefined after calling this routine.
A global variable reflecting the
.Tn RPC
service side's
-read file descriptor bit mask; it is suitable as a template parameter
+read file descriptor bit mask; it is suitable as a template argument
to the
.Xr select 2
system call.
@@ -1112,8 +1129,9 @@ associated with the
.Tn RPC
service transport handle,
.Fa xprt .
-The parameter
+The
.Fa in
+argument
is the address where the arguments will be placed;
.Fa inproc
is the
@@ -1241,8 +1259,9 @@ Called by an
.Tn RPC
service's dispatch routine to send the results of a
remote procedure call.
-The parameter
+The
.Fa xprt
+argument
is the request's associated transport handle;
.Fa outproc
is the
@@ -1283,7 +1302,7 @@ a remote procedure call due to an authentication error.
.Xc
.Pp
Called by a service dispatch routine that cannot successfully
-decode its parameters.
+decode its arguments.
See also
.Fn svc_getargs .
.Pp
@@ -1344,7 +1363,7 @@ it may call this routine.
.Pp
Called by a service dispatch routine that refuses to perform
a remote procedure call due to insufficient
-authentication parameters.
+authentication arguments.
The routine calls
.Fn svcerr_auth xprt AUTH_TOOWEAK .
.Pp
@@ -1427,7 +1446,9 @@ The transport is associated with the socket
which may be
.Dv RPC_ANYSOCK ,
in which case a new socket is created.
+The
.Fa *path
+argument
is a variable-length file system pathname of
at most 104 characters.
This file is
@@ -1457,9 +1478,11 @@ choose suitable defaults.
.Xc
.Pp
Create a service on top of any open descriptor.
+The
.Fa sendsize
and
.Fa recvsize
+arguments
indicate sizes for the send and receive buffers.
If they are
zero, a reasonable default is chosen.
@@ -1477,9 +1500,11 @@ this
descriptor is a connected socket for a stream protocol such
as
.Tn TCP .
+The
.Fa sendsize
and
.Fa recvsize
+arguments
indicate sizes for the send and receive buffers.
If they are
zero, a reasonable default is chosen.
@@ -1600,11 +1625,11 @@ package.
.Fn xdr_pmap "XDR *xdrs" "struct pmap *regs"
.Xc
.Pp
-Used for describing parameters to various
+Used for describing arguments to various
.Xr rpcbind 8
procedures, externally.
This routine is useful for users who wish to generate
-these parameters without using the
+these arguments without using the
.Fn pmap_*
interface.
.Pp
@@ -1615,7 +1640,7 @@ interface.
.Pp
Used for describing a list of port mappings, externally.
This routine is useful for users who wish to generate
-these parameters without using the
+these arguments without using the
.Fn pmap_*
interface.
.Pp
diff --git a/lib/libc/rpc/rpc_svc_calls.3 b/lib/libc/rpc/rpc_svc_calls.3
index 82b82aa..1569d76 100644
--- a/lib/libc/rpc/rpc_svc_calls.3
+++ b/lib/libc/rpc/rpc_svc_calls.3
@@ -111,7 +111,7 @@ has global scope and ends all RPC server activity.
.Vt fd_set Va svc_fdset
.Xc
A global variable reflecting the
-RPC server's read file descriptor bit mask; it is suitable as a parameter
+RPC server's read file descriptor bit mask; it is suitable as a argument
to the
.Xr select 2
system call.
@@ -140,8 +140,9 @@ A function macro that decodes the arguments of an
RPC request associated with the RPC
service transport handle
.Fa xprt .
-The parameter
+The
.Fa in
+argument
is the address where the arguments will be placed;
.Fa inproc
is the XDR
@@ -217,7 +218,7 @@ is an array of
.Vt pollfd
structures derived from
.Va svc_fdset[] .
-It is suitable as a parameter to the
+It is suitable as an argument to the
.Xr poll 2
system call.
The derivation of
@@ -242,8 +243,9 @@ system call to return.
.It Fn svc_sendreply
Called by an RPC service's dispatch routine to send the results of a
remote procedure call.
-The parameter
+The
.Fa xprt
+argument
is the request's associated transport handle;
.Fa outproc
is the XDR
diff --git a/lib/libc/rpc/rpc_svc_create.3 b/lib/libc/rpc/rpc_svc_create.3
index 23c0053..b1efa3a 100644
--- a/lib/libc/rpc/rpc_svc_create.3
+++ b/lib/libc/rpc/rpc_svc_create.3
@@ -57,7 +57,9 @@ data structure.
.It Fn svc_control
A function to change or retrieve various information
about a service object.
+The
.Fa req
+argument
indicates the type of operation and
.Fa info
is a pointer to the information.
@@ -73,7 +75,9 @@ an
.Dv RPC_PROGVERSMISMATCH
error will normally
be returned.
+The
.Fa info
+argument
should be a pointer to an
integer.
Upon successful completion of the
@@ -98,7 +102,9 @@ error will normally
be returned.
It is sometimes desirable to
change this behavior.
+The
.Fa info
+argument
should be a
pointer to an integer which is either 0
(indicating normal server behavior - an
@@ -114,7 +120,9 @@ function
creates server handles for all the transports
belonging to the class
.Fa nettype .
+The
.Fa nettype
+argument
defines a class of transports which can be used
for a particular application.
The transports are tried in left to right order in
@@ -133,7 +141,9 @@ function
registers itself with the rpcbind
service (see
.Xr rpcbind 8 ) .
+The
.Fa dispatch
+function
is called when there is a remote procedure call for the given
.Fa prognum
and
@@ -167,10 +177,12 @@ service handle, and returns a pointer to it.
This routine returns
.Dv NULL
if it fails, and an error message is logged.
+The
.Fa sendsz
and
.Fa recvsz
-are parameters used to specify the size of the buffers.
+arguments
+are arguments used to specify the size of the buffers.
If they are 0, suitable defaults are chosen.
The file descriptor
.Fa fildes
@@ -188,9 +200,11 @@ This routine creates a service on top of an open and bound file descriptor,
and returns the handle to it.
Typically, this descriptor is a connected file descriptor for a
connection-oriented transport.
+The
.Fa sendsz
and
.Fa recvsz
+arguments
indicate sizes for the send and receive buffers.
If they are 0, reasonable defaults are chosen.
This routine returns
@@ -219,7 +233,9 @@ should not be called when the raw interface is being used.
.It Fn svc_tli_create
This routine creates an RPC
server handle, and returns a pointer to it.
+The
.Fa fildes
+argument
is the file descriptor on which the service is listening.
If
.Fa fildes
@@ -257,7 +273,7 @@ In the case where the default address is chosen,
the number of outstanding connect requests is set to 8
for connection-oriented transports.
The user may specify the size of the send and receive buffers
-with the parameters
+with the arguments
.Fa sendsz
and
.Fa recvsz ;
@@ -277,7 +293,9 @@ creates a server handle for the network
specified by
.Fa netconf ,
and registers itself with the rpcbind service.
+The
.Fa dispatch
+function
is called when there is a remote procedure call
for the given
.Fa prognum
@@ -299,7 +317,7 @@ This routine returns
.Dv NULL
if it fails, and an error message is logged.
The users may specify the size of the send and receive buffers
-with the parameters
+with the arguments
.Fa sendsz
and
.Fa recvsz ;
diff --git a/lib/libc/rpc/rpc_svc_err.3 b/lib/libc/rpc/rpc_svc_err.3
index 039501f..6e26b1a 100644
--- a/lib/libc/rpc/rpc_svc_err.3
+++ b/lib/libc/rpc/rpc_svc_err.3
@@ -55,7 +55,7 @@ Called by a service dispatch routine that refuses to perform
a remote procedure call due to an authentication error.
.It Fn svcerr_decode
Called by a service dispatch routine that cannot successfully
-decode the remote parameters
+decode the remote arguments
(see
.Fn svc_getargs
in
@@ -70,7 +70,9 @@ Service implementors usually do not need this routine.
.It Fn svcerr_progvers
Called when the desired version of a program is not registered with the
RPC package.
+The
.Fa low_vers
+argument
is the lowest version number,
and
.Fa high_vers
@@ -84,7 +86,7 @@ it may call this routine.
.It Fn svcerr_weakauth
Called by a service dispatch routine that refuses to perform
a remote procedure call due to insufficient (but correct)
-authentication parameters.
+authentication arguments.
The routine calls
.Fn svcerr_auth "xprt" "AUTH_TOOWEAK" .
.El
diff --git a/lib/libc/rpc/rpc_svc_reg.3 b/lib/libc/rpc/rpc_svc_reg.3
index 2804bf0..95756db 100644
--- a/lib/libc/rpc/rpc_svc_reg.3
+++ b/lib/libc/rpc/rpc_svc_reg.3
@@ -65,11 +65,11 @@ version
and procedure
.Fa procnum ,
.Fa procname
-is called with a pointer to its parameter(s);
+is called with a pointer to its argument(s);
.Fa procname
should return a pointer to its static result(s);
.Fa inproc
-is the XDR function used to decode the parameters while
+is the XDR function used to decode the arguments while
.Fa outproc
is the XDR function used to encode the results.
Procedures are registered on all available transports of the class
@@ -135,7 +135,7 @@ When needed to process an RPC credential of type
.Fa cred_flavor ,
the
.Fa handler
-procedure will be called with two parameters,
+procedure will be called with two arguments,
.Fa "struct svc_req *rqst"
and
.Fa "struct rpc_msg *msg" ,
diff --git a/lib/libc/rpc/rpcbind.3 b/lib/libc/rpc/rpcbind.3
index d9ccaaf..b90d461 100644
--- a/lib/libc/rpc/rpcbind.3
+++ b/lib/libc/rpc/rpcbind.3
@@ -64,7 +64,9 @@ and speaks the transport protocol associated with
.Fa netconf .
The address found is returned in
.Fa svcaddr .
+The
.Fa svcaddr
+argument
should be preallocated.
This routine returns
.Dv TRUE
@@ -111,8 +113,9 @@ call on your behalf to a procedure on that host.
The
.Fn netconfig
structure should correspond to a connectionless transport.
-The parameter
+The
.Fa svcaddr
+argument
will be modified to the server's address if the procedure succeeds
(see
.Fn rpc_call
@@ -120,7 +123,7 @@ and
.Fn clnt_call
in
.Xr rpc_clnt_calls 3
-for the definitions of other parameters).
+for the definitions of other arguments).
.Pp
This procedure should normally be used for a
.Dq ping
diff --git a/lib/libc/rpc/rtime.3 b/lib/libc/rpc/rtime.3
index 5e85e9c..028d2be 100644
--- a/lib/libc/rpc/rtime.3
+++ b/lib/libc/rpc/rtime.3
@@ -34,7 +34,7 @@ Normally, the
protocol is used when consulting the Time Server.
The
.Fa timeout
-parameter specifies how long the
+argument specifies how long the
routine should wait before giving
up when waiting for a reply.
If
OpenPOWER on IntegriCloud