xref: /freebsd/crypto/heimdal/doc/doxyout/krb5/html/group__krb5__auth.html (revision 6a068746777241722b2b32c5d0bc443a2a64d80b)
1ae771770SStanislav Sedov<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2ae771770SStanislav Sedov<html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
3ae771770SStanislav Sedov<title>HeimdalKerberos5library: Heimdal Kerberos 5 authentication functions</title>
4ae771770SStanislav Sedov<link href="doxygen.css" rel="stylesheet" type="text/css">
5ae771770SStanislav Sedov<link href="tabs.css" rel="stylesheet" type="text/css">
6ae771770SStanislav Sedov</head><body>
7ae771770SStanislav Sedov<p>
8ae771770SStanislav Sedov<a href="http://www.h5l.org/"><img src="http://www.h5l.org/keyhole-heimdal.png" alt="keyhole logo"/></a>
9ae771770SStanislav Sedov</p>
10ae771770SStanislav Sedov<!-- end of header marker -->
11ae771770SStanislav Sedov<!-- Generated by Doxygen 1.5.6 -->
12ae771770SStanislav Sedov<div class="navigation" id="top">
13ae771770SStanislav Sedov  <div class="tabs">
14ae771770SStanislav Sedov    <ul>
15ae771770SStanislav Sedov      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
16ae771770SStanislav Sedov      <li><a href="pages.html"><span>Related&nbsp;Pages</span></a></li>
17ae771770SStanislav Sedov      <li><a href="modules.html"><span>Modules</span></a></li>
18ae771770SStanislav Sedov      <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
19ae771770SStanislav Sedov    </ul>
20ae771770SStanislav Sedov  </div>
21ae771770SStanislav Sedov</div>
22ae771770SStanislav Sedov<div class="contents">
23ae771770SStanislav Sedov<h1>Heimdal Kerberos 5 authentication functions</h1><table border="0" cellpadding="0" cellspacing="0">
24ae771770SStanislav Sedov<tr><td></td></tr>
25ae771770SStanislav Sedov<tr><td colspan="2"><br><h2>Functions</h2></td></tr>
26ae771770SStanislav Sedov<tr><td class="memItemLeft" nowrap align="right" valign="top">KRB5_LIB_FUNCTION <br>
27ae771770SStanislav Sedovkrb5_error_code KRB5_LIB_CALL&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__krb5__auth.html#g92b082fa699694b353fa51675f2c2259">krb5_rd_req_in_ctx_alloc</a> (krb5_context context, krb5_rd_req_in_ctx *ctx)</td></tr>
28ae771770SStanislav Sedov
29ae771770SStanislav Sedov<tr><td class="memItemLeft" nowrap align="right" valign="top">KRB5_LIB_FUNCTION <br>
30ae771770SStanislav Sedovkrb5_error_code KRB5_LIB_CALL&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__krb5__auth.html#g124150b9eea8b56a9b432cf5e7a8db07">krb5_rd_req_in_set_keytab</a> (krb5_context context, krb5_rd_req_in_ctx in, krb5_keytab keytab)</td></tr>
31ae771770SStanislav Sedov
32ae771770SStanislav Sedov<tr><td class="memItemLeft" nowrap align="right" valign="top">KRB5_LIB_FUNCTION <br>
33ae771770SStanislav Sedovkrb5_error_code KRB5_LIB_CALL&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__krb5__auth.html#gdd6913bc77982a536168d9dd52df2363">krb5_rd_req_in_set_pac_check</a> (krb5_context context, krb5_rd_req_in_ctx in, krb5_boolean flag)</td></tr>
34ae771770SStanislav Sedov
35ae771770SStanislav Sedov<tr><td class="memItemLeft" nowrap align="right" valign="top">KRB5_LIB_FUNCTION <br>
36ae771770SStanislav Sedovkrb5_error_code KRB5_LIB_CALL&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__krb5__auth.html#gc1ffffee7558466d31c23b110c95aa7b">krb5_rd_req_out_get_server</a> (krb5_context context, krb5_rd_req_out_ctx out, krb5_principal *principal)</td></tr>
37ae771770SStanislav Sedov
38ae771770SStanislav Sedov<tr><td class="memItemLeft" nowrap align="right" valign="top">KRB5_LIB_FUNCTION void <br>
39ae771770SStanislav SedovKRB5_LIB_CALL&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__krb5__auth.html#gd8a5460c599500c0d64e632341c8f74a">krb5_rd_req_out_ctx_free</a> (krb5_context context, krb5_rd_req_out_ctx ctx)</td></tr>
40ae771770SStanislav Sedov
41ae771770SStanislav Sedov<tr><td class="memItemLeft" nowrap align="right" valign="top">KRB5_LIB_FUNCTION <br>
42ae771770SStanislav Sedovkrb5_error_code KRB5_LIB_CALL&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__krb5__auth.html#g589cab7251a70a5addbf1af56313401e">krb5_rd_req_ctx</a> (krb5_context context, krb5_auth_context *auth_context, const krb5_data *inbuf, krb5_const_principal server, krb5_rd_req_in_ctx inctx, krb5_rd_req_out_ctx *outctx)</td></tr>
43ae771770SStanislav Sedov
44ae771770SStanislav Sedov</table>
45ae771770SStanislav Sedov<hr><a name="_details"></a><h2>Detailed Description</h2>
46ae771770SStanislav Sedov<hr><h2>Function Documentation</h2>
47ae771770SStanislav Sedov<a class="anchor" name="g589cab7251a70a5addbf1af56313401e"></a><!-- doxytag: member="rd_req.c::krb5_rd_req_ctx" ref="g589cab7251a70a5addbf1af56313401e" args="(krb5_context context, krb5_auth_context *auth_context, const krb5_data *inbuf, krb5_const_principal server, krb5_rd_req_in_ctx inctx, krb5_rd_req_out_ctx *outctx)" -->
48ae771770SStanislav Sedov<div class="memitem">
49ae771770SStanislav Sedov<div class="memproto">
50ae771770SStanislav Sedov      <table class="memname">
51ae771770SStanislav Sedov        <tr>
52ae771770SStanislav Sedov          <td class="memname">KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_rd_req_ctx           </td>
53ae771770SStanislav Sedov          <td>(</td>
54ae771770SStanislav Sedov          <td class="paramtype">krb5_context&nbsp;</td>
55ae771770SStanislav Sedov          <td class="paramname"> <em>context</em>, </td>
56ae771770SStanislav Sedov        </tr>
57ae771770SStanislav Sedov        <tr>
58ae771770SStanislav Sedov          <td class="paramkey"></td>
59ae771770SStanislav Sedov          <td></td>
60ae771770SStanislav Sedov          <td class="paramtype">krb5_auth_context *&nbsp;</td>
61ae771770SStanislav Sedov          <td class="paramname"> <em>auth_context</em>, </td>
62ae771770SStanislav Sedov        </tr>
63ae771770SStanislav Sedov        <tr>
64ae771770SStanislav Sedov          <td class="paramkey"></td>
65ae771770SStanislav Sedov          <td></td>
66ae771770SStanislav Sedov          <td class="paramtype">const krb5_data *&nbsp;</td>
67ae771770SStanislav Sedov          <td class="paramname"> <em>inbuf</em>, </td>
68ae771770SStanislav Sedov        </tr>
69ae771770SStanislav Sedov        <tr>
70ae771770SStanislav Sedov          <td class="paramkey"></td>
71ae771770SStanislav Sedov          <td></td>
72ae771770SStanislav Sedov          <td class="paramtype">krb5_const_principal&nbsp;</td>
73ae771770SStanislav Sedov          <td class="paramname"> <em>server</em>, </td>
74ae771770SStanislav Sedov        </tr>
75ae771770SStanislav Sedov        <tr>
76ae771770SStanislav Sedov          <td class="paramkey"></td>
77ae771770SStanislav Sedov          <td></td>
78ae771770SStanislav Sedov          <td class="paramtype">krb5_rd_req_in_ctx&nbsp;</td>
79ae771770SStanislav Sedov          <td class="paramname"> <em>inctx</em>, </td>
80ae771770SStanislav Sedov        </tr>
81ae771770SStanislav Sedov        <tr>
82ae771770SStanislav Sedov          <td class="paramkey"></td>
83ae771770SStanislav Sedov          <td></td>
84ae771770SStanislav Sedov          <td class="paramtype">krb5_rd_req_out_ctx *&nbsp;</td>
85ae771770SStanislav Sedov          <td class="paramname"> <em>outctx</em></td><td>&nbsp;</td>
86ae771770SStanislav Sedov        </tr>
87ae771770SStanislav Sedov        <tr>
88ae771770SStanislav Sedov          <td></td>
89ae771770SStanislav Sedov          <td>)</td>
90ae771770SStanislav Sedov          <td></td><td></td><td></td>
91ae771770SStanislav Sedov        </tr>
92ae771770SStanislav Sedov      </table>
93ae771770SStanislav Sedov</div>
94ae771770SStanislav Sedov<div class="memdoc">
95ae771770SStanislav Sedov
96ae771770SStanislav Sedov<p>
97ae771770SStanislav SedovThe core server function that verify application authentication requests from clients.<p>
98ae771770SStanislav Sedov<dl compact><dt><b>Parameters:</b></dt><dd>
99ae771770SStanislav Sedov  <table border="0" cellspacing="2" cellpadding="0">
100ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>context</em>&nbsp;</td><td>Keberos 5 context. </td></tr>
101ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>auth_context</em>&nbsp;</td><td>the authentication context, can be NULL, then default values for the authentication context will used. </td></tr>
102ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>inbuf</em>&nbsp;</td><td>the (AP-REQ) authentication buffer</td></tr>
103ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>server</em>&nbsp;</td><td>the server with authenticate as, if NULL the function will try to find any available credential in the keytab that will verify the reply. The function will prefer the server the server client specified in the AP-REQ, but if there is no mach, it will try all keytab entries for a match. This have serious performance issues for larger keytabs.</td></tr>
104ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>inctx</em>&nbsp;</td><td>control the behavior of the function, if NULL, the default behavior is used. </td></tr>
105ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>outctx</em>&nbsp;</td><td>the return outctx, free with <a class="el" href="group__krb5__auth.html#gd8a5460c599500c0d64e632341c8f74a">krb5_rd_req_out_ctx_free()</a>. </td></tr>
106ae771770SStanislav Sedov  </table>
107ae771770SStanislav Sedov</dl>
108ae771770SStanislav Sedov<dl class="return" compact><dt><b>Returns:</b></dt><dd>Kerberos 5 error code, see krb5_get_error_message(). </dd></dl>
109ae771770SStanislav Sedov
110ae771770SStanislav Sedov</div>
111ae771770SStanislav Sedov</div><p>
112ae771770SStanislav Sedov<a class="anchor" name="g92b082fa699694b353fa51675f2c2259"></a><!-- doxytag: member="rd_req.c::krb5_rd_req_in_ctx_alloc" ref="g92b082fa699694b353fa51675f2c2259" args="(krb5_context context, krb5_rd_req_in_ctx *ctx)" -->
113ae771770SStanislav Sedov<div class="memitem">
114ae771770SStanislav Sedov<div class="memproto">
115ae771770SStanislav Sedov      <table class="memname">
116ae771770SStanislav Sedov        <tr>
117ae771770SStanislav Sedov          <td class="memname">KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_rd_req_in_ctx_alloc           </td>
118ae771770SStanislav Sedov          <td>(</td>
119ae771770SStanislav Sedov          <td class="paramtype">krb5_context&nbsp;</td>
120ae771770SStanislav Sedov          <td class="paramname"> <em>context</em>, </td>
121ae771770SStanislav Sedov        </tr>
122ae771770SStanislav Sedov        <tr>
123ae771770SStanislav Sedov          <td class="paramkey"></td>
124ae771770SStanislav Sedov          <td></td>
125ae771770SStanislav Sedov          <td class="paramtype">krb5_rd_req_in_ctx *&nbsp;</td>
126ae771770SStanislav Sedov          <td class="paramname"> <em>ctx</em></td><td>&nbsp;</td>
127ae771770SStanislav Sedov        </tr>
128ae771770SStanislav Sedov        <tr>
129ae771770SStanislav Sedov          <td></td>
130ae771770SStanislav Sedov          <td>)</td>
131ae771770SStanislav Sedov          <td></td><td></td><td></td>
132ae771770SStanislav Sedov        </tr>
133ae771770SStanislav Sedov      </table>
134ae771770SStanislav Sedov</div>
135ae771770SStanislav Sedov<div class="memdoc">
136ae771770SStanislav Sedov
137ae771770SStanislav Sedov<p>
138ae771770SStanislav SedovAllocate a krb5_rd_req_in_ctx as an input parameter to <a class="el" href="group__krb5__auth.html#g589cab7251a70a5addbf1af56313401e">krb5_rd_req_ctx()</a>. The caller should free the context with krb5_rd_req_in_ctx_free() when done with the context.<p>
139ae771770SStanislav Sedov<dl compact><dt><b>Parameters:</b></dt><dd>
140ae771770SStanislav Sedov  <table border="0" cellspacing="2" cellpadding="0">
141ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>context</em>&nbsp;</td><td>Keberos 5 context. </td></tr>
142ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>ctx</em>&nbsp;</td><td>in ctx to <a class="el" href="group__krb5__auth.html#g589cab7251a70a5addbf1af56313401e">krb5_rd_req_ctx()</a>.</td></tr>
143ae771770SStanislav Sedov  </table>
144ae771770SStanislav Sedov</dl>
145ae771770SStanislav Sedov<dl class="return" compact><dt><b>Returns:</b></dt><dd>Kerberos 5 error code, see krb5_get_error_message(). </dd></dl>
146ae771770SStanislav Sedov
147ae771770SStanislav Sedov</div>
148ae771770SStanislav Sedov</div><p>
149ae771770SStanislav Sedov<a class="anchor" name="g124150b9eea8b56a9b432cf5e7a8db07"></a><!-- doxytag: member="rd_req.c::krb5_rd_req_in_set_keytab" ref="g124150b9eea8b56a9b432cf5e7a8db07" args="(krb5_context context, krb5_rd_req_in_ctx in, krb5_keytab keytab)" -->
150ae771770SStanislav Sedov<div class="memitem">
151ae771770SStanislav Sedov<div class="memproto">
152ae771770SStanislav Sedov      <table class="memname">
153ae771770SStanislav Sedov        <tr>
154ae771770SStanislav Sedov          <td class="memname">KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_rd_req_in_set_keytab           </td>
155ae771770SStanislav Sedov          <td>(</td>
156ae771770SStanislav Sedov          <td class="paramtype">krb5_context&nbsp;</td>
157ae771770SStanislav Sedov          <td class="paramname"> <em>context</em>, </td>
158ae771770SStanislav Sedov        </tr>
159ae771770SStanislav Sedov        <tr>
160ae771770SStanislav Sedov          <td class="paramkey"></td>
161ae771770SStanislav Sedov          <td></td>
162ae771770SStanislav Sedov          <td class="paramtype">krb5_rd_req_in_ctx&nbsp;</td>
163ae771770SStanislav Sedov          <td class="paramname"> <em>in</em>, </td>
164ae771770SStanislav Sedov        </tr>
165ae771770SStanislav Sedov        <tr>
166ae771770SStanislav Sedov          <td class="paramkey"></td>
167ae771770SStanislav Sedov          <td></td>
168ae771770SStanislav Sedov          <td class="paramtype">krb5_keytab&nbsp;</td>
169ae771770SStanislav Sedov          <td class="paramname"> <em>keytab</em></td><td>&nbsp;</td>
170ae771770SStanislav Sedov        </tr>
171ae771770SStanislav Sedov        <tr>
172ae771770SStanislav Sedov          <td></td>
173ae771770SStanislav Sedov          <td>)</td>
174ae771770SStanislav Sedov          <td></td><td></td><td></td>
175ae771770SStanislav Sedov        </tr>
176ae771770SStanislav Sedov      </table>
177ae771770SStanislav Sedov</div>
178ae771770SStanislav Sedov<div class="memdoc">
179ae771770SStanislav Sedov
180ae771770SStanislav Sedov<p>
181ae771770SStanislav SedovSet the keytab that <a class="el" href="group__krb5__auth.html#g589cab7251a70a5addbf1af56313401e">krb5_rd_req_ctx()</a> will use.<p>
182ae771770SStanislav Sedov<dl compact><dt><b>Parameters:</b></dt><dd>
183ae771770SStanislav Sedov  <table border="0" cellspacing="2" cellpadding="0">
184ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>context</em>&nbsp;</td><td>Keberos 5 context. </td></tr>
185ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>in</em>&nbsp;</td><td>in ctx to <a class="el" href="group__krb5__auth.html#g589cab7251a70a5addbf1af56313401e">krb5_rd_req_ctx()</a>. </td></tr>
186ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>keytab</em>&nbsp;</td><td>keytab that <a class="el" href="group__krb5__auth.html#g589cab7251a70a5addbf1af56313401e">krb5_rd_req_ctx()</a> will use, only copy the pointer, so the caller must free they keytab after krb5_rd_req_in_ctx_free() is called.</td></tr>
187ae771770SStanislav Sedov  </table>
188ae771770SStanislav Sedov</dl>
189ae771770SStanislav Sedov<dl class="return" compact><dt><b>Returns:</b></dt><dd>Kerberos 5 error code, see krb5_get_error_message(). </dd></dl>
190ae771770SStanislav Sedov
191ae771770SStanislav Sedov</div>
192ae771770SStanislav Sedov</div><p>
193ae771770SStanislav Sedov<a class="anchor" name="gdd6913bc77982a536168d9dd52df2363"></a><!-- doxytag: member="rd_req.c::krb5_rd_req_in_set_pac_check" ref="gdd6913bc77982a536168d9dd52df2363" args="(krb5_context context, krb5_rd_req_in_ctx in, krb5_boolean flag)" -->
194ae771770SStanislav Sedov<div class="memitem">
195ae771770SStanislav Sedov<div class="memproto">
196ae771770SStanislav Sedov      <table class="memname">
197ae771770SStanislav Sedov        <tr>
198ae771770SStanislav Sedov          <td class="memname">KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_rd_req_in_set_pac_check           </td>
199ae771770SStanislav Sedov          <td>(</td>
200ae771770SStanislav Sedov          <td class="paramtype">krb5_context&nbsp;</td>
201ae771770SStanislav Sedov          <td class="paramname"> <em>context</em>, </td>
202ae771770SStanislav Sedov        </tr>
203ae771770SStanislav Sedov        <tr>
204ae771770SStanislav Sedov          <td class="paramkey"></td>
205ae771770SStanislav Sedov          <td></td>
206ae771770SStanislav Sedov          <td class="paramtype">krb5_rd_req_in_ctx&nbsp;</td>
207ae771770SStanislav Sedov          <td class="paramname"> <em>in</em>, </td>
208ae771770SStanislav Sedov        </tr>
209ae771770SStanislav Sedov        <tr>
210ae771770SStanislav Sedov          <td class="paramkey"></td>
211ae771770SStanislav Sedov          <td></td>
212ae771770SStanislav Sedov          <td class="paramtype">krb5_boolean&nbsp;</td>
213ae771770SStanislav Sedov          <td class="paramname"> <em>flag</em></td><td>&nbsp;</td>
214ae771770SStanislav Sedov        </tr>
215ae771770SStanislav Sedov        <tr>
216ae771770SStanislav Sedov          <td></td>
217ae771770SStanislav Sedov          <td>)</td>
218ae771770SStanislav Sedov          <td></td><td></td><td></td>
219ae771770SStanislav Sedov        </tr>
220ae771770SStanislav Sedov      </table>
221ae771770SStanislav Sedov</div>
222ae771770SStanislav Sedov<div class="memdoc">
223ae771770SStanislav Sedov
224ae771770SStanislav Sedov<p>
225ae771770SStanislav SedovSet if krb5_rq_red() is going to check the Windows PAC or not<p>
226ae771770SStanislav Sedov<dl compact><dt><b>Parameters:</b></dt><dd>
227ae771770SStanislav Sedov  <table border="0" cellspacing="2" cellpadding="0">
228ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>context</em>&nbsp;</td><td>Keberos 5 context. </td></tr>
229ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>in</em>&nbsp;</td><td>krb5_rd_req_in_ctx to check the option on. </td></tr>
230ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>flag</em>&nbsp;</td><td>flag to select if to check the pac (TRUE) or not (FALSE).</td></tr>
231ae771770SStanislav Sedov  </table>
232ae771770SStanislav Sedov</dl>
233ae771770SStanislav Sedov<dl class="return" compact><dt><b>Returns:</b></dt><dd>Kerberos 5 error code, see krb5_get_error_message(). </dd></dl>
234ae771770SStanislav Sedov
235ae771770SStanislav Sedov</div>
236ae771770SStanislav Sedov</div><p>
237ae771770SStanislav Sedov<a class="anchor" name="gd8a5460c599500c0d64e632341c8f74a"></a><!-- doxytag: member="rd_req.c::krb5_rd_req_out_ctx_free" ref="gd8a5460c599500c0d64e632341c8f74a" args="(krb5_context context, krb5_rd_req_out_ctx ctx)" -->
238ae771770SStanislav Sedov<div class="memitem">
239ae771770SStanislav Sedov<div class="memproto">
240ae771770SStanislav Sedov      <table class="memname">
241ae771770SStanislav Sedov        <tr>
242ae771770SStanislav Sedov          <td class="memname">KRB5_LIB_FUNCTION void KRB5_LIB_CALL krb5_rd_req_out_ctx_free           </td>
243ae771770SStanislav Sedov          <td>(</td>
244ae771770SStanislav Sedov          <td class="paramtype">krb5_context&nbsp;</td>
245ae771770SStanislav Sedov          <td class="paramname"> <em>context</em>, </td>
246ae771770SStanislav Sedov        </tr>
247ae771770SStanislav Sedov        <tr>
248ae771770SStanislav Sedov          <td class="paramkey"></td>
249ae771770SStanislav Sedov          <td></td>
250ae771770SStanislav Sedov          <td class="paramtype">krb5_rd_req_out_ctx&nbsp;</td>
251ae771770SStanislav Sedov          <td class="paramname"> <em>ctx</em></td><td>&nbsp;</td>
252ae771770SStanislav Sedov        </tr>
253ae771770SStanislav Sedov        <tr>
254ae771770SStanislav Sedov          <td></td>
255ae771770SStanislav Sedov          <td>)</td>
256ae771770SStanislav Sedov          <td></td><td></td><td></td>
257ae771770SStanislav Sedov        </tr>
258ae771770SStanislav Sedov      </table>
259ae771770SStanislav Sedov</div>
260ae771770SStanislav Sedov<div class="memdoc">
261ae771770SStanislav Sedov
262ae771770SStanislav Sedov<p>
263ae771770SStanislav SedovFree the krb5_rd_req_out_ctx.<p>
264ae771770SStanislav Sedov<dl compact><dt><b>Parameters:</b></dt><dd>
265ae771770SStanislav Sedov  <table border="0" cellspacing="2" cellpadding="0">
266ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>context</em>&nbsp;</td><td>Keberos 5 context. </td></tr>
267ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>ctx</em>&nbsp;</td><td>krb5_rd_req_out_ctx context to free. </td></tr>
268ae771770SStanislav Sedov  </table>
269ae771770SStanislav Sedov</dl>
270ae771770SStanislav Sedov
271ae771770SStanislav Sedov</div>
272ae771770SStanislav Sedov</div><p>
273ae771770SStanislav Sedov<a class="anchor" name="gc1ffffee7558466d31c23b110c95aa7b"></a><!-- doxytag: member="rd_req.c::krb5_rd_req_out_get_server" ref="gc1ffffee7558466d31c23b110c95aa7b" args="(krb5_context context, krb5_rd_req_out_ctx out, krb5_principal *principal)" -->
274ae771770SStanislav Sedov<div class="memitem">
275ae771770SStanislav Sedov<div class="memproto">
276ae771770SStanislav Sedov      <table class="memname">
277ae771770SStanislav Sedov        <tr>
278ae771770SStanislav Sedov          <td class="memname">KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_rd_req_out_get_server           </td>
279ae771770SStanislav Sedov          <td>(</td>
280ae771770SStanislav Sedov          <td class="paramtype">krb5_context&nbsp;</td>
281ae771770SStanislav Sedov          <td class="paramname"> <em>context</em>, </td>
282ae771770SStanislav Sedov        </tr>
283ae771770SStanislav Sedov        <tr>
284ae771770SStanislav Sedov          <td class="paramkey"></td>
285ae771770SStanislav Sedov          <td></td>
286ae771770SStanislav Sedov          <td class="paramtype">krb5_rd_req_out_ctx&nbsp;</td>
287ae771770SStanislav Sedov          <td class="paramname"> <em>out</em>, </td>
288ae771770SStanislav Sedov        </tr>
289ae771770SStanislav Sedov        <tr>
290ae771770SStanislav Sedov          <td class="paramkey"></td>
291ae771770SStanislav Sedov          <td></td>
292ae771770SStanislav Sedov          <td class="paramtype">krb5_principal *&nbsp;</td>
293ae771770SStanislav Sedov          <td class="paramname"> <em>principal</em></td><td>&nbsp;</td>
294ae771770SStanislav Sedov        </tr>
295ae771770SStanislav Sedov        <tr>
296ae771770SStanislav Sedov          <td></td>
297ae771770SStanislav Sedov          <td>)</td>
298ae771770SStanislav Sedov          <td></td><td></td><td></td>
299ae771770SStanislav Sedov        </tr>
300ae771770SStanislav Sedov      </table>
301ae771770SStanislav Sedov</div>
302ae771770SStanislav Sedov<div class="memdoc">
303ae771770SStanislav Sedov
304ae771770SStanislav Sedov<p>
305ae771770SStanislav SedovGet the principal that was used in the request from the client. Might not match whats in the ticket if <a class="el" href="group__krb5__auth.html#g589cab7251a70a5addbf1af56313401e">krb5_rd_req_ctx()</a> searched in the keytab for a matching key.<p>
306ae771770SStanislav Sedov<dl compact><dt><b>Parameters:</b></dt><dd>
307ae771770SStanislav Sedov  <table border="0" cellspacing="2" cellpadding="0">
308ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>context</em>&nbsp;</td><td>a Kerberos 5 context. </td></tr>
309ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>out</em>&nbsp;</td><td>a krb5_rd_req_out_ctx from <a class="el" href="group__krb5__auth.html#g589cab7251a70a5addbf1af56313401e">krb5_rd_req_ctx()</a>. </td></tr>
310ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>principal</em>&nbsp;</td><td>return principal, free with <a class="el" href="group__krb5__principal.html#g5bd3f620ebe8cd4fe44b5c858ba17d22">krb5_free_principal()</a>. </td></tr>
311ae771770SStanislav Sedov  </table>
312ae771770SStanislav Sedov</dl>
313ae771770SStanislav Sedov
314ae771770SStanislav Sedov</div>
315ae771770SStanislav Sedov</div><p>
316ae771770SStanislav Sedov</div>
317ae771770SStanislav Sedov<hr size="1"><address style="text-align: right;"><small>
318*cf771f22SStanislav SedovGenerated on Wed Jan 11 14:07:50 2012 for HeimdalKerberos5library by&nbsp;<a href="http://www.doxygen.org/index.html"><img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.6</small></address>
319ae771770SStanislav Sedov</body>
320ae771770SStanislav Sedov</html>
321