fix some fn/arg decls; strengthen reminder that svc_fdset is readonly

1 files changed, 28 insertions, 22 deletions

diff --git a/lib/libc/rpc/rpc.3 b/lib/libc/rpc/rpc.3
index bbcfd7f4659..b4479726d12 100644
--- a/lib/libc/rpc/rpc.3
+++ b/lib/libc/rpc/rpc.3
@@ -1,5 +1,5 @@
 .\"	@(#)rpc.3n	2.4 88/08/08 4.0 RPCSRC; from 1.19 88/06/24 SMI
-.\"	$OpenBSD: rpc.3,v 1.3 1996/07/20 06:12:36 deraadt Exp $
+.\"	$OpenBSD: rpc.3,v 1.4 1996/08/13 06:36:59 deraadt Exp $
 .\"	$NetBSD: rpc.3,v 1.3 1996/01/04 20:09:53 pk Exp $
 .\"
 .TH RPC 3N "16 February 1988"
@@ -325,8 +325,8 @@ and their argument types and what they do are:
 .IP
 .nf
 .ta +2.0i +2.0i +2.0i
-.SM CLSET_TIMEOUT\s0	struct timeval	set total timeout
-.SM CLGET_TIMEOUT\s0	struct timeval	get total timeout
+.SM CLSET_TIMEOUT	struct timeval	set total timeout
+.SM CLGET_TIMEOUT	struct timeval	get total timeout
 .fi
 .IP
 Note: if you set the timeout using
@@ -336,7 +336,8 @@ the timeout parameter passed to
 will be ignored in all future calls.
 .IP
 .nf
-.SM CLGET_SERVER_ADDR\s0	struct sockaddr_in 	get server's address
+.ta +2.0i +2.0i +2.0i
+.SM CLGET_SERVER_ADDR	struct sockaddr_in 	get server's address
 .fi
 .br
 .IP
@@ -346,8 +347,8 @@ only:
 .IP
 .nf
 .ta +2.0i +2.0i +2.0i
-.SM CLSET_RETRY_TIMEOUT\s0		struct timeval	set the retry timeout
-.SM CLGET_RETRY_TIMEOUT\s0		struct timeval	get the retry timeout
+.SM CLSET_RETRY_TIMEOUT   struct timeval	set the retry timeout
+.SM CLGET_RETRY_TIMEOUT   struct timeval	get the retry timeout
 .fi
 .br
 .IP
@@ -512,7 +513,7 @@ if the program does not have a standard error (as a program
 running as a server quite likely does not), or if the
 programmer
 does not want the message to be output with
-.BR printf ,
+.BR printf(\|) ,
 or if a message format different than that supported by
 .B clnt_perrno(\|)
 is to be used.
@@ -668,7 +669,7 @@ then this routine opens a new one and sets
 The
 .SM UDP
 transport resends the call message in intervals of
-.B wait
+.I wait
 time until a response is received or until the call times
 out.
 The total time for the call to time out is specified by
@@ -722,7 +723,7 @@ then this routine opens a new one and sets
 The
 .SM UDP
 transport resends the call message in intervals of
-.B wait
+.I wait
 time until a response is received or until the call times
 out.
 The total time for the call to time out is specified by
@@ -1001,18 +1002,23 @@ fd_set svc_fdset;
 A global variable reflecting the
 .SM RPC
 service side's
-read file descriptor bit mask; it is suitable as a parameter
-to the
-.B select
-system call. This is only of interest
-if a service implementor does not call
+read file descriptor bit mask.
+This is only of interest
+if service implementors do not call
 .BR svc_run(\|) ,
-but rather does his own asynchronous event processing.
-This variable is read-only (do not pass its address to
-.BR select !),
-yet it may change after calls to
-.B svc_getreqset(\|)
-or any creation routines.
+but rather do their own asynchronous event processing.
+This variable is read-only, and it may change after calls
+to svc_getreqset() or any creation routines.
+Do not pass its address to
+.BR select(\|) !
+Instead, pass the address of a copy.
+.br
+As well, note that if the process has descriptor limits
+which are extended beyond
+.BR FD_SETSIZE ,
+this variable will only be usable for the first
+.BR FD_SETSIZE
+descriptors.
 .br
 .if t .ne 6
 .LP
@@ -1024,10 +1030,10 @@ int svc_fds;
 .ft R
 .IP
 Similar to
-.BR svc_fedset(\|) ,
+.BR svc_fedset ,
 but limited to 32 descriptors. This
 interface is obsoleted by
-.BR svc_fdset(\|) .
+.BR svc_fdset .
 .br
 .if t .ne 9
 .LP