diff options
author | ru <ru@FreeBSD.org> | 2002-12-19 09:40:28 +0000 |
---|---|---|
committer | ru <ru@FreeBSD.org> | 2002-12-19 09:40:28 +0000 |
commit | 51fe7c1a888747c57136cc34ec54a93a0487b745 (patch) | |
tree | f0781cb8e5be3a35234a6d0c123d6ae11ba70e40 /lib/libc/rpc | |
parent | 3424a53ebeadf7ab320c37cf93702953cee94efe (diff) | |
download | FreeBSD-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.3 | 13 | ||||
-rw-r--r-- | lib/libc/rpc/getnetconfig.3 | 4 | ||||
-rw-r--r-- | lib/libc/rpc/rpc.3 | 4 | ||||
-rw-r--r-- | lib/libc/rpc/rpc_clnt_auth.3 | 5 | ||||
-rw-r--r-- | lib/libc/rpc/rpc_clnt_calls.3 | 21 | ||||
-rw-r--r-- | lib/libc/rpc/rpc_clnt_create.3 | 43 | ||||
-rw-r--r-- | lib/libc/rpc/rpc_secure.3 | 8 | ||||
-rw-r--r-- | lib/libc/rpc/rpc_soc.3 | 81 | ||||
-rw-r--r-- | lib/libc/rpc/rpc_svc_calls.3 | 10 | ||||
-rw-r--r-- | lib/libc/rpc/rpc_svc_create.3 | 24 | ||||
-rw-r--r-- | lib/libc/rpc/rpc_svc_err.3 | 6 | ||||
-rw-r--r-- | lib/libc/rpc/rpc_svc_reg.3 | 6 | ||||
-rw-r--r-- | lib/libc/rpc/rpcbind.3 | 7 | ||||
-rw-r--r-- | lib/libc/rpc/rtime.3 | 2 |
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 |