From 3e5fc8944f2c83ae5ce462c31c2872f73cbf7add Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Love=20H=C3=B6rnquist=20=C3=85strand?= <lha@kth.se>
Date: Mon, 5 Sep 2005 07:56:09 +0000
Subject: [PATCH] Document krb5_rd_req.

git-svn-id: svn://svn.h5l.se/heimdal/trunk/heimdal@16035 ec53bebd-3082-4978-b11e-865c3cabbd6b
---
 lib/krb5/krb5_mk_req.3 | 34 +++++++++++++++++++++++++++++++++-
 1 file changed, 33 insertions(+), 1 deletion(-)

diff --git a/lib/krb5/krb5_mk_req.3 b/lib/krb5/krb5_mk_req.3
index 5bedff6db..70a8e2586 100644
--- a/lib/krb5/krb5_mk_req.3
+++ b/lib/krb5/krb5_mk_req.3
@@ -142,7 +142,39 @@ returns a mutual authentication packet.
 .Pp
 The
 .Nm krb5_rd_req
-\&...
+read the AP_REQ in
+.Fa inbuf
+and verify and extract the content .
+If
+.Fa server
+is specified, that server will be fetched from the
+.Fa keytab
+and used unconditionally.
+If
+.Fa server
+is
+.Dv NULL ,
+the
+.Fa keytab
+will be search for a matching principal.
+.Pp
+The
+.Fa keytab
+argument specifies what keytab to search for receiving principals.
+The arguments
+.Fa ap_req_options
+and
+.Fa ticket
+returns the content.
+.Pp
+When the AS-REQ is a user to user request, neither of
+.Fa keytab
+or
+.Fa principal
+are used, instead
+.Fn krb5_rd_req
+expects the session key to be set in
+.Fa auth_context .
 .Pp
 The
 .Nm krb5_build_ap_req