[src/trunk]: src/lib/libc/rpc Convert to mdoc. Fix one or two bugs while here...

[wiz <wiz%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/632a09b69ec7
branches:  trunk
changeset: 545900:632a09b69ec7
user:      wiz <wiz%NetBSD.org@localhost>
date:      Thu Apr 17 17:02:48 2003 +0000

description:
Convert to mdoc. Fix one or two bugs while here, hope I didn't introduce
more :)

diffstat:

 lib/libc/rpc/rpc_soc.3 |  2215 +++++++++++++++--------------------------------
 1 files changed, 722 insertions(+), 1493 deletions(-)

diffs (truncated from 2546 to 300 lines):

diff -r 9438e1698895 -r 632a09b69ec7 lib/libc/rpc/rpc_soc.3
--- a/lib/libc/rpc/rpc_soc.3    Thu Apr 17 16:57:49 2003 +0000
+++ b/lib/libc/rpc/rpc_soc.3    Thu Apr 17 17:02:48 2003 +0000
@@ -1,77 +1,231 @@
 .\"    @(#)rpc.3n      2.4 88/08/08 4.0 RPCSRC; from 1.19 88/06/24 SMI
-.\"    $NetBSD: rpc_soc.3,v 1.7 2003/01/18 11:29:05 thorpej Exp $
+.\"    $NetBSD: rpc_soc.3,v 1.8 2003/04/17 17:02:48 wiz Exp $
+.\" Converted to mdoc by Thomas Klausner <wiz%netbsd.org@localhost>
 .\"
