xref: /freebsd-src/crypto/heimdal/doc/doxyout/gssapi/html/group__gssapi.html (revision ae77177087c655fc883075af4f425b37e032cd05)
1*ae771770SStanislav Sedov<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2*ae771770SStanislav Sedov<html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
3*ae771770SStanislav Sedov<title>HeimdalGSS-APIlibrary: Heimdal GSS-API functions</title>
4*ae771770SStanislav Sedov<link href="doxygen.css" rel="stylesheet" type="text/css">
5*ae771770SStanislav Sedov<link href="tabs.css" rel="stylesheet" type="text/css">
6*ae771770SStanislav Sedov</head><body>
7*ae771770SStanislav Sedov<p>
8*ae771770SStanislav Sedov<a href="http://www.h5l.org/"><img src="http://www.h5l.org/keyhole-heimdal.png" alt="keyhole logo"/></a>
9*ae771770SStanislav Sedov</p>
10*ae771770SStanislav Sedov<!-- end of header marker -->
11*ae771770SStanislav Sedov<!-- Generated by Doxygen 1.5.6 -->
12*ae771770SStanislav Sedov<div class="navigation" id="top">
13*ae771770SStanislav Sedov  <div class="tabs">
14*ae771770SStanislav Sedov    <ul>
15*ae771770SStanislav Sedov      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
16*ae771770SStanislav Sedov      <li><a href="pages.html"><span>Related&nbsp;Pages</span></a></li>
17*ae771770SStanislav Sedov      <li><a href="modules.html"><span>Modules</span></a></li>
18*ae771770SStanislav Sedov    </ul>
19*ae771770SStanislav Sedov  </div>
20*ae771770SStanislav Sedov</div>
21*ae771770SStanislav Sedov<div class="contents">
22*ae771770SStanislav Sedov<h1>Heimdal GSS-API functions</h1><table border="0" cellpadding="0" cellspacing="0">
23*ae771770SStanislav Sedov<tr><td></td></tr>
24*ae771770SStanislav Sedov<tr><td colspan="2"><br><h2>Functions</h2></td></tr>
25*ae771770SStanislav Sedov<tr><td class="memItemLeft" nowrap align="right" valign="top">GSSAPI_LIB_FUNCTION OM_uint32 <br>
26*ae771770SStanislav SedovGSSAPI_LIB_CALL&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__gssapi.html#g233373d4e0baa31615eb4d4f0ccb9683">gss_add_oid_set_member</a> (OM_uint32 *minor_status, const gss_OID member_oid, gss_OID_set *oid_set)</td></tr>
27*ae771770SStanislav Sedov
28*ae771770SStanislav Sedov<tr><td class="memItemLeft" nowrap align="right" valign="top">GSSAPI_LIB_FUNCTION OM_uint32 <br>
29*ae771770SStanislav SedovGSSAPI_LIB_CALL&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__gssapi.html#gb02ec963066cc8e5e6682799457208e9">gss_wrap_iov</a> (OM_uint32 *minor_status, gss_ctx_id_t context_handle, int conf_req_flag, gss_qop_t qop_req, int *conf_state, gss_iov_buffer_desc *iov, int iov_count)</td></tr>
30*ae771770SStanislav Sedov
31*ae771770SStanislav Sedov<tr><td class="memItemLeft" nowrap align="right" valign="top">GSSAPI_LIB_FUNCTION OM_uint32 <br>
32*ae771770SStanislav SedovGSSAPI_LIB_CALL&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__gssapi.html#g399bb326e47574aca7b28d6886d29fd0">gss_unwrap_iov</a> (OM_uint32 *minor_status, gss_ctx_id_t context_handle, int *conf_state, gss_qop_t *qop_state, gss_iov_buffer_desc *iov, int iov_count)</td></tr>
33*ae771770SStanislav Sedov
34*ae771770SStanislav Sedov<tr><td class="memItemLeft" nowrap align="right" valign="top">GSSAPI_LIB_FUNCTION OM_uint32 <br>
35*ae771770SStanislav SedovGSSAPI_LIB_CALL&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__gssapi.html#g6216cfcb1ba8dc2d1a1d680d21752f26">gss_wrap_iov_length</a> (OM_uint32 *minor_status, gss_ctx_id_t context_handle, int conf_req_flag, gss_qop_t qop_req, int *conf_state, gss_iov_buffer_desc *iov, int iov_count)</td></tr>
36*ae771770SStanislav Sedov
37*ae771770SStanislav Sedov<tr><td class="memItemLeft" nowrap align="right" valign="top">GSSAPI_LIB_FUNCTION OM_uint32 <br>
38*ae771770SStanislav SedovGSSAPI_LIB_CALL&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__gssapi.html#g2dbb20a4c9a3cf5072ef081cd37e54b4">gss_release_iov_buffer</a> (OM_uint32 *minor_status, gss_iov_buffer_desc *iov, int iov_count)</td></tr>
39*ae771770SStanislav Sedov
40*ae771770SStanislav Sedov<tr><td class="memItemLeft" nowrap align="right" valign="top">GSSAPI_LIB_FUNCTION OM_uint32 <br>
41*ae771770SStanislav SedovGSSAPI_LIB_CALL&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__gssapi.html#g06e9814b830ed2fc4a756775a5bfd943">gss_canonicalize_name</a> (OM_uint32 *minor_status, const gss_name_t input_name, const gss_OID mech_type, gss_name_t *output_name)</td></tr>
42*ae771770SStanislav Sedov
43*ae771770SStanislav Sedov<tr><td class="memItemLeft" nowrap align="right" valign="top">GSSAPI_LIB_FUNCTION OM_uint32 <br>
44*ae771770SStanislav SedovGSSAPI_LIB_CALL&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__gssapi.html#g0afe06fd5264ebfb93ecca4bcc70895b">gss_import_name</a> (OM_uint32 *minor_status, const gss_buffer_t input_name_buffer, const gss_OID input_name_type, gss_name_t *output_name)</td></tr>
45*ae771770SStanislav Sedov
46*ae771770SStanislav Sedov<tr><td class="memItemLeft" nowrap align="right" valign="top">GSSAPI_LIB_FUNCTION OM_uint32 <br>
47*ae771770SStanislav SedovGSSAPI_LIB_CALL&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__gssapi.html#g8eb94eab14874226b748710f833474eb">gss_init_sec_context</a> (OM_uint32 *minor_status, const gss_cred_id_t initiator_cred_handle, gss_ctx_id_t *context_handle, const gss_name_t target_name, const gss_OID input_mech_type, OM_uint32 req_flags, OM_uint32 time_req, const gss_channel_bindings_t input_chan_bindings, const gss_buffer_t input_token, gss_OID *actual_mech_type, gss_buffer_t output_token, OM_uint32 *ret_flags, OM_uint32 *time_rec)</td></tr>
48*ae771770SStanislav Sedov
49*ae771770SStanislav Sedov<tr><td class="memItemLeft" nowrap align="right" valign="top">GSSAPI_LIB_FUNCTION OM_uint32 <br>
50*ae771770SStanislav SedovGSSAPI_LIB_CALL&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__gssapi.html#gdc725eaf82322d8cf50812fc26442893">gss_inquire_saslname_for_mech</a> (OM_uint32 *minor_status, const gss_OID desired_mech, gss_buffer_t sasl_mech_name, gss_buffer_t mech_name, gss_buffer_t mech_description)</td></tr>
51*ae771770SStanislav Sedov
52*ae771770SStanislav Sedov<tr><td class="memItemLeft" nowrap align="right" valign="top">GSSAPI_LIB_FUNCTION OM_uint32 <br>
53*ae771770SStanislav SedovGSSAPI_LIB_CALL&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__gssapi.html#gf472671a43512495de04ca0c69079e5d">gss_inquire_attrs_for_mech</a> (OM_uint32 *minor_status, gss_const_OID mech, gss_OID_set *mech_attr, gss_OID_set *known_mech_attrs)</td></tr>
54*ae771770SStanislav Sedov
55*ae771770SStanislav Sedov<tr><td class="memItemLeft" nowrap align="right" valign="top">GSSAPI_LIB_FUNCTION int <br>
56*ae771770SStanislav SedovGSSAPI_LIB_CALL&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__gssapi.html#gc98677df7ae9bbc387cd68002a97ad15">gss_oid_equal</a> (gss_const_OID a, gss_const_OID b)</td></tr>
57*ae771770SStanislav Sedov
58*ae771770SStanislav Sedov<tr><td class="memItemLeft" nowrap align="right" valign="top">GSSAPI_LIB_FUNCTION OM_uint32 <br>
59*ae771770SStanislav SedovGSSAPI_LIB_CALL&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__gssapi.html#gd2990721c56fe83e06d45648874680d7">gss_release_cred</a> (OM_uint32 *minor_status, gss_cred_id_t *cred_handle)</td></tr>
60*ae771770SStanislav Sedov
61*ae771770SStanislav Sedov<tr><td class="memItemLeft" nowrap align="right" valign="top">GSSAPI_LIB_FUNCTION OM_uint32 <br>
62*ae771770SStanislav SedovGSSAPI_LIB_CALL&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__gssapi.html#g0691190338f1f24170bd5f695ff1e721">gss_release_name</a> (OM_uint32 *minor_status, gss_name_t *input_name)</td></tr>
63*ae771770SStanislav Sedov
64*ae771770SStanislav Sedov<tr><td class="memItemLeft" nowrap align="right" valign="top">GSSAPI_LIB_FUNCTION OM_uint32 <br>
65*ae771770SStanislav SedovGSSAPI_LIB_CALL&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__gssapi.html#g89a6d98056b75a8a25152de268833f51">gss_wrap</a> (OM_uint32 *minor_status, const gss_ctx_id_t context_handle, int conf_req_flag, gss_qop_t qop_req, const gss_buffer_t input_message_buffer, int *conf_state, gss_buffer_t output_message_buffer)</td></tr>
66*ae771770SStanislav Sedov
67*ae771770SStanislav Sedov<tr><td colspan="2"><br><h2>Variables</h2></td></tr>
68*ae771770SStanislav Sedov<tr><td class="memItemLeft" nowrap align="right" valign="top">gss_OID_desc GSSAPI_LIB_FUNCTION&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__gssapi.html#g961f7a7f9f92e06b91c6d503e524a672">__gss_c_attr_stream_sizes_oid_desc</a></td></tr>
69*ae771770SStanislav Sedov
70*ae771770SStanislav Sedov</table>
71*ae771770SStanislav Sedov<hr><a name="_details"></a><h2>Detailed Description</h2>
72*ae771770SStanislav Sedov<hr><h2>Function Documentation</h2>
73*ae771770SStanislav Sedov<a class="anchor" name="g233373d4e0baa31615eb4d4f0ccb9683"></a><!-- doxytag: member="gss_add_oid_set_member.c::gss_add_oid_set_member" ref="g233373d4e0baa31615eb4d4f0ccb9683" args="(OM_uint32 *minor_status, const gss_OID member_oid, gss_OID_set *oid_set)" -->
74*ae771770SStanislav Sedov<div class="memitem">
75*ae771770SStanislav Sedov<div class="memproto">
76*ae771770SStanislav Sedov      <table class="memname">
77*ae771770SStanislav Sedov        <tr>
78*ae771770SStanislav Sedov          <td class="memname">GSSAPI_LIB_FUNCTION OM_uint32 GSSAPI_LIB_CALL gss_add_oid_set_member           </td>
79*ae771770SStanislav Sedov          <td>(</td>
80*ae771770SStanislav Sedov          <td class="paramtype">OM_uint32 *&nbsp;</td>
81*ae771770SStanislav Sedov          <td class="paramname"> <em>minor_status</em>, </td>
82*ae771770SStanislav Sedov        </tr>
83*ae771770SStanislav Sedov        <tr>
84*ae771770SStanislav Sedov          <td class="paramkey"></td>
85*ae771770SStanislav Sedov          <td></td>
86*ae771770SStanislav Sedov          <td class="paramtype">const gss_OID&nbsp;</td>
87*ae771770SStanislav Sedov          <td class="paramname"> <em>member_oid</em>, </td>
88*ae771770SStanislav Sedov        </tr>
89*ae771770SStanislav Sedov        <tr>
90*ae771770SStanislav Sedov          <td class="paramkey"></td>
91*ae771770SStanislav Sedov          <td></td>
92*ae771770SStanislav Sedov          <td class="paramtype">gss_OID_set *&nbsp;</td>
93*ae771770SStanislav Sedov          <td class="paramname"> <em>oid_set</em></td><td>&nbsp;</td>
94*ae771770SStanislav Sedov        </tr>
95*ae771770SStanislav Sedov        <tr>
96*ae771770SStanislav Sedov          <td></td>
97*ae771770SStanislav Sedov          <td>)</td>
98*ae771770SStanislav Sedov          <td></td><td></td><td></td>
99*ae771770SStanislav Sedov        </tr>
100*ae771770SStanislav Sedov      </table>
101*ae771770SStanislav Sedov</div>
102*ae771770SStanislav Sedov<div class="memdoc">
103*ae771770SStanislav Sedov
104*ae771770SStanislav Sedov<p>
105*ae771770SStanislav SedovAdd a oid to the oid set, function does not make a copy of the oid, so the pointer to member_oid needs to be stable for the whole time oid_set is used.<p>
106*ae771770SStanislav SedovIf there is a duplicate member of the oid, the new member is not added to to the set.<p>
107*ae771770SStanislav Sedov<dl compact><dt><b>Parameters:</b></dt><dd>
108*ae771770SStanislav Sedov  <table border="0" cellspacing="2" cellpadding="0">
109*ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>minor_status</em>&nbsp;</td><td>minor status code. </td></tr>
110*ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>member_oid</em>&nbsp;</td><td>member to add to the oid set </td></tr>
111*ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>oid_set</em>&nbsp;</td><td>oid set to add the member too</td></tr>
112*ae771770SStanislav Sedov  </table>
113*ae771770SStanislav Sedov</dl>
114*ae771770SStanislav Sedov<dl class="return" compact><dt><b>Returns:</b></dt><dd>a gss_error code, see gss_display_status() about printing the error code. </dd></dl>
115*ae771770SStanislav Sedov
116*ae771770SStanislav Sedov</div>
117*ae771770SStanislav Sedov</div><p>
118*ae771770SStanislav Sedov<a class="anchor" name="g06e9814b830ed2fc4a756775a5bfd943"></a><!-- doxytag: member="gss_canonicalize_name.c::gss_canonicalize_name" ref="g06e9814b830ed2fc4a756775a5bfd943" args="(OM_uint32 *minor_status, const gss_name_t input_name, const gss_OID mech_type, gss_name_t *output_name)" -->
119*ae771770SStanislav Sedov<div class="memitem">
120*ae771770SStanislav Sedov<div class="memproto">
121*ae771770SStanislav Sedov      <table class="memname">
122*ae771770SStanislav Sedov        <tr>
123*ae771770SStanislav Sedov          <td class="memname">GSSAPI_LIB_FUNCTION OM_uint32 GSSAPI_LIB_CALL gss_canonicalize_name           </td>
124*ae771770SStanislav Sedov          <td>(</td>
125*ae771770SStanislav Sedov          <td class="paramtype">OM_uint32 *&nbsp;</td>
126*ae771770SStanislav Sedov          <td class="paramname"> <em>minor_status</em>, </td>
127*ae771770SStanislav Sedov        </tr>
128*ae771770SStanislav Sedov        <tr>
129*ae771770SStanislav Sedov          <td class="paramkey"></td>
130*ae771770SStanislav Sedov          <td></td>
131*ae771770SStanislav Sedov          <td class="paramtype">const gss_name_t&nbsp;</td>
132*ae771770SStanislav Sedov          <td class="paramname"> <em>input_name</em>, </td>
133*ae771770SStanislav Sedov        </tr>
134*ae771770SStanislav Sedov        <tr>
135*ae771770SStanislav Sedov          <td class="paramkey"></td>
136*ae771770SStanislav Sedov          <td></td>
137*ae771770SStanislav Sedov          <td class="paramtype">const gss_OID&nbsp;</td>
138*ae771770SStanislav Sedov          <td class="paramname"> <em>mech_type</em>, </td>
139*ae771770SStanislav Sedov        </tr>
140*ae771770SStanislav Sedov        <tr>
141*ae771770SStanislav Sedov          <td class="paramkey"></td>
142*ae771770SStanislav Sedov          <td></td>
143*ae771770SStanislav Sedov          <td class="paramtype">gss_name_t *&nbsp;</td>
144*ae771770SStanislav Sedov          <td class="paramname"> <em>output_name</em></td><td>&nbsp;</td>
145*ae771770SStanislav Sedov        </tr>
146*ae771770SStanislav Sedov        <tr>
147*ae771770SStanislav Sedov          <td></td>
148*ae771770SStanislav Sedov          <td>)</td>
149*ae771770SStanislav Sedov          <td></td><td></td><td></td>
150*ae771770SStanislav Sedov        </tr>
151*ae771770SStanislav Sedov      </table>
152*ae771770SStanislav Sedov</div>
153*ae771770SStanislav Sedov<div class="memdoc">
154*ae771770SStanislav Sedov
155*ae771770SStanislav Sedov<p>
156*ae771770SStanislav Sedovgss_canonicalize_name takes a Internal Name (IN) and converts in into a mechanism specific Mechanism Name (MN).<p>
157*ae771770SStanislav SedovThe input name may multiple name, or generic name types.<p>
158*ae771770SStanislav SedovIf the input_name if of the GSS_C_NT_USER_NAME, and the Kerberos mechanism is specified, the resulting MN type is a GSS_KRB5_NT_PRINCIPAL_NAME.<p>
159*ae771770SStanislav SedovFor more information about <a class="el" href="internalvsmechname.html">internalVSmechname</a>.<p>
160*ae771770SStanislav Sedov<dl compact><dt><b>Parameters:</b></dt><dd>
161*ae771770SStanislav Sedov  <table border="0" cellspacing="2" cellpadding="0">
162*ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>minor_status</em>&nbsp;</td><td>minor status code. </td></tr>
163*ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>input_name</em>&nbsp;</td><td>name to covert, unchanged by <a class="el" href="group__gssapi.html#g06e9814b830ed2fc4a756775a5bfd943">gss_canonicalize_name()</a>. </td></tr>
164*ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>mech_type</em>&nbsp;</td><td>the type to convert Name too. </td></tr>
165*ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>output_name</em>&nbsp;</td><td>the resulting type, release with <a class="el" href="group__gssapi.html#g0691190338f1f24170bd5f695ff1e721">gss_release_name()</a>, independent of input_name.</td></tr>
166*ae771770SStanislav Sedov  </table>
167*ae771770SStanislav Sedov</dl>
168*ae771770SStanislav Sedov<dl class="return" compact><dt><b>Returns:</b></dt><dd>a gss_error code, see gss_display_status() about printing the error code. </dd></dl>
169*ae771770SStanislav Sedov
170*ae771770SStanislav Sedov</div>
171*ae771770SStanislav Sedov</div><p>
172*ae771770SStanislav Sedov<a class="anchor" name="g0afe06fd5264ebfb93ecca4bcc70895b"></a><!-- doxytag: member="gss_import_name.c::gss_import_name" ref="g0afe06fd5264ebfb93ecca4bcc70895b" args="(OM_uint32 *minor_status, const gss_buffer_t input_name_buffer, const gss_OID input_name_type, gss_name_t *output_name)" -->
173*ae771770SStanislav Sedov<div class="memitem">
174*ae771770SStanislav Sedov<div class="memproto">
175*ae771770SStanislav Sedov      <table class="memname">
176*ae771770SStanislav Sedov        <tr>
177*ae771770SStanislav Sedov          <td class="memname">GSSAPI_LIB_FUNCTION OM_uint32 GSSAPI_LIB_CALL gss_import_name           </td>
178*ae771770SStanislav Sedov          <td>(</td>
179*ae771770SStanislav Sedov          <td class="paramtype">OM_uint32 *&nbsp;</td>
180*ae771770SStanislav Sedov          <td class="paramname"> <em>minor_status</em>, </td>
181*ae771770SStanislav Sedov        </tr>
182*ae771770SStanislav Sedov        <tr>
183*ae771770SStanislav Sedov          <td class="paramkey"></td>
184*ae771770SStanislav Sedov          <td></td>
185*ae771770SStanislav Sedov          <td class="paramtype">const gss_buffer_t&nbsp;</td>
186*ae771770SStanislav Sedov          <td class="paramname"> <em>input_name_buffer</em>, </td>
187*ae771770SStanislav Sedov        </tr>
188*ae771770SStanislav Sedov        <tr>
189*ae771770SStanislav Sedov          <td class="paramkey"></td>
190*ae771770SStanislav Sedov          <td></td>
191*ae771770SStanislav Sedov          <td class="paramtype">const gss_OID&nbsp;</td>
192*ae771770SStanislav Sedov          <td class="paramname"> <em>input_name_type</em>, </td>
193*ae771770SStanislav Sedov        </tr>
194*ae771770SStanislav Sedov        <tr>
195*ae771770SStanislav Sedov          <td class="paramkey"></td>
196*ae771770SStanislav Sedov          <td></td>
197*ae771770SStanislav Sedov          <td class="paramtype">gss_name_t *&nbsp;</td>
198*ae771770SStanislav Sedov          <td class="paramname"> <em>output_name</em></td><td>&nbsp;</td>
199*ae771770SStanislav Sedov        </tr>
200*ae771770SStanislav Sedov        <tr>
201*ae771770SStanislav Sedov          <td></td>
202*ae771770SStanislav Sedov          <td>)</td>
203*ae771770SStanislav Sedov          <td></td><td></td><td></td>
204*ae771770SStanislav Sedov        </tr>
205*ae771770SStanislav Sedov      </table>
206*ae771770SStanislav Sedov</div>
207*ae771770SStanislav Sedov<div class="memdoc">
208*ae771770SStanislav Sedov
209*ae771770SStanislav Sedov<p>
210*ae771770SStanislav SedovImport a name internal or mechanism name<p>
211*ae771770SStanislav SedovType of name and their format:<ul>
212*ae771770SStanislav Sedov<li>GSS_C_NO_OID</li><li>GSS_C_NT_USER_NAME</li><li>GSS_C_NT_HOSTBASED_SERVICE</li><li>GSS_C_NT_EXPORT_NAME</li><li>GSS_C_NT_ANONYMOUS</li><li>GSS_KRB5_NT_PRINCIPAL_NAME</li></ul>
213*ae771770SStanislav Sedov<p>
214*ae771770SStanislav SedovFor more information about <a class="el" href="internalvsmechname.html">internalVSmechname</a>.<p>
215*ae771770SStanislav Sedov<dl compact><dt><b>Parameters:</b></dt><dd>
216*ae771770SStanislav Sedov  <table border="0" cellspacing="2" cellpadding="0">
217*ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>minor_status</em>&nbsp;</td><td>minor status code </td></tr>
218*ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>input_name_buffer</em>&nbsp;</td><td>import name buffer </td></tr>
219*ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>input_name_type</em>&nbsp;</td><td>type of the import name buffer </td></tr>
220*ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>output_name</em>&nbsp;</td><td>the resulting type, release with <a class="el" href="group__gssapi.html#g0691190338f1f24170bd5f695ff1e721">gss_release_name()</a>, independent of input_name</td></tr>
221*ae771770SStanislav Sedov  </table>
222*ae771770SStanislav Sedov</dl>
223*ae771770SStanislav Sedov<dl class="return" compact><dt><b>Returns:</b></dt><dd>a gss_error code, see gss_display_status() about printing the error code. </dd></dl>
224*ae771770SStanislav Sedov
225*ae771770SStanislav Sedov</div>
226*ae771770SStanislav Sedov</div><p>
227*ae771770SStanislav Sedov<a class="anchor" name="g8eb94eab14874226b748710f833474eb"></a><!-- doxytag: member="gss_init_sec_context.c::gss_init_sec_context" ref="g8eb94eab14874226b748710f833474eb" args="(OM_uint32 *minor_status, const gss_cred_id_t initiator_cred_handle, gss_ctx_id_t *context_handle, const gss_name_t target_name, const gss_OID input_mech_type, OM_uint32 req_flags, OM_uint32 time_req, const gss_channel_bindings_t input_chan_bindings, const gss_buffer_t input_token, gss_OID *actual_mech_type, gss_buffer_t output_token, OM_uint32 *ret_flags, OM_uint32 *time_rec)" -->
228*ae771770SStanislav Sedov<div class="memitem">
229*ae771770SStanislav Sedov<div class="memproto">
230*ae771770SStanislav Sedov      <table class="memname">
231*ae771770SStanislav Sedov        <tr>
232*ae771770SStanislav Sedov          <td class="memname">GSSAPI_LIB_FUNCTION OM_uint32 GSSAPI_LIB_CALL gss_init_sec_context           </td>
233*ae771770SStanislav Sedov          <td>(</td>
234*ae771770SStanislav Sedov          <td class="paramtype">OM_uint32 *&nbsp;</td>
235*ae771770SStanislav Sedov          <td class="paramname"> <em>minor_status</em>, </td>
236*ae771770SStanislav Sedov        </tr>
237*ae771770SStanislav Sedov        <tr>
238*ae771770SStanislav Sedov          <td class="paramkey"></td>
239*ae771770SStanislav Sedov          <td></td>
240*ae771770SStanislav Sedov          <td class="paramtype">const gss_cred_id_t&nbsp;</td>
241*ae771770SStanislav Sedov          <td class="paramname"> <em>initiator_cred_handle</em>, </td>
242*ae771770SStanislav Sedov        </tr>
243*ae771770SStanislav Sedov        <tr>
244*ae771770SStanislav Sedov          <td class="paramkey"></td>
245*ae771770SStanislav Sedov          <td></td>
246*ae771770SStanislav Sedov          <td class="paramtype">gss_ctx_id_t *&nbsp;</td>
247*ae771770SStanislav Sedov          <td class="paramname"> <em>context_handle</em>, </td>
248*ae771770SStanislav Sedov        </tr>
249*ae771770SStanislav Sedov        <tr>
250*ae771770SStanislav Sedov          <td class="paramkey"></td>
251*ae771770SStanislav Sedov          <td></td>
252*ae771770SStanislav Sedov          <td class="paramtype">const gss_name_t&nbsp;</td>
253*ae771770SStanislav Sedov          <td class="paramname"> <em>target_name</em>, </td>
254*ae771770SStanislav Sedov        </tr>
255*ae771770SStanislav Sedov        <tr>
256*ae771770SStanislav Sedov          <td class="paramkey"></td>
257*ae771770SStanislav Sedov          <td></td>
258*ae771770SStanislav Sedov          <td class="paramtype">const gss_OID&nbsp;</td>
259*ae771770SStanislav Sedov          <td class="paramname"> <em>input_mech_type</em>, </td>
260*ae771770SStanislav Sedov        </tr>
261*ae771770SStanislav Sedov        <tr>
262*ae771770SStanislav Sedov          <td class="paramkey"></td>
263*ae771770SStanislav Sedov          <td></td>
264*ae771770SStanislav Sedov          <td class="paramtype">OM_uint32&nbsp;</td>
265*ae771770SStanislav Sedov          <td class="paramname"> <em>req_flags</em>, </td>
266*ae771770SStanislav Sedov        </tr>
267*ae771770SStanislav Sedov        <tr>
268*ae771770SStanislav Sedov          <td class="paramkey"></td>
269*ae771770SStanislav Sedov          <td></td>
270*ae771770SStanislav Sedov          <td class="paramtype">OM_uint32&nbsp;</td>
271*ae771770SStanislav Sedov          <td class="paramname"> <em>time_req</em>, </td>
272*ae771770SStanislav Sedov        </tr>
273*ae771770SStanislav Sedov        <tr>
274*ae771770SStanislav Sedov          <td class="paramkey"></td>
275*ae771770SStanislav Sedov          <td></td>
276*ae771770SStanislav Sedov          <td class="paramtype">const gss_channel_bindings_t&nbsp;</td>
277*ae771770SStanislav Sedov          <td class="paramname"> <em>input_chan_bindings</em>, </td>
278*ae771770SStanislav Sedov        </tr>
279*ae771770SStanislav Sedov        <tr>
280*ae771770SStanislav Sedov          <td class="paramkey"></td>
281*ae771770SStanislav Sedov          <td></td>
282*ae771770SStanislav Sedov          <td class="paramtype">const gss_buffer_t&nbsp;</td>
283*ae771770SStanislav Sedov          <td class="paramname"> <em>input_token</em>, </td>
284*ae771770SStanislav Sedov        </tr>
285*ae771770SStanislav Sedov        <tr>
286*ae771770SStanislav Sedov          <td class="paramkey"></td>
287*ae771770SStanislav Sedov          <td></td>
288*ae771770SStanislav Sedov          <td class="paramtype">gss_OID *&nbsp;</td>
289*ae771770SStanislav Sedov          <td class="paramname"> <em>actual_mech_type</em>, </td>
290*ae771770SStanislav Sedov        </tr>
291*ae771770SStanislav Sedov        <tr>
292*ae771770SStanislav Sedov          <td class="paramkey"></td>
293*ae771770SStanislav Sedov          <td></td>
294*ae771770SStanislav Sedov          <td class="paramtype">gss_buffer_t&nbsp;</td>
295*ae771770SStanislav Sedov          <td class="paramname"> <em>output_token</em>, </td>
296*ae771770SStanislav Sedov        </tr>
297*ae771770SStanislav Sedov        <tr>
298*ae771770SStanislav Sedov          <td class="paramkey"></td>
299*ae771770SStanislav Sedov          <td></td>
300*ae771770SStanislav Sedov          <td class="paramtype">OM_uint32 *&nbsp;</td>
301*ae771770SStanislav Sedov          <td class="paramname"> <em>ret_flags</em>, </td>
302*ae771770SStanislav Sedov        </tr>
303*ae771770SStanislav Sedov        <tr>
304*ae771770SStanislav Sedov          <td class="paramkey"></td>
305*ae771770SStanislav Sedov          <td></td>
306*ae771770SStanislav Sedov          <td class="paramtype">OM_uint32 *&nbsp;</td>
307*ae771770SStanislav Sedov          <td class="paramname"> <em>time_rec</em></td><td>&nbsp;</td>
308*ae771770SStanislav Sedov        </tr>
309*ae771770SStanislav Sedov        <tr>
310*ae771770SStanislav Sedov          <td></td>
311*ae771770SStanislav Sedov          <td>)</td>
312*ae771770SStanislav Sedov          <td></td><td></td><td></td>
313*ae771770SStanislav Sedov        </tr>
314*ae771770SStanislav Sedov      </table>
315*ae771770SStanislav Sedov</div>
316*ae771770SStanislav Sedov<div class="memdoc">
317*ae771770SStanislav Sedov
318*ae771770SStanislav Sedov<p>
319*ae771770SStanislav SedovAs the initiator build a context with an acceptor.<p>
320*ae771770SStanislav SedovReturns in the major<ul>
321*ae771770SStanislav Sedov<li>GSS_S_COMPLETE - if the context if build</li><li>GSS_S_CONTINUE_NEEDED - if the caller needs to continue another round of gss_i nit_sec_context</li><li>error code - any other error code</li></ul>
322*ae771770SStanislav Sedov<p>
323*ae771770SStanislav Sedov<dl compact><dt><b>Parameters:</b></dt><dd>
324*ae771770SStanislav Sedov  <table border="0" cellspacing="2" cellpadding="0">
325*ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>minor_status</em>&nbsp;</td><td>minor status code.</td></tr>
326*ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>initiator_cred_handle</em>&nbsp;</td><td>the credential to use when building the context, if GSS_C_NO_CREDENTIAL is passed, the default credential for the mechanism will be used.</td></tr>
327*ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>context_handle</em>&nbsp;</td><td>a pointer to a context handle, will be returned as long as there is not an error.</td></tr>
328*ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>target_name</em>&nbsp;</td><td>the target name of acceptor, created using <a class="el" href="group__gssapi.html#g0afe06fd5264ebfb93ecca4bcc70895b">gss_import_name()</a>. The name is can be of any name types the mechanism supports, check supported name types with gss_inquire_names_for_mech().</td></tr>
329*ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>input_mech_type</em>&nbsp;</td><td>mechanism type to use, if GSS_C_NO_OID is used, Kerberos (GSS_KRB5_MECHANISM) will be tried. Other available mechanism are listed in the <a class="el" href="gssapi_mechs_intro.html">GSS-API mechanisms</a> section.</td></tr>
330*ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>req_flags</em>&nbsp;</td><td>flags using when building the context, see <a class="el" href="gssapi_services_intro.html#gssapi_context_flags">Context creation flags</a></td></tr>
331*ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>time_req</em>&nbsp;</td><td>time requested this context should be valid in seconds, common used value is GSS_C_INDEFINITE</td></tr>
332*ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>input_chan_bindings</em>&nbsp;</td><td>Channel bindings used, if not exepected otherwise, used GSS_C_NO_CHANNEL_BINDINGS</td></tr>
333*ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>input_token</em>&nbsp;</td><td>input token sent from the acceptor, for the initial packet the buffer of { NULL, 0 } should be used.</td></tr>
334*ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>actual_mech_type</em>&nbsp;</td><td>the actual mech used, MUST NOT be freed since it pointing to static memory.</td></tr>
335*ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>output_token</em>&nbsp;</td><td>if there is an output token, regardless of complete, continue_needed, or error it should be sent to the acceptor</td></tr>
336*ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>ret_flags</em>&nbsp;</td><td>return what flags was negotitated, caller should check if they are accetable. For example, if GSS_C_MUTUAL_FLAG was negotiated with the acceptor or not.</td></tr>
337*ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>time_rec</em>&nbsp;</td><td>amount of time this context is valid for</td></tr>
338*ae771770SStanislav Sedov  </table>
339*ae771770SStanislav Sedov</dl>
340*ae771770SStanislav Sedov<dl class="return" compact><dt><b>Returns:</b></dt><dd>a gss_error code, see gss_display_status() about printing the error code. </dd></dl>
341*ae771770SStanislav Sedov
342*ae771770SStanislav Sedov</div>
343*ae771770SStanislav Sedov</div><p>
344*ae771770SStanislav Sedov<a class="anchor" name="gf472671a43512495de04ca0c69079e5d"></a><!-- doxytag: member="gss_mo.c::gss_inquire_attrs_for_mech" ref="gf472671a43512495de04ca0c69079e5d" args="(OM_uint32 *minor_status, gss_const_OID mech, gss_OID_set *mech_attr, gss_OID_set *known_mech_attrs)" -->
345*ae771770SStanislav Sedov<div class="memitem">
346*ae771770SStanislav Sedov<div class="memproto">
347*ae771770SStanislav Sedov      <table class="memname">
348*ae771770SStanislav Sedov        <tr>
349*ae771770SStanislav Sedov          <td class="memname">GSSAPI_LIB_FUNCTION OM_uint32 GSSAPI_LIB_CALL gss_inquire_attrs_for_mech           </td>
350*ae771770SStanislav Sedov          <td>(</td>
351*ae771770SStanislav Sedov          <td class="paramtype">OM_uint32 *&nbsp;</td>
352*ae771770SStanislav Sedov          <td class="paramname"> <em>minor_status</em>, </td>
353*ae771770SStanislav Sedov        </tr>
354*ae771770SStanislav Sedov        <tr>
355*ae771770SStanislav Sedov          <td class="paramkey"></td>
356*ae771770SStanislav Sedov          <td></td>
357*ae771770SStanislav Sedov          <td class="paramtype">gss_const_OID&nbsp;</td>
358*ae771770SStanislav Sedov          <td class="paramname"> <em>mech</em>, </td>
359*ae771770SStanislav Sedov        </tr>
360*ae771770SStanislav Sedov        <tr>
361*ae771770SStanislav Sedov          <td class="paramkey"></td>
362*ae771770SStanislav Sedov          <td></td>
363*ae771770SStanislav Sedov          <td class="paramtype">gss_OID_set *&nbsp;</td>
364*ae771770SStanislav Sedov          <td class="paramname"> <em>mech_attr</em>, </td>
365*ae771770SStanislav Sedov        </tr>
366*ae771770SStanislav Sedov        <tr>
367*ae771770SStanislav Sedov          <td class="paramkey"></td>
368*ae771770SStanislav Sedov          <td></td>
369*ae771770SStanislav Sedov          <td class="paramtype">gss_OID_set *&nbsp;</td>
370*ae771770SStanislav Sedov          <td class="paramname"> <em>known_mech_attrs</em></td><td>&nbsp;</td>
371*ae771770SStanislav Sedov        </tr>
372*ae771770SStanislav Sedov        <tr>
373*ae771770SStanislav Sedov          <td></td>
374*ae771770SStanislav Sedov          <td>)</td>
375*ae771770SStanislav Sedov          <td></td><td></td><td></td>
376*ae771770SStanislav Sedov        </tr>
377*ae771770SStanislav Sedov      </table>
378*ae771770SStanislav Sedov</div>
379*ae771770SStanislav Sedov<div class="memdoc">
380*ae771770SStanislav Sedov
381*ae771770SStanislav Sedov<p>
382*ae771770SStanislav SedovList support attributes for a mech and/or all mechanisms.<p>
383*ae771770SStanislav Sedov<dl compact><dt><b>Parameters:</b></dt><dd>
384*ae771770SStanislav Sedov  <table border="0" cellspacing="2" cellpadding="0">
385*ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>minor_status</em>&nbsp;</td><td>minor status code </td></tr>
386*ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>mech</em>&nbsp;</td><td>given together with mech_attr will return the list of attributes for mechanism, can optionally be GSS_C_NO_OID. </td></tr>
387*ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>mech_attr</em>&nbsp;</td><td>see mech parameter, can optionally be NULL, release with gss_release_oid_set(). </td></tr>
388*ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>known_mech_attrs</em>&nbsp;</td><td>all attributes for mechanisms supported, release with gss_release_oid_set(). </td></tr>
389*ae771770SStanislav Sedov  </table>
390*ae771770SStanislav Sedov</dl>
391*ae771770SStanislav Sedov
392*ae771770SStanislav Sedov</div>
393*ae771770SStanislav Sedov</div><p>
394*ae771770SStanislav Sedov<a class="anchor" name="gdc725eaf82322d8cf50812fc26442893"></a><!-- doxytag: member="gss_mo.c::gss_inquire_saslname_for_mech" ref="gdc725eaf82322d8cf50812fc26442893" args="(OM_uint32 *minor_status, const gss_OID desired_mech, gss_buffer_t sasl_mech_name, gss_buffer_t mech_name, gss_buffer_t mech_description)" -->
395*ae771770SStanislav Sedov<div class="memitem">
396*ae771770SStanislav Sedov<div class="memproto">
397*ae771770SStanislav Sedov      <table class="memname">
398*ae771770SStanislav Sedov        <tr>
399*ae771770SStanislav Sedov          <td class="memname">GSSAPI_LIB_FUNCTION OM_uint32 GSSAPI_LIB_CALL gss_inquire_saslname_for_mech           </td>
400*ae771770SStanislav Sedov          <td>(</td>
401*ae771770SStanislav Sedov          <td class="paramtype">OM_uint32 *&nbsp;</td>
402*ae771770SStanislav Sedov          <td class="paramname"> <em>minor_status</em>, </td>
403*ae771770SStanislav Sedov        </tr>
404*ae771770SStanislav Sedov        <tr>
405*ae771770SStanislav Sedov          <td class="paramkey"></td>
406*ae771770SStanislav Sedov          <td></td>
407*ae771770SStanislav Sedov          <td class="paramtype">const gss_OID&nbsp;</td>
408*ae771770SStanislav Sedov          <td class="paramname"> <em>desired_mech</em>, </td>
409*ae771770SStanislav Sedov        </tr>
410*ae771770SStanislav Sedov        <tr>
411*ae771770SStanislav Sedov          <td class="paramkey"></td>
412*ae771770SStanislav Sedov          <td></td>
413*ae771770SStanislav Sedov          <td class="paramtype">gss_buffer_t&nbsp;</td>
414*ae771770SStanislav Sedov          <td class="paramname"> <em>sasl_mech_name</em>, </td>
415*ae771770SStanislav Sedov        </tr>
416*ae771770SStanislav Sedov        <tr>
417*ae771770SStanislav Sedov          <td class="paramkey"></td>
418*ae771770SStanislav Sedov          <td></td>
419*ae771770SStanislav Sedov          <td class="paramtype">gss_buffer_t&nbsp;</td>
420*ae771770SStanislav Sedov          <td class="paramname"> <em>mech_name</em>, </td>
421*ae771770SStanislav Sedov        </tr>
422*ae771770SStanislav Sedov        <tr>
423*ae771770SStanislav Sedov          <td class="paramkey"></td>
424*ae771770SStanislav Sedov          <td></td>
425*ae771770SStanislav Sedov          <td class="paramtype">gss_buffer_t&nbsp;</td>
426*ae771770SStanislav Sedov          <td class="paramname"> <em>mech_description</em></td><td>&nbsp;</td>
427*ae771770SStanislav Sedov        </tr>
428*ae771770SStanislav Sedov        <tr>
429*ae771770SStanislav Sedov          <td></td>
430*ae771770SStanislav Sedov          <td>)</td>
431*ae771770SStanislav Sedov          <td></td><td></td><td></td>
432*ae771770SStanislav Sedov        </tr>
433*ae771770SStanislav Sedov      </table>
434*ae771770SStanislav Sedov</div>
435*ae771770SStanislav Sedov<div class="memdoc">
436*ae771770SStanislav Sedov
437*ae771770SStanislav Sedov<p>
438*ae771770SStanislav SedovReturns different protocol names and description of the mechanism.<p>
439*ae771770SStanislav Sedov<dl compact><dt><b>Parameters:</b></dt><dd>
440*ae771770SStanislav Sedov  <table border="0" cellspacing="2" cellpadding="0">
441*ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>minor_status</em>&nbsp;</td><td>minor status code </td></tr>
442*ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>desired_mech</em>&nbsp;</td><td>mech list query </td></tr>
443*ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>sasl_mech_name</em>&nbsp;</td><td>SASL GS2 protocol name </td></tr>
444*ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>mech_name</em>&nbsp;</td><td>gssapi protocol name </td></tr>
445*ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>mech_description</em>&nbsp;</td><td>description of gssapi mech</td></tr>
446*ae771770SStanislav Sedov  </table>
447*ae771770SStanislav Sedov</dl>
448*ae771770SStanislav Sedov<dl class="return" compact><dt><b>Returns:</b></dt><dd>returns GSS_S_COMPLETE or a error code. </dd></dl>
449*ae771770SStanislav Sedov
450*ae771770SStanislav Sedov</div>
451*ae771770SStanislav Sedov</div><p>
452*ae771770SStanislav Sedov<a class="anchor" name="gc98677df7ae9bbc387cd68002a97ad15"></a><!-- doxytag: member="gss_oid_equal.c::gss_oid_equal" ref="gc98677df7ae9bbc387cd68002a97ad15" args="(gss_const_OID a, gss_const_OID b)" -->
453*ae771770SStanislav Sedov<div class="memitem">
454*ae771770SStanislav Sedov<div class="memproto">
455*ae771770SStanislav Sedov      <table class="memname">
456*ae771770SStanislav Sedov        <tr>
457*ae771770SStanislav Sedov          <td class="memname">GSSAPI_LIB_FUNCTION int GSSAPI_LIB_CALL gss_oid_equal           </td>
458*ae771770SStanislav Sedov          <td>(</td>
459*ae771770SStanislav Sedov          <td class="paramtype">gss_const_OID&nbsp;</td>
460*ae771770SStanislav Sedov          <td class="paramname"> <em>a</em>, </td>
461*ae771770SStanislav Sedov        </tr>
462*ae771770SStanislav Sedov        <tr>
463*ae771770SStanislav Sedov          <td class="paramkey"></td>
464*ae771770SStanislav Sedov          <td></td>
465*ae771770SStanislav Sedov          <td class="paramtype">gss_const_OID&nbsp;</td>
466*ae771770SStanislav Sedov          <td class="paramname"> <em>b</em></td><td>&nbsp;</td>
467*ae771770SStanislav Sedov        </tr>
468*ae771770SStanislav Sedov        <tr>
469*ae771770SStanislav Sedov          <td></td>
470*ae771770SStanislav Sedov          <td>)</td>
471*ae771770SStanislav Sedov          <td></td><td></td><td></td>
472*ae771770SStanislav Sedov        </tr>
473*ae771770SStanislav Sedov      </table>
474*ae771770SStanislav Sedov</div>
475*ae771770SStanislav Sedov<div class="memdoc">
476*ae771770SStanislav Sedov
477*ae771770SStanislav Sedov<p>
478*ae771770SStanislav SedovCompare two GSS-API OIDs with each other.<p>
479*ae771770SStanislav SedovGSS_C_NO_OID matches nothing, not even it-self.<p>
480*ae771770SStanislav Sedov<dl compact><dt><b>Parameters:</b></dt><dd>
481*ae771770SStanislav Sedov  <table border="0" cellspacing="2" cellpadding="0">
482*ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>a</em>&nbsp;</td><td>first oid to compare </td></tr>
483*ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>b</em>&nbsp;</td><td>second oid to compare</td></tr>
484*ae771770SStanislav Sedov  </table>
485*ae771770SStanislav Sedov</dl>
486*ae771770SStanislav Sedov<dl class="return" compact><dt><b>Returns:</b></dt><dd>non-zero when both oid are the same OID, zero when they are not the same. </dd></dl>
487*ae771770SStanislav Sedov
488*ae771770SStanislav Sedov</div>
489*ae771770SStanislav Sedov</div><p>
490*ae771770SStanislav Sedov<a class="anchor" name="gd2990721c56fe83e06d45648874680d7"></a><!-- doxytag: member="gss_release_cred.c::gss_release_cred" ref="gd2990721c56fe83e06d45648874680d7" args="(OM_uint32 *minor_status, gss_cred_id_t *cred_handle)" -->
491*ae771770SStanislav Sedov<div class="memitem">
492*ae771770SStanislav Sedov<div class="memproto">
493*ae771770SStanislav Sedov      <table class="memname">
494*ae771770SStanislav Sedov        <tr>
495*ae771770SStanislav Sedov          <td class="memname">GSSAPI_LIB_FUNCTION OM_uint32 GSSAPI_LIB_CALL gss_release_cred           </td>
496*ae771770SStanislav Sedov          <td>(</td>
497*ae771770SStanislav Sedov          <td class="paramtype">OM_uint32 *&nbsp;</td>
498*ae771770SStanislav Sedov          <td class="paramname"> <em>minor_status</em>, </td>
499*ae771770SStanislav Sedov        </tr>
500*ae771770SStanislav Sedov        <tr>
501*ae771770SStanislav Sedov          <td class="paramkey"></td>
502*ae771770SStanislav Sedov          <td></td>
503*ae771770SStanislav Sedov          <td class="paramtype">gss_cred_id_t *&nbsp;</td>
504*ae771770SStanislav Sedov          <td class="paramname"> <em>cred_handle</em></td><td>&nbsp;</td>
505*ae771770SStanislav Sedov        </tr>
506*ae771770SStanislav Sedov        <tr>
507*ae771770SStanislav Sedov          <td></td>
508*ae771770SStanislav Sedov          <td>)</td>
509*ae771770SStanislav Sedov          <td></td><td></td><td></td>
510*ae771770SStanislav Sedov        </tr>
511*ae771770SStanislav Sedov      </table>
512*ae771770SStanislav Sedov</div>
513*ae771770SStanislav Sedov<div class="memdoc">
514*ae771770SStanislav Sedov
515*ae771770SStanislav Sedov<p>
516*ae771770SStanislav SedovRelease a credentials<p>
517*ae771770SStanislav SedovIts ok to release the GSS_C_NO_CREDENTIAL/NULL credential, it will return a GSS_S_COMPLETE error code. On return cred_handle is set ot GSS_C_NO_CREDENTIAL.<p>
518*ae771770SStanislav SedovExample:<p>
519*ae771770SStanislav Sedov<div class="fragment"><pre class="fragment"> gss_cred_id_t cred = GSS_C_NO_CREDENTIAL;
520*ae771770SStanislav Sedov major = <a class="code" href="group__gssapi.html#gd2990721c56fe83e06d45648874680d7">gss_release_cred</a>(&amp;minor, &amp;cred);
521*ae771770SStanislav Sedov</pre></div><p>
522*ae771770SStanislav Sedov<dl compact><dt><b>Parameters:</b></dt><dd>
523*ae771770SStanislav Sedov  <table border="0" cellspacing="2" cellpadding="0">
524*ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>minor_status</em>&nbsp;</td><td>minor status return code, mech specific </td></tr>
525*ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>cred_handle</em>&nbsp;</td><td>a pointer to the credential too release</td></tr>
526*ae771770SStanislav Sedov  </table>
527*ae771770SStanislav Sedov</dl>
528*ae771770SStanislav Sedov<dl class="return" compact><dt><b>Returns:</b></dt><dd>an gssapi error code </dd></dl>
529*ae771770SStanislav Sedov
530*ae771770SStanislav Sedov</div>
531*ae771770SStanislav Sedov</div><p>
532*ae771770SStanislav Sedov<a class="anchor" name="g2dbb20a4c9a3cf5072ef081cd37e54b4"></a><!-- doxytag: member="gss_aeap.c::gss_release_iov_buffer" ref="g2dbb20a4c9a3cf5072ef081cd37e54b4" args="(OM_uint32 *minor_status, gss_iov_buffer_desc *iov, int iov_count)" -->
533*ae771770SStanislav Sedov<div class="memitem">
534*ae771770SStanislav Sedov<div class="memproto">
535*ae771770SStanislav Sedov      <table class="memname">
536*ae771770SStanislav Sedov        <tr>
537*ae771770SStanislav Sedov          <td class="memname">GSSAPI_LIB_FUNCTION OM_uint32 GSSAPI_LIB_CALL gss_release_iov_buffer           </td>
538*ae771770SStanislav Sedov          <td>(</td>
539*ae771770SStanislav Sedov          <td class="paramtype">OM_uint32 *&nbsp;</td>
540*ae771770SStanislav Sedov          <td class="paramname"> <em>minor_status</em>, </td>
541*ae771770SStanislav Sedov        </tr>
542*ae771770SStanislav Sedov        <tr>
543*ae771770SStanislav Sedov          <td class="paramkey"></td>
544*ae771770SStanislav Sedov          <td></td>
545*ae771770SStanislav Sedov          <td class="paramtype">gss_iov_buffer_desc *&nbsp;</td>
546*ae771770SStanislav Sedov          <td class="paramname"> <em>iov</em>, </td>
547*ae771770SStanislav Sedov        </tr>
548*ae771770SStanislav Sedov        <tr>
549*ae771770SStanislav Sedov          <td class="paramkey"></td>
550*ae771770SStanislav Sedov          <td></td>
551*ae771770SStanislav Sedov          <td class="paramtype">int&nbsp;</td>
552*ae771770SStanislav Sedov          <td class="paramname"> <em>iov_count</em></td><td>&nbsp;</td>
553*ae771770SStanislav Sedov        </tr>
554*ae771770SStanislav Sedov        <tr>
555*ae771770SStanislav Sedov          <td></td>
556*ae771770SStanislav Sedov          <td>)</td>
557*ae771770SStanislav Sedov          <td></td><td></td><td></td>
558*ae771770SStanislav Sedov        </tr>
559*ae771770SStanislav Sedov      </table>
560*ae771770SStanislav Sedov</div>
561*ae771770SStanislav Sedov<div class="memdoc">
562*ae771770SStanislav Sedov
563*ae771770SStanislav Sedov<p>
564*ae771770SStanislav SedovFree all buffer allocated by <a class="el" href="group__gssapi.html#gb02ec963066cc8e5e6682799457208e9">gss_wrap_iov()</a> or <a class="el" href="group__gssapi.html#g399bb326e47574aca7b28d6886d29fd0">gss_unwrap_iov()</a> by looking at the GSS_IOV_BUFFER_FLAG_ALLOCATED flag.
565*ae771770SStanislav Sedov</div>
566*ae771770SStanislav Sedov</div><p>
567*ae771770SStanislav Sedov<a class="anchor" name="g0691190338f1f24170bd5f695ff1e721"></a><!-- doxytag: member="gss_release_name.c::gss_release_name" ref="g0691190338f1f24170bd5f695ff1e721" args="(OM_uint32 *minor_status, gss_name_t *input_name)" -->
568*ae771770SStanislav Sedov<div class="memitem">
569*ae771770SStanislav Sedov<div class="memproto">
570*ae771770SStanislav Sedov      <table class="memname">
571*ae771770SStanislav Sedov        <tr>
572*ae771770SStanislav Sedov          <td class="memname">GSSAPI_LIB_FUNCTION OM_uint32 GSSAPI_LIB_CALL gss_release_name           </td>
573*ae771770SStanislav Sedov          <td>(</td>
574*ae771770SStanislav Sedov          <td class="paramtype">OM_uint32 *&nbsp;</td>
575*ae771770SStanislav Sedov          <td class="paramname"> <em>minor_status</em>, </td>
576*ae771770SStanislav Sedov        </tr>
577*ae771770SStanislav Sedov        <tr>
578*ae771770SStanislav Sedov          <td class="paramkey"></td>
579*ae771770SStanislav Sedov          <td></td>
580*ae771770SStanislav Sedov          <td class="paramtype">gss_name_t *&nbsp;</td>
581*ae771770SStanislav Sedov          <td class="paramname"> <em>input_name</em></td><td>&nbsp;</td>
582*ae771770SStanislav Sedov        </tr>
583*ae771770SStanislav Sedov        <tr>
584*ae771770SStanislav Sedov          <td></td>
585*ae771770SStanislav Sedov          <td>)</td>
586*ae771770SStanislav Sedov          <td></td><td></td><td></td>
587*ae771770SStanislav Sedov        </tr>
588*ae771770SStanislav Sedov      </table>
589*ae771770SStanislav Sedov</div>
590*ae771770SStanislav Sedov<div class="memdoc">
591*ae771770SStanislav Sedov
592*ae771770SStanislav Sedov<p>
593*ae771770SStanislav SedovFree a name<p>
594*ae771770SStanislav Sedovimport_name can point to NULL or be NULL, or a pointer to a gss_name_t structure. If it was a pointer to gss_name_t, the pointer will be set to NULL on success and failure.<p>
595*ae771770SStanislav Sedov<dl compact><dt><b>Parameters:</b></dt><dd>
596*ae771770SStanislav Sedov  <table border="0" cellspacing="2" cellpadding="0">
597*ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>minor_status</em>&nbsp;</td><td>minor status code </td></tr>
598*ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>input_name</em>&nbsp;</td><td>name to free</td></tr>
599*ae771770SStanislav Sedov  </table>
600*ae771770SStanislav Sedov</dl>
601*ae771770SStanislav Sedov<dl class="return" compact><dt><b>Returns:</b></dt><dd>a gss_error code, see gss_display_status() about printing the error code. </dd></dl>
602*ae771770SStanislav Sedov
603*ae771770SStanislav Sedov</div>
604*ae771770SStanislav Sedov</div><p>
605*ae771770SStanislav Sedov<a class="anchor" name="g399bb326e47574aca7b28d6886d29fd0"></a><!-- doxytag: member="gss_aeap.c::gss_unwrap_iov" ref="g399bb326e47574aca7b28d6886d29fd0" args="(OM_uint32 *minor_status, gss_ctx_id_t context_handle, int *conf_state, gss_qop_t *qop_state, gss_iov_buffer_desc *iov, int iov_count)" -->
606*ae771770SStanislav Sedov<div class="memitem">
607*ae771770SStanislav Sedov<div class="memproto">
608*ae771770SStanislav Sedov      <table class="memname">
609*ae771770SStanislav Sedov        <tr>
610*ae771770SStanislav Sedov          <td class="memname">GSSAPI_LIB_FUNCTION OM_uint32 GSSAPI_LIB_CALL gss_unwrap_iov           </td>
611*ae771770SStanislav Sedov          <td>(</td>
612*ae771770SStanislav Sedov          <td class="paramtype">OM_uint32 *&nbsp;</td>
613*ae771770SStanislav Sedov          <td class="paramname"> <em>minor_status</em>, </td>
614*ae771770SStanislav Sedov        </tr>
615*ae771770SStanislav Sedov        <tr>
616*ae771770SStanislav Sedov          <td class="paramkey"></td>
617*ae771770SStanislav Sedov          <td></td>
618*ae771770SStanislav Sedov          <td class="paramtype">gss_ctx_id_t&nbsp;</td>
619*ae771770SStanislav Sedov          <td class="paramname"> <em>context_handle</em>, </td>
620*ae771770SStanislav Sedov        </tr>
621*ae771770SStanislav Sedov        <tr>
622*ae771770SStanislav Sedov          <td class="paramkey"></td>
623*ae771770SStanislav Sedov          <td></td>
624*ae771770SStanislav Sedov          <td class="paramtype">int *&nbsp;</td>
625*ae771770SStanislav Sedov          <td class="paramname"> <em>conf_state</em>, </td>
626*ae771770SStanislav Sedov        </tr>
627*ae771770SStanislav Sedov        <tr>
628*ae771770SStanislav Sedov          <td class="paramkey"></td>
629*ae771770SStanislav Sedov          <td></td>
630*ae771770SStanislav Sedov          <td class="paramtype">gss_qop_t *&nbsp;</td>
631*ae771770SStanislav Sedov          <td class="paramname"> <em>qop_state</em>, </td>
632*ae771770SStanislav Sedov        </tr>
633*ae771770SStanislav Sedov        <tr>
634*ae771770SStanislav Sedov          <td class="paramkey"></td>
635*ae771770SStanislav Sedov          <td></td>
636*ae771770SStanislav Sedov          <td class="paramtype">gss_iov_buffer_desc *&nbsp;</td>
637*ae771770SStanislav Sedov          <td class="paramname"> <em>iov</em>, </td>
638*ae771770SStanislav Sedov        </tr>
639*ae771770SStanislav Sedov        <tr>
640*ae771770SStanislav Sedov          <td class="paramkey"></td>
641*ae771770SStanislav Sedov          <td></td>
642*ae771770SStanislav Sedov          <td class="paramtype">int&nbsp;</td>
643*ae771770SStanislav Sedov          <td class="paramname"> <em>iov_count</em></td><td>&nbsp;</td>
644*ae771770SStanislav Sedov        </tr>
645*ae771770SStanislav Sedov        <tr>
646*ae771770SStanislav Sedov          <td></td>
647*ae771770SStanislav Sedov          <td>)</td>
648*ae771770SStanislav Sedov          <td></td><td></td><td></td>
649*ae771770SStanislav Sedov        </tr>
650*ae771770SStanislav Sedov      </table>
651*ae771770SStanislav Sedov</div>
652*ae771770SStanislav Sedov<div class="memdoc">
653*ae771770SStanislav Sedov
654*ae771770SStanislav Sedov<p>
655*ae771770SStanislav SedovDecrypt or verifies the signature on the data.
656*ae771770SStanislav Sedov</div>
657*ae771770SStanislav Sedov</div><p>
658*ae771770SStanislav Sedov<a class="anchor" name="g89a6d98056b75a8a25152de268833f51"></a><!-- doxytag: member="gss_wrap.c::gss_wrap" ref="g89a6d98056b75a8a25152de268833f51" args="(OM_uint32 *minor_status, const gss_ctx_id_t context_handle, int conf_req_flag, gss_qop_t qop_req, const gss_buffer_t input_message_buffer, int *conf_state, gss_buffer_t output_message_buffer)" -->
659*ae771770SStanislav Sedov<div class="memitem">
660*ae771770SStanislav Sedov<div class="memproto">
661*ae771770SStanislav Sedov      <table class="memname">
662*ae771770SStanislav Sedov        <tr>
663*ae771770SStanislav Sedov          <td class="memname">GSSAPI_LIB_FUNCTION OM_uint32 GSSAPI_LIB_CALL gss_wrap           </td>
664*ae771770SStanislav Sedov          <td>(</td>
665*ae771770SStanislav Sedov          <td class="paramtype">OM_uint32 *&nbsp;</td>
666*ae771770SStanislav Sedov          <td class="paramname"> <em>minor_status</em>, </td>
667*ae771770SStanislav Sedov        </tr>
668*ae771770SStanislav Sedov        <tr>
669*ae771770SStanislav Sedov          <td class="paramkey"></td>
670*ae771770SStanislav Sedov          <td></td>
671*ae771770SStanislav Sedov          <td class="paramtype">const gss_ctx_id_t&nbsp;</td>
672*ae771770SStanislav Sedov          <td class="paramname"> <em>context_handle</em>, </td>
673*ae771770SStanislav Sedov        </tr>
674*ae771770SStanislav Sedov        <tr>
675*ae771770SStanislav Sedov          <td class="paramkey"></td>
676*ae771770SStanislav Sedov          <td></td>
677*ae771770SStanislav Sedov          <td class="paramtype">int&nbsp;</td>
678*ae771770SStanislav Sedov          <td class="paramname"> <em>conf_req_flag</em>, </td>
679*ae771770SStanislav Sedov        </tr>
680*ae771770SStanislav Sedov        <tr>
681*ae771770SStanislav Sedov          <td class="paramkey"></td>
682*ae771770SStanislav Sedov          <td></td>
683*ae771770SStanislav Sedov          <td class="paramtype">gss_qop_t&nbsp;</td>
684*ae771770SStanislav Sedov          <td class="paramname"> <em>qop_req</em>, </td>
685*ae771770SStanislav Sedov        </tr>
686*ae771770SStanislav Sedov        <tr>
687*ae771770SStanislav Sedov          <td class="paramkey"></td>
688*ae771770SStanislav Sedov          <td></td>
689*ae771770SStanislav Sedov          <td class="paramtype">const gss_buffer_t&nbsp;</td>
690*ae771770SStanislav Sedov          <td class="paramname"> <em>input_message_buffer</em>, </td>
691*ae771770SStanislav Sedov        </tr>
692*ae771770SStanislav Sedov        <tr>
693*ae771770SStanislav Sedov          <td class="paramkey"></td>
694*ae771770SStanislav Sedov          <td></td>
695*ae771770SStanislav Sedov          <td class="paramtype">int *&nbsp;</td>
696*ae771770SStanislav Sedov          <td class="paramname"> <em>conf_state</em>, </td>
697*ae771770SStanislav Sedov        </tr>
698*ae771770SStanislav Sedov        <tr>
699*ae771770SStanislav Sedov          <td class="paramkey"></td>
700*ae771770SStanislav Sedov          <td></td>
701*ae771770SStanislav Sedov          <td class="paramtype">gss_buffer_t&nbsp;</td>
702*ae771770SStanislav Sedov          <td class="paramname"> <em>output_message_buffer</em></td><td>&nbsp;</td>
703*ae771770SStanislav Sedov        </tr>
704*ae771770SStanislav Sedov        <tr>
705*ae771770SStanislav Sedov          <td></td>
706*ae771770SStanislav Sedov          <td>)</td>
707*ae771770SStanislav Sedov          <td></td><td></td><td></td>
708*ae771770SStanislav Sedov        </tr>
709*ae771770SStanislav Sedov      </table>
710*ae771770SStanislav Sedov</div>
711*ae771770SStanislav Sedov<div class="memdoc">
712*ae771770SStanislav Sedov
713*ae771770SStanislav Sedov<p>
714*ae771770SStanislav SedovWrap a message using either confidentiality (encryption + signature) or sealing (signature).<p>
715*ae771770SStanislav Sedov<dl compact><dt><b>Parameters:</b></dt><dd>
716*ae771770SStanislav Sedov  <table border="0" cellspacing="2" cellpadding="0">
717*ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>minor_status</em>&nbsp;</td><td>minor status code. </td></tr>
718*ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>context_handle</em>&nbsp;</td><td>context handle. </td></tr>
719*ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>conf_req_flag</em>&nbsp;</td><td>if non zero, confidentiality is requestd. </td></tr>
720*ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>qop_req</em>&nbsp;</td><td>type of protection needed, in most cases it GSS_C_QOP_DEFAULT should be passed in. </td></tr>
721*ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>input_message_buffer</em>&nbsp;</td><td>messages to wrap </td></tr>
722*ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>conf_state</em>&nbsp;</td><td>returns non zero if confidentiality was honoured. </td></tr>
723*ae771770SStanislav Sedov    <tr><td valign="top"></td><td valign="top"><em>output_message_buffer</em>&nbsp;</td><td>the resulting buffer, release with gss_release_buffer(). </td></tr>
724*ae771770SStanislav Sedov  </table>
725*ae771770SStanislav Sedov</dl>
726*ae771770SStanislav Sedov
727*ae771770SStanislav Sedov</div>
728*ae771770SStanislav Sedov</div><p>
729*ae771770SStanislav Sedov<a class="anchor" name="gb02ec963066cc8e5e6682799457208e9"></a><!-- doxytag: member="gss_aeap.c::gss_wrap_iov" ref="gb02ec963066cc8e5e6682799457208e9" args="(OM_uint32 *minor_status, gss_ctx_id_t context_handle, int conf_req_flag, gss_qop_t qop_req, int *conf_state, gss_iov_buffer_desc *iov, int iov_count)" -->
730*ae771770SStanislav Sedov<div class="memitem">
731*ae771770SStanislav Sedov<div class="memproto">
732*ae771770SStanislav Sedov      <table class="memname">
733*ae771770SStanislav Sedov        <tr>
734*ae771770SStanislav Sedov          <td class="memname">GSSAPI_LIB_FUNCTION OM_uint32 GSSAPI_LIB_CALL gss_wrap_iov           </td>
735*ae771770SStanislav Sedov          <td>(</td>
736*ae771770SStanislav Sedov          <td class="paramtype">OM_uint32 *&nbsp;</td>
737*ae771770SStanislav Sedov          <td class="paramname"> <em>minor_status</em>, </td>
738*ae771770SStanislav Sedov        </tr>
739*ae771770SStanislav Sedov        <tr>
740*ae771770SStanislav Sedov          <td class="paramkey"></td>
741*ae771770SStanislav Sedov          <td></td>
742*ae771770SStanislav Sedov          <td class="paramtype">gss_ctx_id_t&nbsp;</td>
743*ae771770SStanislav Sedov          <td class="paramname"> <em>context_handle</em>, </td>
744*ae771770SStanislav Sedov        </tr>
745*ae771770SStanislav Sedov        <tr>
746*ae771770SStanislav Sedov          <td class="paramkey"></td>
747*ae771770SStanislav Sedov          <td></td>
748*ae771770SStanislav Sedov          <td class="paramtype">int&nbsp;</td>
749*ae771770SStanislav Sedov          <td class="paramname"> <em>conf_req_flag</em>, </td>
750*ae771770SStanislav Sedov        </tr>
751*ae771770SStanislav Sedov        <tr>
752*ae771770SStanislav Sedov          <td class="paramkey"></td>
753*ae771770SStanislav Sedov          <td></td>
754*ae771770SStanislav Sedov          <td class="paramtype">gss_qop_t&nbsp;</td>
755*ae771770SStanislav Sedov          <td class="paramname"> <em>qop_req</em>, </td>
756*ae771770SStanislav Sedov        </tr>
757*ae771770SStanislav Sedov        <tr>
758*ae771770SStanislav Sedov          <td class="paramkey"></td>
759*ae771770SStanislav Sedov          <td></td>
760*ae771770SStanislav Sedov          <td class="paramtype">int *&nbsp;</td>
761*ae771770SStanislav Sedov          <td class="paramname"> <em>conf_state</em>, </td>
762*ae771770SStanislav Sedov        </tr>
763*ae771770SStanislav Sedov        <tr>
764*ae771770SStanislav Sedov          <td class="paramkey"></td>
765*ae771770SStanislav Sedov          <td></td>
766*ae771770SStanislav Sedov          <td class="paramtype">gss_iov_buffer_desc *&nbsp;</td>
767*ae771770SStanislav Sedov          <td class="paramname"> <em>iov</em>, </td>
768*ae771770SStanislav Sedov        </tr>
769*ae771770SStanislav Sedov        <tr>
770*ae771770SStanislav Sedov          <td class="paramkey"></td>
771*ae771770SStanislav Sedov          <td></td>
772*ae771770SStanislav Sedov          <td class="paramtype">int&nbsp;</td>
773*ae771770SStanislav Sedov          <td class="paramname"> <em>iov_count</em></td><td>&nbsp;</td>
774*ae771770SStanislav Sedov        </tr>
775*ae771770SStanislav Sedov        <tr>
776*ae771770SStanislav Sedov          <td></td>
777*ae771770SStanislav Sedov          <td>)</td>
778*ae771770SStanislav Sedov          <td></td><td></td><td></td>
779*ae771770SStanislav Sedov        </tr>
780*ae771770SStanislav Sedov      </table>
781*ae771770SStanislav Sedov</div>
782*ae771770SStanislav Sedov<div class="memdoc">
783*ae771770SStanislav Sedov
784*ae771770SStanislav Sedov<p>
785*ae771770SStanislav SedovEncrypts or sign the data.<p>
786*ae771770SStanislav SedovThis is a more complicated version of <a class="el" href="group__gssapi.html#g89a6d98056b75a8a25152de268833f51">gss_wrap()</a>, it allows the caller to use AEAD data (signed header/trailer) and allow greater controll over where the encrypted data is placed.<p>
787*ae771770SStanislav SedovThe maximum packet size is gss_context_stream_sizes.max_msg_size.<p>
788*ae771770SStanislav SedovThe caller needs provide the folloing buffers when using in conf_req_flag=1 mode:<p>
789*ae771770SStanislav Sedov<ul>
790*ae771770SStanislav Sedov<li>HEADER (of size gss_context_stream_sizes.header) { DATA or SIGN_ONLY } (optional, zero or more) PADDING (of size gss_context_stream_sizes.blocksize, if zero padding is zero, can be omitted) TRAILER (of size gss_context_stream_sizes.trailer)</li></ul>
791*ae771770SStanislav Sedov<p>
792*ae771770SStanislav Sedov<ul>
793*ae771770SStanislav Sedov<li>on DCE-RPC mode, the caller can skip PADDING and TRAILER if the DATA elements is padded to a block bountry and header is of at least size gss_context_stream_sizes.header + gss_context_stream_sizes.trailer.</li></ul>
794*ae771770SStanislav Sedov<p>
795*ae771770SStanislav SedovHEADER, PADDING, TRAILER will be shrunken to the size required to transmit any of them too large.<p>
796*ae771770SStanislav SedovTo generate <a class="el" href="group__gssapi.html#g89a6d98056b75a8a25152de268833f51">gss_wrap()</a> compatible packets, use: HEADER | DATA | PADDING | TRAILER<p>
797*ae771770SStanislav SedovWhen used in conf_req_flag=0,<p>
798*ae771770SStanislav Sedov<ul>
799*ae771770SStanislav Sedov<li>HEADER (of size gss_context_stream_sizes.header) { DATA or SIGN_ONLY } (optional, zero or more) PADDING (of size gss_context_stream_sizes.blocksize, if zero padding is zero, can be omitted) TRAILER (of size gss_context_stream_sizes.trailer)</li></ul>
800*ae771770SStanislav Sedov<p>
801*ae771770SStanislav SedovThe input sizes of HEADER, PADDING and TRAILER can be fetched using <a class="el" href="group__gssapi.html#g6216cfcb1ba8dc2d1a1d680d21752f26">gss_wrap_iov_length()</a> or gss_context_query_attributes().
802*ae771770SStanislav Sedov</div>
803*ae771770SStanislav Sedov</div><p>
804*ae771770SStanislav Sedov<a class="anchor" name="g6216cfcb1ba8dc2d1a1d680d21752f26"></a><!-- doxytag: member="gss_aeap.c::gss_wrap_iov_length" ref="g6216cfcb1ba8dc2d1a1d680d21752f26" args="(OM_uint32 *minor_status, gss_ctx_id_t context_handle, int conf_req_flag, gss_qop_t qop_req, int *conf_state, gss_iov_buffer_desc *iov, int iov_count)" -->
805*ae771770SStanislav Sedov<div class="memitem">
806*ae771770SStanislav Sedov<div class="memproto">
807*ae771770SStanislav Sedov      <table class="memname">
808*ae771770SStanislav Sedov        <tr>
809*ae771770SStanislav Sedov          <td class="memname">GSSAPI_LIB_FUNCTION OM_uint32 GSSAPI_LIB_CALL gss_wrap_iov_length           </td>
810*ae771770SStanislav Sedov          <td>(</td>
811*ae771770SStanislav Sedov          <td class="paramtype">OM_uint32 *&nbsp;</td>
812*ae771770SStanislav Sedov          <td class="paramname"> <em>minor_status</em>, </td>
813*ae771770SStanislav Sedov        </tr>
814*ae771770SStanislav Sedov        <tr>
815*ae771770SStanislav Sedov          <td class="paramkey"></td>
816*ae771770SStanislav Sedov          <td></td>
817*ae771770SStanislav Sedov          <td class="paramtype">gss_ctx_id_t&nbsp;</td>
818*ae771770SStanislav Sedov          <td class="paramname"> <em>context_handle</em>, </td>
819*ae771770SStanislav Sedov        </tr>
820*ae771770SStanislav Sedov        <tr>
821*ae771770SStanislav Sedov          <td class="paramkey"></td>
822*ae771770SStanislav Sedov          <td></td>
823*ae771770SStanislav Sedov          <td class="paramtype">int&nbsp;</td>
824*ae771770SStanislav Sedov          <td class="paramname"> <em>conf_req_flag</em>, </td>
825*ae771770SStanislav Sedov        </tr>
826*ae771770SStanislav Sedov        <tr>
827*ae771770SStanislav Sedov          <td class="paramkey"></td>
828*ae771770SStanislav Sedov          <td></td>
829*ae771770SStanislav Sedov          <td class="paramtype">gss_qop_t&nbsp;</td>
830*ae771770SStanislav Sedov          <td class="paramname"> <em>qop_req</em>, </td>
831*ae771770SStanislav Sedov        </tr>
832*ae771770SStanislav Sedov        <tr>
833*ae771770SStanislav Sedov          <td class="paramkey"></td>
834*ae771770SStanislav Sedov          <td></td>
835*ae771770SStanislav Sedov          <td class="paramtype">int *&nbsp;</td>
836*ae771770SStanislav Sedov          <td class="paramname"> <em>conf_state</em>, </td>
837*ae771770SStanislav Sedov        </tr>
838*ae771770SStanislav Sedov        <tr>
839*ae771770SStanislav Sedov          <td class="paramkey"></td>
840*ae771770SStanislav Sedov          <td></td>
841*ae771770SStanislav Sedov          <td class="paramtype">gss_iov_buffer_desc *&nbsp;</td>
842*ae771770SStanislav Sedov          <td class="paramname"> <em>iov</em>, </td>
843*ae771770SStanislav Sedov        </tr>
844*ae771770SStanislav Sedov        <tr>
845*ae771770SStanislav Sedov          <td class="paramkey"></td>
846*ae771770SStanislav Sedov          <td></td>
847*ae771770SStanislav Sedov          <td class="paramtype">int&nbsp;</td>
848*ae771770SStanislav Sedov          <td class="paramname"> <em>iov_count</em></td><td>&nbsp;</td>
849*ae771770SStanislav Sedov        </tr>
850*ae771770SStanislav Sedov        <tr>
851*ae771770SStanislav Sedov          <td></td>
852*ae771770SStanislav Sedov          <td>)</td>
853*ae771770SStanislav Sedov          <td></td><td></td><td></td>
854*ae771770SStanislav Sedov        </tr>
855*ae771770SStanislav Sedov      </table>
856*ae771770SStanislav Sedov</div>
857*ae771770SStanislav Sedov<div class="memdoc">
858*ae771770SStanislav Sedov
859*ae771770SStanislav Sedov<p>
860*ae771770SStanislav SedovUpdate the length fields in iov buffer for the types:<ul>
861*ae771770SStanislav Sedov<li>GSS_IOV_BUFFER_TYPE_HEADER</li><li>GSS_IOV_BUFFER_TYPE_PADDING</li><li>GSS_IOV_BUFFER_TYPE_TRAILER</li></ul>
862*ae771770SStanislav Sedov<p>
863*ae771770SStanislav SedovConsider using gss_context_query_attributes() to fetch the data instead.
864*ae771770SStanislav Sedov</div>
865*ae771770SStanislav Sedov</div><p>
866*ae771770SStanislav Sedov<hr><h2>Variable Documentation</h2>
867*ae771770SStanislav Sedov<a class="anchor" name="g961f7a7f9f92e06b91c6d503e524a672"></a><!-- doxytag: member="gss_aeap.c::__gss_c_attr_stream_sizes_oid_desc" ref="g961f7a7f9f92e06b91c6d503e524a672" args="" -->
868*ae771770SStanislav Sedov<div class="memitem">
869*ae771770SStanislav Sedov<div class="memproto">
870*ae771770SStanislav Sedov      <table class="memname">
871*ae771770SStanislav Sedov        <tr>
872*ae771770SStanislav Sedov          <td class="memname">gss_OID_desc GSSAPI_LIB_FUNCTION <a class="el" href="group__gssapi.html#g961f7a7f9f92e06b91c6d503e524a672">__gss_c_attr_stream_sizes_oid_desc</a>          </td>
873*ae771770SStanislav Sedov        </tr>
874*ae771770SStanislav Sedov      </table>
875*ae771770SStanislav Sedov</div>
876*ae771770SStanislav Sedov<div class="memdoc">
877*ae771770SStanislav Sedov
878*ae771770SStanislav Sedov<p>
879*ae771770SStanislav Sedov<b>Initial value:</b><div class="fragment"><pre class="fragment">
880*ae771770SStanislav Sedov    {10, rk_UNCONST(<span class="stringliteral">"\x2a\x86\x48\x86\xf7\x12\x01\x02\x01\x03"</span>)}
881*ae771770SStanislav Sedov</pre></div>Query the context for parameters.<p>
882*ae771770SStanislav SedovSSPI equivalent if this function is QueryContextAttributes.<p>
883*ae771770SStanislav Sedov<ul>
884*ae771770SStanislav Sedov<li>GSS_C_ATTR_STREAM_SIZES data is a gss_context_stream_sizes. </li></ul>
885*ae771770SStanislav Sedov
886*ae771770SStanislav Sedov</div>
887*ae771770SStanislav Sedov</div><p>
888*ae771770SStanislav Sedov</div>
889*ae771770SStanislav Sedov<hr size="1"><address style="text-align: right;"><small>
890*ae771770SStanislav SedovGenerated on Fri Sep 30 15:26:16 2011 for HeimdalGSS-APIlibrary 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>
891*ae771770SStanislav Sedov</body>
892*ae771770SStanislav Sedov</html>
893