From: Theodore Tso <tytso@mit.edu>
Date: Tue, 11 Dec 1990 13:29:14 +0000 (+0000)
Subject: Documented extra argument to mk_req_extended
X-Git-Tag: krb5-1.0-alpha3~59
X-Git-Url: http://git.tremily.us/?a=commitdiff_plain;h=e842aa405c6835ee58024b2786d60d43b4387794;p=krb5.git

Documented extra argument to mk_req_extended

git-svn-id: svn://anonsvn.mit.edu/krb5/trunk@1534 dc483132-0cff-0310-8789-dd5450dbe970
---

diff --git a/doc/api/krb5.tex b/doc/api/krb5.tex
index b341660b9..35a83b7b9 100644
--- a/doc/api/krb5.tex
+++ b/doc/api/krb5.tex
@@ -342,6 +342,7 @@ Returns system errors.
 \funcarg{krb5_ccache}{ccache}
 \funcinout
 \funcarg{krb5_creds *}{creds}
+\funcarg{krb5_authenticator *}{authentp}
 \funcout
 \funcarg{krb5_data *}{outbuf}
 \end{funcdecl}
@@ -370,7 +371,13 @@ If \funcparam{ap_req_options} specifies AP_OPTS_USE_SESSION_KEY, then
 \funcparam{creds{\ptsto}ticket} must contain the appropriate
 ENC-TKT-IN-SKEY ticket.
 
-\funcparam{checksum} specifies the checksum to be used in the authenticator.
+\funcparam{checksum} specifies the checksum to be used in the
+authenticator.
+
+If \funcparam{authentp} is non-NULL, it krb5_mk_req_extended will store
+a copy of authenticator there, with the principal and checksum fields
+nulled out.  (This is to prevent pointer sharing problems; the caller
+shouldn't need these fields anyway, since the caller supplied them.)
 
 The \funcparam{outbuf} buffer storage is allocated, and should be freed
 by the caller when finished.