-.TH RPC_SOC 3 "16 February 1988"
-.SH NAME
-rpc_soc,
-auth_destroy,
-authnone_create,
-authunix_create,
-authunix_create_default,
-callrpc,
-clnt_broadcast,
-clnt_call,
-clnt_control,
-clnt_create,
-clnt_destroy,
-clnt_freeres,
-clnt_geterr,
-clnt_pcreateerror,
-clnt_perrno,
-clnt_perror,
-clnt_spcreateerror,
-clnt_sperrno,
-clnt_sperror,
-clntraw_create,
-clnttcp_create,
-clntudp_bufcreate,
-clntudp_create,
-get_myaddress,
-pmap_getmaps,
-pmap_getport,
-pmap_rmtcall,
-pmap_set,
-pmap_unset,
-registerrpc,
-rpc_createerr,
-svc_destroy,
-svc_fds,
-svc_fdset,
-svc_getargs,
-svc_getcaller,
-svc_getreg,
-svc_getregset,
-svc_register,
-svc_run,
-svc_sendreply,
-svc_unregister,
-svcerr_auth,
-svcerr_decode,
-svcerr_noproc,
-svcerr_noprog,
-svcerr_progvers,
-svcerr_systemerr,
-svcerr_weakauth,
-svcfd_create,
-svcraw_create,
-xdr_accepted_reply,
-xdr_authunix_parms,
-xdr_callhdr,
-xdr_callmsg,
-xdr_opaque_auth,
-xdr_pmap,
-xdr_pmaplist,
-xdr_rejected_reply,
-xdr_replymsg,
-xprt_register,
-xprt_unregister \- library routines for remote procedure calls
-.SH SYNOPSIS AND DESCRIPTION
-.B The svc and clnt functions described in this page are the old, TS-RPC
-.B interface to the XDR and RPC library, and exist
-.B for backward compatibility. The new interface is described in the pages
-.B referenced from
-.BR rpc (3).
-.PP
+.Dd April 17, 2003
+.Dt RPC_SOC 3
+.Os
+.Sh NAME
+.Nm rpc_soc ,
+.Nm auth_destroy ,
+.Nm authnone_create ,
+.Nm authunix_create ,
+.Nm authunix_create_default ,
+.Nm callrpc ,
+.Nm clnt_broadcast ,
+.Nm clnt_call ,
+.Nm clnt_control ,
+.Nm clnt_create ,
+.Nm clnt_destroy ,
+.Nm clnt_freeres ,
+.Nm clnt_geterr ,
+.Nm clnt_pcreateerror ,
+.Nm clnt_perrno ,
+.Nm clnt_perror ,
+.Nm clnt_spcreateerror ,
+.Nm clnt_sperrno ,
+.Nm clnt_sperror ,
+.Nm clntraw_create ,
+.Nm clnttcp_create ,
+.Nm clntudp_bufcreate ,
+.Nm clntudp_create ,
+.Nm get_myaddress ,
+.Nm pmap_getmaps ,
+.Nm pmap_getport ,
+.Nm pmap_rmtcall ,
+.Nm pmap_set ,
+.Nm pmap_unset ,
+.Nm registerrpc ,
+.Nm rpc_createerr ,
+.Nm svc_destroy ,
+.Nm svc_fds ,
+.Nm svc_fdset ,
+.Nm svc_getargs ,
+.Nm svc_getcaller ,
+.Nm svc_getreg ,
+.Nm svc_getregset ,
+.Nm svc_register ,
+.Nm svc_run ,
+.Nm svc_sendreply ,
+.Nm svc_unregister ,
+.Nm svcerr_auth ,
+.Nm svcerr_decode ,
+.Nm svcerr_noproc ,
+.Nm svcerr_noprog ,
+.Nm svcerr_progvers ,
+.Nm svcerr_systemerr ,
+.Nm svcerr_weakauth ,
+.Nm svcfd_create ,
+.Nm svcraw_create ,
+.Nm xdr_accepted_reply ,
+.Nm xdr_authunix_parms ,
+.Nm xdr_callhdr ,
+.Nm xdr_callmsg ,
+.Nm xdr_opaque_auth ,
+.Nm xdr_pmap ,
+.Nm xdr_pmaplist ,
+.Nm xdr_rejected_reply ,
+.Nm xdr_replymsg ,
+.Nm xprt_register ,
+.Nm xprt_unregister
+.Nd library routines for remote procedure calls
+.Sh SYNOPSIS
+.In rpc/rpc.h
+.Ft void
+.Fn auth_destroy "AUTH *auth"
+.Ft AUTH *
+.Fn authnone_create "void"
+.Ft AUTH *
+.Fn authunix_create "char *host" "int uid" "int gid" "int len" "int *aup_gids"
+.Ft AUTH *
+.Fn authunix_create_default "void"
+.Ft int
+.Fn callrpc "char *host" "u_long prognum" "u_long versnum" \
+"u_long procnum" "xdrproc_t inproc" "char *in" "xdrproc_t outproc" "char *out"
+.Ft enum clnt_stat
+.Fn clnt_broadcast "u_long prognum" "u_long versnum" "u_long procnum" \
+"xdrproc_t inproc" "char *in" "xdrproc_t outproc" "char *out" \
+"resultproc_t eachresult"
+.Ft enum clnt_stat
+.Fn clnt_call "CLIENT *clnt" "u_long procnum" "xdrproc_t inproc" \
+"char *in" "xdrproc_t outproc" "char *out" "struct timeval tout"
+.Ft int
+.Fn clnt_destroy "CLIENT *clnt"
+.Ft CLIENT *
+.Fn clnt_create "char *host" "u_long prog" "u_long vers" "char *proto"
+.Ft bool_t
+.Fn clnt_control "CLIENT *cl" "u_int req" "char *info"
+.Ft int
+.Fn clnt_freeres "CLIENT *clnt" "xdrproc_t outproc" "char *out"
+.Ft void
+.Fn clnt_geterr "CLIENT *clnt" "struct rpc_err errp"
+.Ft void
+.Fn clnt_pcreateerror "char *s"
+.Ft void
+.Fn clnt_perrno "enum clnt_stat stat"
+.Ft int
+.Fn clnt_perror "CLIENT *clnt" "char *s"
+.Ft char *
+.Fn clnt_spcreateerror "const char *s"
+.Ft char *
+.Fn clnt_sperrno "enum clnt_stat stat"
+.Ft char *
+.Fn clnt_sperror "CLIENT *rpch" "char *s"
+.Ft CLIENT *
+.Fn clntraw_create "u_long prognum" "u_long versnum"
+.Ft CLIENT *
+.Fn clnttcp_create "struct sockaddr_in *addr" "u_long prognum" \
+"u_long versnum" "int *sockp" "u_int sendsz" "u_int recvsz"
+.Ft CLIENT *
+.Fn clntudp_create "struct sockaddr_in *addr" "u_long prognum" \
+"u_long versnum" "struct timeval wait" "int *sockp"
+.Ft CLIENT *
+.Fn clntudp_bufcreate "struct sockaddr_in *addr" "u_long prognum" \
+"u_long versnum" "struct timeval wait" "int *sockp" \
+"unsigned int sendsize" "unsigned int recosize"
+.Ft int
+.Fn get_myaddress "struct sockaddr_in *addr"
+.Ft struct pmaplist *
+.Fn pmap_getmaps "struct sockaddr_in *addr"
+.Ft u_short
+.Fn pmap_getport "struct sockaddr_in *addr" "u_long prognum" \
+"u_long versnum" "u_long protocol"
+.Ft enum clnt_stat
+.Fo pmap_rmtcall
+.Fa "struct sockaddr_in *addr"
+.Fa "u_long prognum"
+.Fa "u_long versnum"
+.Fa "u_long procnum"
+.Fa "xdrproc_t inproc"
+.Fa "char *in"
+.Fa "xdrpoc_t outproc"
+.Fa "char *out"
+.Fa "struct timeval tout"
+.Fa "u_long *portp"
+.Fc
+.Ft int
+.Fn pmap_set "u_long prognum" "u_long versnum" "int protocol" \
+"int port"
+.Ft int
+.Fn pmap_unset "u_long prognum" "u_long versnum"
+.Ft int
+.Fn registerrpc "u_long prognum" "u_long versnum" "u_long procnum" \
+"char *(*procname)()" "xdrproc_t inproc" "xdrproc_t outproc"
+.Fd struct rpc_createerr rpc_createerr;
+.Ft int
+.Fn svc_destroy "SVCXPRT *xprt"
+.Fd fd_set svc_fdset;
+.Fd int svc_fds;
+.Ft int
+.Fn svc_freeargs "SVCXPRT *xprt" "xdrproc_t inproc" "char *in"
+.Ft int
+.Fn svc_getargs "SVCXPRT *xprt" "xdrproc_t inproc" "char *in"
+.Ft struct sockaddr_in *
+.Fn svc_getcaller "SVCXPRT *xprt"
+.Ft int
+.Fn svc_getreqset "fd_set *rdfds"
+.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"
+.Ft int
+.Fn svc_run "void"
+.Ft int
+.Fn svc_sendreply "SVCXPRT *xprt" "xdrproc_t outproc" "char *out"
+.Ft void
+.Fn svc_unregister "u_long prognum" "u_long versnum"
+.Ft void
+.Fn svcerr_auth "SVCXPRT *xprt" "enum auth_stat why"
+.Ft void
+.Fn svcerr_decode "SVCXPRT *xprt"
+.Ft void
+.Fn svcerr_noproc "SVCXPRT *xprt"
+.Ft void
+.Fn svcerr_noprog "SVCXPRT *xprt"
+.Ft void
+.Fn svcerr_progvers "SVCXPRT *xprt"
+.Ft void
+.Fn svcerr_systemerr "SVCXPRT *xprt"
+.Ft void
+.Fn svcerr_weakauth "SVCXPRT *xprt"
+.Ft SVCXPRT *
+.Fn svcraw_create "void"
+.Ft SVCXPRT *
+.Fn svctcp_create "int sock" "u_int send_buf_size" \
+"u_int recv_buf_size"
+.Ft SVCXPRT *
+.Fn svcfd_create "int fd" "u_int sendsize" "u_int recvsize"
+.Ft SVCXPRT *
+.Fn svcudp_bufcreate "int sock" "u_int sendsize" "u_int recosize"
+.Ft int
+.Fn xdr_accepted_reply "XDR *xdrs" "struct accepted_reply *ar"
+.Ft int
+.Fn xdr_authunix_parms "XDR *xdrs" "struct authunix_parms *aupp"
+.Ft void
+.Fn xdr_callhdr "XDR *xdrs" "struct rpc_msg *chdr"
+.Ft int
+.Fn xdr_callmsg "XDR *xdrs" "struct rpc_msg *cmsg"
+.Ft int
+.Fn xdr_opaque_auth "XDR *xdrs" "struct opaque_auth *ap"
+.Ft int
+.Fn xdr_pmap "XDR *xdrs" "struct pmap *regs"
+.Ft int
+.Fn xdr_pmaplist "XDR *xdrs" "struct pmaplist **rp"
+.Ft int
+.Fn xdr_rejected_reply "XDR *xdrs" "struct rejected_reply *rr"
+.Ft int
+.Fn xdr_replymsg "XDR *xdrs" "struct rpc_msg *rmsg"
+.Ft void
+.Fn xprt_register "SVCXPRT *xprt"
+.Ft void
+.Fn xprt_unregister "SVCXPRT *xprt"
+.Sh DESCRIPTION
+.Em "The svc and clnt functions described in this page are the old, TS-RPC"