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