document svc_getreqset2(), a non-standard interface

2 files changed, 29 insertions, 2 deletions

diff --git a/lib/libc/rpc/Makefile.inc b/lib/libc/rpc/Makefile.inc
index 3a3b3599939..afcec0471c5 100644
--- a/lib/libc/rpc/Makefile.inc
+++ b/lib/libc/rpc/Makefile.inc
@@ -1,4 +1,4 @@
-#	$OpenBSD: Makefile.inc,v 1.10 2000/01/26 06:22:54 deraadt Exp $
+#	$OpenBSD: Makefile.inc,v 1.11 2000/12/21 21:11:31 deraadt Exp $
 
 # librpc sources
 .PATH:	${LIBCSRCDIR}/arch/${MACHINE}/rpc ${LIBCSRCDIR}/rpc
@@ -56,6 +56,7 @@ MLINKS+=	bindresvport.3 bindresvport_sa.3 \
 		rpc.3 svc_getcaller.3 \
 		rpc.3 svc_getreq.3 \
 		rpc.3 svc_getreqset.3 \
+		rpc.3 svc_getreqset2.3 \
 		rpc.3 svc_register.3 \
 		rpc.3 svc_run.3 \
 		rpc.3 svc_sendreply.3 \
diff --git a/lib/libc/rpc/rpc.3 b/lib/libc/rpc/rpc.3
index 5fd530bd0c9..dcb48497576 100644
--- a/lib/libc/rpc/rpc.3
+++ b/lib/libc/rpc/rpc.3
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: rpc.3,v 1.24 2000/11/09 23:00:52 deraadt Exp $
+.\"	$OpenBSD: rpc.3,v 1.25 2000/12/21 21:11:31 deraadt Exp $
 .\" Mostly converted to mandoc by Theo de Raadt, Tue Feb 24 04:04:46 MST 1998
 .\"
 .Dd February 16, 1988
@@ -38,6 +38,7 @@
 .Nm svc_getcaller ,
 .Nm svc_getreq ,
 .Nm svc_getreqset ,
+.Nm svc_getreqset2 ,
 .Nm svc_register ,
 .Nm svc_sendreply ,
 .Nm svc_unregister ,
@@ -137,6 +138,8 @@
 .Ft int
 .Fn svc_getreqset "fd_set *rdfds"
 .Ft int
+.Fn svc_getreqset2 "fd_set *rdfds, int width"
+.Ft int
 .Fn svc_getreq "int rdfds"
 .Ft int
 .Fn svc_register "SVCXPRT *xprt" "u_long prognum" "u_long versnum" "void (*dispatch)()" "u_long protocol"
@@ -868,6 +871,29 @@ value of
 .Fa rdfds
 have been serviced.
 .Pp
+.Fn svc_getreqset2
+is a non-standard routine which is only of interest if a service
+implementor does not call
+.Fn svc_run ,
+but instead implements custom asynchronous event processing.
+It is called when the
+.Xr select 2
+system call has determined that an
+.Tn RPC
+request has arrived on some
+.Tn RPC
+.Fa socket(s) ;
+.Fa rdfds
+is the resultant read file descriptor bit mask.
+The routine returns when all sockets associated with the
+value of
+.Fa rdfds
+have been serviced.
+This interface is non-portable, but provided for applications which
+need to deal with large fd_set sizes.
+.Tn RPC
+internals use it.
+.Pp
 .Fn svc_getreq
 is similar to
 .Fa svc_getreqset ,