a start at splitting rpc.3 up a bit; plus fix other errors

2 files changed, 103 insertions, 63 deletions

diff --git a/lib/libc/rpc/rpc.3 b/lib/libc/rpc/rpc.3
index 5e7201aa752..2f045f5edb3 100644
--- a/lib/libc/rpc/rpc.3
+++ b/lib/libc/rpc/rpc.3
@@ -1,14 +1,10 @@
-.\"	$OpenBSD: rpc.3,v 1.9 1998/02/25 12:23:17 deraadt Exp $
+.\"	$OpenBSD: rpc.3,v 1.10 1998/03/11 18:55:40 deraadt Exp $
 .\" Mostly converted to mandoc by Theo de Raadt, Tue Feb 24 04:04:46 MST 1998
 .\"
 .Dd February 16, 1988
 .Dt RPC 3
 .Os
 .Sh NAME
-.Nm auth_destroy ,
-.Nm authnone_create ,
-.Nm authunix_create ,
-.Nm authunix_create_default ,
 .Nm callrpc ,
 .Nm clnt_broadcast ,
 .Nm clnt_call ,
@@ -69,14 +65,6 @@
 .Nd library routines for remote procedure calls
 .Sh SYNOPSIS
 .Fd #include <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"
@@ -213,66 +201,22 @@ Finally, the procedure call returns to the client.
 .\"Routines that are used for Secure RPC (DES authentication) are described in
 .\".Xr rpc_secure 3 .
 .\"Secure RPC can be used only if DES encryption is available.
-.Pp
-.Fn auth_destroy
-is a macro that destroys the authentication information associated with
-.Fa auth .
-Destruction usually involves deallocation of private data
-structures. The use of
-.I auth
-is undefined after calling
-.Fn auth_destroy .
-.Pp
-.Fn authnone_create
-creates and returns an
-.Tn RPC
-authentication handle that passes nonusable authentication
-information with each remote procedure call. This is the
-default authentication used by
-.Tn RPC.
-.Pp
-.Fn authunix_create
-creates and returns an
-.Tn RPC
-authentication handle that contains
-.UX
-authentication information.
-The parameter
-.I host
-is the name of the machine on which the information was
-created;
-.I uid
-is the user's user
-.Tn ID ;
-.I gid
-is the user's current group
-.Tn ID ;
-.I len
-and
-.I aup_gids
-refer to a counted array of groups to which the user belongs.
-It is easy to impersonate a user.
-.Pp
-.Fn authunix_create_default
-calls
-.Fn authunix_create
-with the appropriate parameters.
 .Fn callrpc
 calls the remote procedure associated with
 .Fa prognum ,
 .Fa versnum ,
 and
-.I procnum
+.Fa procnum
 on the machine,
 .Fa host .
 The parameter
-.I in
+.Fa in
 is the address of the procedure's argument(s), and
-.I out
+.Fa out
 is the address of where to place the result(s);
-.I inproc
+.Fa inproc
 is used to encode the procedure's parameters, and
-.I outproc
+.Fa outproc
 is used to decode the procedure's results.
 This routine returns zero if it succeeds, or the value of
 .Fa"enum clnt_stat"
@@ -280,7 +224,7 @@ cast to an integer if it fails.
 The routine
 .Fn clnt_perrno
 is handy for translating failure statuses into messages.
-.IP
+.Pp
 Warning: calling remote procedures with this routine
 uses
 .Tn UDP/IP
@@ -1206,6 +1150,7 @@ Service implementors usually do not need this routine.
 .Xr getrpcport 3 ,
 .Xr portmap 8 ,
 .Xr rpc 5 ,
+.Xr rpcauth 3 ,
 .Xr rpcgen 1 ,
 .Xr select 2 ,
 .Xr xdr 3 .
diff --git a/lib/libc/rpc/rpcauth.3 b/lib/libc/rpc/rpcauth.3
new file mode 100644
index 00000000000..27a82bfbb74
--- /dev/null
+++ b/lib/libc/rpc/rpcauth.3
@@ -0,0 +1,95 @@
+.\"	$OpenBSD: rpcauth.3,v 1.1 1998/03/11 18:55:42 deraadt Exp $
+.\" Mostly converted to mandoc by Theo de Raadt, Tue Feb 24 04:04:46 MST 1998
+.\"
+.Dd February 16, 1988
+.Dt RPC 3
+.Os
+.Sh NAME
+.Nm auth_destroy ,
+.Nm authnone_create ,
+.Nm authunix_create ,
+.Nm authunix_create_default
+.Nd library routines for remote procedure calls
+.Sh SYNOPSIS
+.Fd #include <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"
+.Sh DESCRIPTION
+These routines establish authentication information for use by the
+RPC functions described in
+.Xr rpc 3 .
+.Pp
+.Fn auth_destroy
+is a macro that destroys the authentication information associated with
+.Fa auth .
+Destruction usually involves deallocation of private data
+structures. The use of
+.Fa auth
+is undefined after calling
+.Fn auth_destroy .
+.Pp
+.Fn authnone_create
+creates and returns an
+.Tn RPC
+authentication handle that passes nonusable authentication
+information with each remote procedure call. This is the
+default authentication used by
+.Tn RPC.
+.Pp
+.Fn authunix_create
+creates and returns an
+.Tn RPC
+authentication handle that contains
+.UX
+authentication information.
+The parameter
+.Fa host
+is the name of the machine on which the information was
+created;
+.Fa uid
+is the user's user
+.Tn ID ;
+.Fa gid
+is the user's current group
+.Tn ID ;
+.Fa len
+and
+.Fa aup_gids
+refer to a counted array of groups to which the user belongs.
+It is easy to impersonate a user.
+.Pp
+.Fn authunix_create_default
+calls
+.Fn authunix_create
+with the appropriate parameters.
+.Pp
+.Sh SEE ALSO
+.\"Xr rpc_secure 3 ,
+.Xr rpc 3 ,
+.Xr getrpcport 3 ,
+.Xr portmap 8 ,
+.Xr rpc 5 ,
+.Xr rpcgen 1 ,
+.Xr select 2 ,
+.Xr xdr 3 .
+.br
+The following manuals:
+.RS
+.ft I
+Remote Procedure Calls: Protocol Specification
+.br
+Remote Procedure Call Programming Guide
+.br
+rpcgen Programming Guide
+.br
+.ft R
+.RE
+.Fa "RPC: Remote Procedure Call Protocol Specification" ,
+.Tn RFC1050, Sun Microsystems, Inc.,
+.Tn USC-ISI.