summaryrefslogtreecommitdiff
path: root/lib
diff options
context:
space:
mode:
authorIngo Schwarze <schwarze@cvs.openbsd.org>2009-06-02 14:11:40 +0000
committerIngo Schwarze <schwarze@cvs.openbsd.org>2009-06-02 14:11:40 +0000
commit1d41b8ff804a2b5e20a574f438bdc97dbabbc3f7 (patch)
tree1de18e1166b17634ed3c0049d3044c000dd538a3 /lib
parentf932261b722dab255b11a9352868ae066949052f (diff)
make the documentation of {svc,clnt}*create complete and correct
ok millert@ jmc@
Diffstat (limited to 'lib')
-rw-r--r--lib/libc/rpc/Makefile.inc3
-rw-r--r--lib/libc/rpc/rpc.328
2 files changed, 21 insertions, 10 deletions
diff --git a/lib/libc/rpc/Makefile.inc b/lib/libc/rpc/Makefile.inc
index 95e1c9e28c6..2d6967102ba 100644
--- a/lib/libc/rpc/Makefile.inc
+++ b/lib/libc/rpc/Makefile.inc
@@ -1,4 +1,4 @@
-# $OpenBSD: Makefile.inc,v 1.14 2008/06/13 23:39:26 deraadt Exp $
+# $OpenBSD: Makefile.inc,v 1.15 2009/06/02 14:11:39 schwarze Exp $
# librpc sources
.PATH: ${LIBCSRCDIR}/arch/${MACHINE}/rpc ${LIBCSRCDIR}/rpc
@@ -77,6 +77,7 @@ MLINKS+= bindresvport.3 bindresvport_sa.3 \
rpc.3 svcraw_create.3 \
rpc.3 svctcp_create.3 \
rpc.3 svcudp_bufcreate.3 \
+ rpc.3 svcudp_create.3 \
rpc.3 xdr_accepted_reply.3 \
rpc.3 xdr_authunix_parms.3 \
rpc.3 xdr_callhdr.3 \
diff --git a/lib/libc/rpc/rpc.3 b/lib/libc/rpc/rpc.3
index 4e29b5080a5..6ca04f54c3e 100644
--- a/lib/libc/rpc/rpc.3
+++ b/lib/libc/rpc/rpc.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: rpc.3,v 1.38 2007/05/31 19:19:30 jmc Exp $
+.\" $OpenBSD: rpc.3,v 1.39 2009/06/02 14:11:39 schwarze Exp $
.\"
.\" Copyright (c) 1998 Theo de Raadt
.\" All rights reserved.
@@ -78,7 +78,7 @@
.\" 2550 Garcia Avenue
.\" Mountain View, California 94043
.\"
-.Dd $Mdocdate: May 31 2007 $
+.Dd $Mdocdate: June 2 2009 $
.Dt RPC 3
.Os
.Sh NAME
@@ -133,7 +133,9 @@
.Nm svcerr_systemerr ,
.Nm svcerr_weakauth ,
.Nm svcfd_create ,
+.Nm svcraw_create ,
.Nm svctcp_create ,
+.Nm svcudp_create ,
.Nm svcudp_bufcreate ,
.Nm xdr_accepted_reply ,
.Nm xdr_authunix_parms ,
@@ -261,7 +263,9 @@
.Ft SVCXPRT *
.Fn svcfd_create "int fd" "u_int sendsize" "u_int recvsize"
.Ft SVCXPRT *
-.Fn svcudp_bufcreate "int sock"
+.Fn svcudp_create "int sock"
+.Ft SVCXPRT *
+.Fn svcudp_bufcreate "int sock" "u_int sendsz" "u_int recvsz"
.Ft bool_t
.Fn xdr_accepted_reply "XDR *xdrs" "struct accepted_reply *ar"
.Ft bool_t
@@ -677,11 +681,14 @@ out.
The total time for the call to time out is specified by
.Fn clnt_call .
.Pp
-This allows the user to specify the maximum packet size for sending
+.Fn clntudp_bufcreate
+is like
+.Fn clntudp_create ,
+except that it allows the user to specify the maximum packet size for sending
and receiving
.Tn UDP-based
.Tn RPC
-messages.
+messages instead of using the default size limit of 8800 bytes.
.Pp
.Fn get_myaddress
stuffs the machine's
@@ -1238,7 +1245,7 @@ and
indicate sizes for the send and receive buffers.
If they are zero, a reasonable default is chosen.
.Pp
-.Fn svcudp_bufcreate
+.Fn svcudp_create
is a routine which creates a
.Tn UDP/IP-based
.Tn RPC
@@ -1260,11 +1267,14 @@ This routine returns
.Tn NULL
if it fails.
.Pp
-This allows the user to specify the maximum packet size for sending and
-receiving
+.Fn svcudp_bufcreate
+is like
+.Fn svcudp_create ,
+except that it allows the user to specify the maximum packet size for sending
+and receiving
.Tn UDP-based
.Tn RPC
-messages.
+messages instead of using the default size limit of 8800 bytes.
.Pp
.Fn xdr_accepted_reply
is used for encoding