<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
<title>Heimdal GSS-API functions</title>
<link href="doxygen.css" rel="stylesheet" type="text/css">
<link href="tabs.css" rel="stylesheet" type="text/css">
</head><body>
<p>
<a href="http://www.h5l.org/"><img src="http://www.h5l.org/keyhole-heimdal.png" alt="keyhole logo"/></a>
</p>
<!-- end of header marker -->
<!-- Generated by Doxygen 1.9.1 -->
<script type="text/javascript" src="menudata.js"></script>
<script type="text/javascript" src="menu.js"></script>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt GPL-v2 */
$(function() {
initMenu('',false,false,'search.php','Search');
});
/* @license-end */</script>
<div id="main-nav"></div>
</div><!-- top -->
<div class="header">
<div class="summary">
<a href="#func-members">Functions</a> |
<a href="#var-members">Variables</a> </div>
<div class="headertitle">
<div class="title">Heimdal GSS-API functions</div> </div>
</div><!--header-->
<div class="contents">
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="func-members"></a>
Functions</h2></td></tr>
<tr class="memitem:ga233373d4e0baa31615eb4d4f0ccb9683"><td class="memItemLeft" align="right" valign="top">GSSAPI_LIB_FUNCTION OM_uint32 GSSAPI_LIB_CALL </td><td class="memItemRight" valign="bottom"><a class="el" href="group__gssapi.html#ga233373d4e0baa31615eb4d4f0ccb9683">gss_add_oid_set_member</a> (OM_uint32 *minor_status, const gss_OID member_oid, gss_OID_set *oid_set)</td></tr>
<tr class="separator:ga233373d4e0baa31615eb4d4f0ccb9683"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gab02ec963066cc8e5e6682799457208e9"><td class="memItemLeft" align="right" valign="top">GSSAPI_LIB_FUNCTION OM_uint32 GSSAPI_LIB_CALL </td><td class="memItemRight" valign="bottom"><a class="el" href="group__gssapi.html#gab02ec963066cc8e5e6682799457208e9">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>
<tr class="separator:gab02ec963066cc8e5e6682799457208e9"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga399bb326e47574aca7b28d6886d29fd0"><td class="memItemLeft" align="right" valign="top">GSSAPI_LIB_FUNCTION OM_uint32 GSSAPI_LIB_CALL </td><td class="memItemRight" valign="bottom"><a class="el" href="group__gssapi.html#ga399bb326e47574aca7b28d6886d29fd0">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>
<tr class="separator:ga399bb326e47574aca7b28d6886d29fd0"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga6216cfcb1ba8dc2d1a1d680d21752f26"><td class="memItemLeft" align="right" valign="top">GSSAPI_LIB_FUNCTION OM_uint32 GSSAPI_LIB_CALL </td><td class="memItemRight" valign="bottom"><a class="el" href="group__gssapi.html#ga6216cfcb1ba8dc2d1a1d680d21752f26">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>
<tr class="separator:ga6216cfcb1ba8dc2d1a1d680d21752f26"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga2dbb20a4c9a3cf5072ef081cd37e54b4"><td class="memItemLeft" align="right" valign="top">GSSAPI_LIB_FUNCTION OM_uint32 GSSAPI_LIB_CALL </td><td class="memItemRight" valign="bottom"><a class="el" href="group__gssapi.html#ga2dbb20a4c9a3cf5072ef081cd37e54b4">gss_release_iov_buffer</a> (OM_uint32 *minor_status, gss_iov_buffer_desc *iov, int iov_count)</td></tr>
<tr class="separator:ga2dbb20a4c9a3cf5072ef081cd37e54b4"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gae00fe4a91f13d61172361a30fb24a06e"><td class="memItemLeft" align="right" valign="top">GSSAPI_LIB_FUNCTION OM_uint32 GSSAPI_LIB_CALL </td><td class="memItemRight" valign="bottom"><a class="el" href="group__gssapi.html#gae00fe4a91f13d61172361a30fb24a06e">gss_canonicalize_name</a> (OM_uint32 *minor_status, gss_const_name_t input_name, const gss_OID mech_type, gss_name_t *output_name)</td></tr>
<tr class="separator:gae00fe4a91f13d61172361a30fb24a06e"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga770d87c1b80a58e91ec3a9ed70468122"><td class="memItemLeft" align="right" valign="top">GSSAPI_LIB_FUNCTION OM_uint32 GSSAPI_LIB_CALL </td><td class="memItemRight" valign="bottom"><a class="el" href="group__gssapi.html#ga770d87c1b80a58e91ec3a9ed70468122">gss_display_status</a> (OM_uint32 *minor_status, OM_uint32 status_value, int status_type, const gss_OID mech_type, OM_uint32 *message_context, gss_buffer_t status_string)</td></tr>
<tr class="separator:ga770d87c1b80a58e91ec3a9ed70468122"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga353814c7de38c9e2894ca66f0c15c8eb"><td class="memItemLeft" align="right" valign="top">GSSAPI_LIB_FUNCTION OM_uint32 GSSAPI_LIB_CALL </td><td class="memItemRight" valign="bottom"><a class="el" href="group__gssapi.html#ga353814c7de38c9e2894ca66f0c15c8eb">gss_export_name</a> (OM_uint32 *minor_status, gss_const_name_t input_name, gss_buffer_t exported_name)</td></tr>
<tr class="separator:ga353814c7de38c9e2894ca66f0c15c8eb"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga0afe06fd5264ebfb93ecca4bcc70895b"><td class="memItemLeft" align="right" valign="top">GSSAPI_LIB_FUNCTION OM_uint32 GSSAPI_LIB_CALL </td><td class="memItemRight" valign="bottom"><a class="el" href="group__gssapi.html#ga0afe06fd5264ebfb93ecca4bcc70895b">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>
<tr class="separator:ga0afe06fd5264ebfb93ecca4bcc70895b"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga890d690b8598288f33e31370bcfd3127"><td class="memItemLeft" align="right" valign="top">GSSAPI_LIB_FUNCTION OM_uint32 GSSAPI_LIB_CALL </td><td class="memItemRight" valign="bottom"><a class="el" href="group__gssapi.html#ga890d690b8598288f33e31370bcfd3127">gss_init_sec_context</a> (OM_uint32 *minor_status, gss_const_cred_id_t initiator_cred_handle, gss_ctx_id_t *context_handle, gss_const_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>
<tr class="separator:ga890d690b8598288f33e31370bcfd3127"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gadc725eaf82322d8cf50812fc26442893"><td class="memItemLeft" align="right" valign="top">GSSAPI_LIB_FUNCTION OM_uint32 GSSAPI_LIB_CALL </td><td class="memItemRight" valign="bottom"><a class="el" href="group__gssapi.html#gadc725eaf82322d8cf50812fc26442893">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>
<tr class="separator:gadc725eaf82322d8cf50812fc26442893"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaf472671a43512495de04ca0c69079e5d"><td class="memItemLeft" align="right" valign="top">GSSAPI_LIB_FUNCTION OM_uint32 GSSAPI_LIB_CALL </td><td class="memItemRight" valign="bottom"><a class="el" href="group__gssapi.html#gaf472671a43512495de04ca0c69079e5d">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>
<tr class="separator:gaf472671a43512495de04ca0c69079e5d"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gac98677df7ae9bbc387cd68002a97ad15"><td class="memItemLeft" align="right" valign="top">GSSAPI_LIB_FUNCTION int GSSAPI_LIB_CALL </td><td class="memItemRight" valign="bottom"><a class="el" href="group__gssapi.html#gac98677df7ae9bbc387cd68002a97ad15">gss_oid_equal</a> (gss_const_OID a, gss_const_OID b)</td></tr>
<tr class="separator:gac98677df7ae9bbc387cd68002a97ad15"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gad2990721c56fe83e06d45648874680d7"><td class="memItemLeft" align="right" valign="top">GSSAPI_LIB_FUNCTION OM_uint32 GSSAPI_LIB_CALL </td><td class="memItemRight" valign="bottom"><a class="el" href="group__gssapi.html#gad2990721c56fe83e06d45648874680d7">gss_release_cred</a> (OM_uint32 *minor_status, gss_cred_id_t *cred_handle)</td></tr>
<tr class="separator:gad2990721c56fe83e06d45648874680d7"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga0691190338f1f24170bd5f695ff1e721"><td class="memItemLeft" align="right" valign="top">GSSAPI_LIB_FUNCTION OM_uint32 GSSAPI_LIB_CALL </td><td class="memItemRight" valign="bottom"><a class="el" href="group__gssapi.html#ga0691190338f1f24170bd5f695ff1e721">gss_release_name</a> (OM_uint32 *minor_status, gss_name_t *input_name)</td></tr>
<tr class="separator:ga0691190338f1f24170bd5f695ff1e721"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga4058cf5c3b04fd25f8339c71dd5e964c"><td class="memItemLeft" align="right" valign="top">GSSAPI_LIB_FUNCTION OM_uint32 GSSAPI_LIB_CALL </td><td class="memItemRight" valign="bottom"><a class="el" href="group__gssapi.html#ga4058cf5c3b04fd25f8339c71dd5e964c">gss_wrap</a> (OM_uint32 *minor_status, gss_const_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>
<tr class="separator:ga4058cf5c3b04fd25f8339c71dd5e964c"><td class="memSeparator" colspan="2"> </td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="var-members"></a>
Variables</h2></td></tr>
<tr class="memitem:ga961f7a7f9f92e06b91c6d503e524a672"><td class="memItemLeft" align="right" valign="top">gss_OID_desc GSSAPI_LIB_FUNCTION </td><td class="memItemRight" valign="bottom"><a class="el" href="group__gssapi.html#ga961f7a7f9f92e06b91c6d503e524a672">__gss_c_attr_stream_sizes_oid_desc</a></td></tr>
<tr class="separator:ga961f7a7f9f92e06b91c6d503e524a672"><td class="memSeparator" colspan="2"> </td></tr>
</table>
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
<h2 class="groupheader">Function Documentation</h2>
<a id="ga233373d4e0baa31615eb4d4f0ccb9683"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga233373d4e0baa31615eb4d4f0ccb9683">◆ </a></span>gss_add_oid_set_member()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">GSSAPI_LIB_FUNCTION OM_uint32 GSSAPI_LIB_CALL gss_add_oid_set_member </td>
<td>(</td>
<td class="paramtype">OM_uint32 * </td>
<td class="paramname"><em>minor_status</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const gss_OID </td>
<td class="paramname"><em>member_oid</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gss_OID_set * </td>
<td class="paramname"><em>oid_set</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Add 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>
<p>If there is a duplicate member of the oid, the new member is not added to to the set.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">minor_status</td><td>minor status code. </td></tr>
<tr><td class="paramname">member_oid</td><td>member to add to the oid set </td></tr>
<tr><td class="paramname">oid_set</td><td>oid set to add the member too</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>a gss_error code, see <a class="el" href="group__gssapi.html#ga770d87c1b80a58e91ec3a9ed70468122">gss_display_status()</a> about printing the error code. </dd></dl>
</div>
</div>
<a id="gae00fe4a91f13d61172361a30fb24a06e"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gae00fe4a91f13d61172361a30fb24a06e">◆ </a></span>gss_canonicalize_name()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">GSSAPI_LIB_FUNCTION OM_uint32 GSSAPI_LIB_CALL gss_canonicalize_name </td>
<td>(</td>
<td class="paramtype">OM_uint32 * </td>
<td class="paramname"><em>minor_status</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gss_const_name_t </td>
<td class="paramname"><em>input_name</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const gss_OID </td>
<td class="paramname"><em>mech_type</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gss_name_t * </td>
<td class="paramname"><em>output_name</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>gss_canonicalize_name takes a Internal Name (IN) and converts in into a mechanism specific Mechanism Name (MN).</p>
<p>The input name may multiple name, or generic name types.</p>
<p>If 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>
<p>For more information about <a class="el" href="internal_v_smechname.html">Internal names and mechanism names</a>.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">minor_status</td><td>minor status code. </td></tr>
<tr><td class="paramname">input_name</td><td>name to covert, unchanged by <a class="el" href="group__gssapi.html#gae00fe4a91f13d61172361a30fb24a06e">gss_canonicalize_name()</a>. </td></tr>
<tr><td class="paramname">mech_type</td><td>the type to convert Name too. </td></tr>
<tr><td class="paramname">output_name</td><td>the resulting type, release with <a class="el" href="group__gssapi.html#ga0691190338f1f24170bd5f695ff1e721">gss_release_name()</a>, independent of input_name.</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>a gss_error code, see <a class="el" href="group__gssapi.html#ga770d87c1b80a58e91ec3a9ed70468122">gss_display_status()</a> about printing the error code. </dd></dl>
</div>
</div>
<a id="ga770d87c1b80a58e91ec3a9ed70468122"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga770d87c1b80a58e91ec3a9ed70468122">◆ </a></span>gss_display_status()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">GSSAPI_LIB_FUNCTION OM_uint32 GSSAPI_LIB_CALL gss_display_status </td>
<td>(</td>
<td class="paramtype">OM_uint32 * </td>
<td class="paramname"><em>minor_status</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">OM_uint32 </td>
<td class="paramname"><em>status_value</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>status_type</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const gss_OID </td>
<td class="paramname"><em>mech_type</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">OM_uint32 * </td>
<td class="paramname"><em>message_context</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gss_buffer_t </td>
<td class="paramname"><em>status_string</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Convert a GSS-API status code to text</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">minor_status</td><td>minor status code </td></tr>
<tr><td class="paramname">status_value</td><td>status value to convert </td></tr>
<tr><td class="paramname">status_type</td><td>One of: GSS_C_GSS_CODE - status_value is a GSS status code, GSS_C_MECH_CODE - status_value is a mechanism status code </td></tr>
<tr><td class="paramname">mech_type</td><td>underlying mechanism. Use GSS_C_NO_OID to obtain the system default. </td></tr>
<tr><td class="paramname">message_context</td><td>state information to extract further messages from the status_value </td></tr>
<tr><td class="paramname">status_string</td><td>the allocated text representation. Release with gss_release_buffer()</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>a gss_error code. </dd></dl>
</div>
</div>
<a id="ga353814c7de38c9e2894ca66f0c15c8eb"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga353814c7de38c9e2894ca66f0c15c8eb">◆ </a></span>gss_export_name()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">GSSAPI_LIB_FUNCTION OM_uint32 GSSAPI_LIB_CALL gss_export_name </td>
<td>(</td>
<td class="paramtype">OM_uint32 * </td>
<td class="paramname"><em>minor_status</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gss_const_name_t </td>
<td class="paramname"><em>input_name</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gss_buffer_t </td>
<td class="paramname"><em>exported_name</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Convert a GGS-API name from internal form to contiguous string.</p>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__gssapi.html#ga0afe06fd5264ebfb93ecca4bcc70895b">gss_import_name()</a>, <a class="el" href="internal_v_smechname.html">Internal names and mechanism names</a>.</dd></dl>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">minor_status</td><td>minor status code </td></tr>
<tr><td class="paramname">input_name</td><td>input name in internal name form </td></tr>
<tr><td class="paramname">exported_name</td><td>output name in contiguos string form</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>a gss_error code, see <a class="el" href="group__gssapi.html#ga770d87c1b80a58e91ec3a9ed70468122">gss_display_status()</a> about printing the error code. </dd></dl>
</div>
</div>
<a id="ga0afe06fd5264ebfb93ecca4bcc70895b"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga0afe06fd5264ebfb93ecca4bcc70895b">◆ </a></span>gss_import_name()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">GSSAPI_LIB_FUNCTION OM_uint32 GSSAPI_LIB_CALL gss_import_name </td>
<td>(</td>
<td class="paramtype">OM_uint32 * </td>
<td class="paramname"><em>minor_status</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const gss_buffer_t </td>
<td class="paramname"><em>input_name_buffer</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const gss_OID </td>
<td class="paramname"><em>input_name_type</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gss_name_t * </td>
<td class="paramname"><em>output_name</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Convert a GGS-API name from contiguous string to internal form.</p>
<p>Type of name and their format:</p><ul>
<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>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__gssapi.html#ga353814c7de38c9e2894ca66f0c15c8eb">gss_export_name()</a>, <a class="el" href="internal_v_smechname.html">Internal names and mechanism names</a>.</dd></dl>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">minor_status</td><td>minor status code </td></tr>
<tr><td class="paramname">input_name_buffer</td><td>import name buffer </td></tr>
<tr><td class="paramname">input_name_type</td><td>type of the import name buffer </td></tr>
<tr><td class="paramname">output_name</td><td>the resulting type, release with <a class="el" href="group__gssapi.html#ga0691190338f1f24170bd5f695ff1e721">gss_release_name()</a>, independent of input_name</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>a gss_error code, see <a class="el" href="group__gssapi.html#ga770d87c1b80a58e91ec3a9ed70468122">gss_display_status()</a> about printing the error code. </dd></dl>
</div>
</div>
<a id="ga890d690b8598288f33e31370bcfd3127"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga890d690b8598288f33e31370bcfd3127">◆ </a></span>gss_init_sec_context()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">GSSAPI_LIB_FUNCTION OM_uint32 GSSAPI_LIB_CALL gss_init_sec_context </td>
<td>(</td>
<td class="paramtype">OM_uint32 * </td>
<td class="paramname"><em>minor_status</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gss_const_cred_id_t </td>
<td class="paramname"><em>initiator_cred_handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gss_ctx_id_t * </td>
<td class="paramname"><em>context_handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gss_const_name_t </td>
<td class="paramname"><em>target_name</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const gss_OID </td>
<td class="paramname"><em>input_mech_type</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">OM_uint32 </td>
<td class="paramname"><em>req_flags</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">OM_uint32 </td>
<td class="paramname"><em>time_req</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const gss_channel_bindings_t </td>
<td class="paramname"><em>input_chan_bindings</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const gss_buffer_t </td>
<td class="paramname"><em>input_token</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gss_OID * </td>
<td class="paramname"><em>actual_mech_type</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gss_buffer_t </td>
<td class="paramname"><em>output_token</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">OM_uint32 * </td>
<td class="paramname"><em>ret_flags</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">OM_uint32 * </td>
<td class="paramname"><em>time_rec</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>As the initiator build a context with an acceptor.</p>
<p>Returns in the major</p><ul>
<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>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">minor_status</td><td>minor status code.</td></tr>
<tr><td class="paramname">initiator_cred_handle</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>
<tr><td class="paramname">context_handle</td><td>a pointer to a context handle, will be returned as long as there is not an error.</td></tr>
<tr><td class="paramname">target_name</td><td>the target name of acceptor, created using <a class="el" href="group__gssapi.html#ga0afe06fd5264ebfb93ecca4bcc70895b">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>
<tr><td class="paramname">input_mech_type</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>
<tr><td class="paramname">req_flags</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>
<tr><td class="paramname">time_req</td><td>time requested this context should be valid in seconds, common used value is GSS_C_INDEFINITE</td></tr>
<tr><td class="paramname">input_chan_bindings</td><td>Channel bindings used, if not exepected otherwise, used GSS_C_NO_CHANNEL_BINDINGS</td></tr>
<tr><td class="paramname">input_token</td><td>input token sent from the acceptor, for the initial packet the buffer of { NULL, 0 } should be used.</td></tr>
<tr><td class="paramname">actual_mech_type</td><td>the actual mech used, MUST NOT be freed since it pointing to static memory.</td></tr>
<tr><td class="paramname">output_token</td><td>if there is an output token, regardless of complete, continue_needed, or error it should be sent to the acceptor</td></tr>
<tr><td class="paramname">ret_flags</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>
<tr><td class="paramname">time_rec</td><td>amount of time this context is valid for</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>a gss_error code, see <a class="el" href="group__gssapi.html#ga770d87c1b80a58e91ec3a9ed70468122">gss_display_status()</a> about printing the error code. </dd></dl>
</div>
</div>
<a id="gaf472671a43512495de04ca0c69079e5d"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaf472671a43512495de04ca0c69079e5d">◆ </a></span>gss_inquire_attrs_for_mech()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">GSSAPI_LIB_FUNCTION OM_uint32 GSSAPI_LIB_CALL gss_inquire_attrs_for_mech </td>
<td>(</td>
<td class="paramtype">OM_uint32 * </td>
<td class="paramname"><em>minor_status</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gss_const_OID </td>
<td class="paramname"><em>mech</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gss_OID_set * </td>
<td class="paramname"><em>mech_attr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gss_OID_set * </td>
<td class="paramname"><em>known_mech_attrs</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>List support attributes for a mech and/or all mechanisms.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">minor_status</td><td>minor status code </td></tr>
<tr><td class="paramname">mech</td><td>given together with mech_attr will return the list of attributes for mechanism, can optionally be GSS_C_NO_OID. </td></tr>
<tr><td class="paramname">mech_attr</td><td>see mech parameter, can optionally be NULL, release with gss_release_oid_set(). </td></tr>
<tr><td class="paramname">known_mech_attrs</td><td>all attributes for mechanisms supported, release with gss_release_oid_set(). </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a id="gadc725eaf82322d8cf50812fc26442893"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gadc725eaf82322d8cf50812fc26442893">◆ </a></span>gss_inquire_saslname_for_mech()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">GSSAPI_LIB_FUNCTION OM_uint32 GSSAPI_LIB_CALL gss_inquire_saslname_for_mech </td>
<td>(</td>
<td class="paramtype">OM_uint32 * </td>
<td class="paramname"><em>minor_status</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const gss_OID </td>
<td class="paramname"><em>desired_mech</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gss_buffer_t </td>
<td class="paramname"><em>sasl_mech_name</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gss_buffer_t </td>
<td class="paramname"><em>mech_name</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gss_buffer_t </td>
<td class="paramname"><em>mech_description</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Returns different protocol names and description of the mechanism.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">minor_status</td><td>minor status code </td></tr>
<tr><td class="paramname">desired_mech</td><td>mech list query </td></tr>
<tr><td class="paramname">sasl_mech_name</td><td>SASL GS2 protocol name </td></tr>
<tr><td class="paramname">mech_name</td><td>gssapi protocol name </td></tr>
<tr><td class="paramname">mech_description</td><td>description of gssapi mech</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>returns GSS_S_COMPLETE or a error code. </dd></dl>
</div>
</div>
<a id="gac98677df7ae9bbc387cd68002a97ad15"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gac98677df7ae9bbc387cd68002a97ad15">◆ </a></span>gss_oid_equal()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">GSSAPI_LIB_FUNCTION int GSSAPI_LIB_CALL gss_oid_equal </td>
<td>(</td>
<td class="paramtype">gss_const_OID </td>
<td class="paramname"><em>a</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gss_const_OID </td>
<td class="paramname"><em>b</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Compare two GSS-API OIDs with each other.</p>
<p>GSS_C_NO_OID matches nothing, not even it-self.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">a</td><td>first oid to compare </td></tr>
<tr><td class="paramname">b</td><td>second oid to compare</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>non-zero when both oid are the same OID, zero when they are not the same. </dd></dl>
</div>
</div>
<a id="gad2990721c56fe83e06d45648874680d7"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gad2990721c56fe83e06d45648874680d7">◆ </a></span>gss_release_cred()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">GSSAPI_LIB_FUNCTION OM_uint32 GSSAPI_LIB_CALL gss_release_cred </td>
<td>(</td>
<td class="paramtype">OM_uint32 * </td>
<td class="paramname"><em>minor_status</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gss_cred_id_t * </td>
<td class="paramname"><em>cred_handle</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Release a credentials</p>
<p>Its 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>
<p>Example:</p>
<div class="fragment"><div class="line">gss_cred_id_t cred = GSS_C_NO_CREDENTIAL;</div>
<div class="line">major = <a class="code" href="group__gssapi.html#gad2990721c56fe83e06d45648874680d7">gss_release_cred</a>(&minor, &cred);</div>
<div class="ttc" id="agroup__gssapi_html_gad2990721c56fe83e06d45648874680d7"><div class="ttname"><a href="group__gssapi.html#gad2990721c56fe83e06d45648874680d7">gss_release_cred</a></div><div class="ttdeci">GSSAPI_LIB_FUNCTION OM_uint32 GSSAPI_LIB_CALL gss_release_cred(OM_uint32 *, gss_cred_id_t *)</div><div class="ttdef"><b>Definition:</b> gss_release_cred.c:54</div></div>
</div><!-- fragment --><dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">minor_status</td><td>minor status return code, mech specific </td></tr>
<tr><td class="paramname">cred_handle</td><td>a pointer to the credential too release</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>an gssapi error code </dd></dl>
</div>
</div>
<a id="ga2dbb20a4c9a3cf5072ef081cd37e54b4"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga2dbb20a4c9a3cf5072ef081cd37e54b4">◆ </a></span>gss_release_iov_buffer()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">GSSAPI_LIB_FUNCTION OM_uint32 GSSAPI_LIB_CALL gss_release_iov_buffer </td>
<td>(</td>
<td class="paramtype">OM_uint32 * </td>
<td class="paramname"><em>minor_status</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gss_iov_buffer_desc * </td>
<td class="paramname"><em>iov</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>iov_count</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Free all buffer allocated by <a class="el" href="group__gssapi.html#gab02ec963066cc8e5e6682799457208e9">gss_wrap_iov()</a> or <a class="el" href="group__gssapi.html#ga399bb326e47574aca7b28d6886d29fd0">gss_unwrap_iov()</a> by looking at the GSS_IOV_BUFFER_FLAG_ALLOCATED flag. </p>
</div>
</div>
<a id="ga0691190338f1f24170bd5f695ff1e721"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga0691190338f1f24170bd5f695ff1e721">◆ </a></span>gss_release_name()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">GSSAPI_LIB_FUNCTION OM_uint32 GSSAPI_LIB_CALL gss_release_name </td>
<td>(</td>
<td class="paramtype">OM_uint32 * </td>
<td class="paramname"><em>minor_status</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gss_name_t * </td>
<td class="paramname"><em>input_name</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Free a name</p>
<p>import_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>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">minor_status</td><td>minor status code </td></tr>
<tr><td class="paramname">input_name</td><td>name to free</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>a gss_error code, see <a class="el" href="group__gssapi.html#ga770d87c1b80a58e91ec3a9ed70468122">gss_display_status()</a> about printing the error code. </dd></dl>
</div>
</div>
<a id="ga399bb326e47574aca7b28d6886d29fd0"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga399bb326e47574aca7b28d6886d29fd0">◆ </a></span>gss_unwrap_iov()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">GSSAPI_LIB_FUNCTION OM_uint32 GSSAPI_LIB_CALL gss_unwrap_iov </td>
<td>(</td>
<td class="paramtype">OM_uint32 * </td>
<td class="paramname"><em>minor_status</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gss_ctx_id_t </td>
<td class="paramname"><em>context_handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int * </td>
<td class="paramname"><em>conf_state</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gss_qop_t * </td>
<td class="paramname"><em>qop_state</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gss_iov_buffer_desc * </td>
<td class="paramname"><em>iov</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>iov_count</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Decrypt or verifies the signature on the data. </p>
</div>
</div>
<a id="ga4058cf5c3b04fd25f8339c71dd5e964c"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga4058cf5c3b04fd25f8339c71dd5e964c">◆ </a></span>gss_wrap()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">GSSAPI_LIB_FUNCTION OM_uint32 GSSAPI_LIB_CALL gss_wrap </td>
<td>(</td>
<td class="paramtype">OM_uint32 * </td>
<td class="paramname"><em>minor_status</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gss_const_ctx_id_t </td>
<td class="paramname"><em>context_handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>conf_req_flag</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gss_qop_t </td>
<td class="paramname"><em>qop_req</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const gss_buffer_t </td>
<td class="paramname"><em>input_message_buffer</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int * </td>
<td class="paramname"><em>conf_state</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gss_buffer_t </td>
<td class="paramname"><em>output_message_buffer</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Wrap a message using either confidentiality (encryption + signature) or sealing (signature).</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">minor_status</td><td>minor status code. </td></tr>
<tr><td class="paramname">context_handle</td><td>context handle. </td></tr>
<tr><td class="paramname">conf_req_flag</td><td>if non zero, confidentiality is requestd. </td></tr>
<tr><td class="paramname">qop_req</td><td>type of protection needed, in most cases it GSS_C_QOP_DEFAULT should be passed in. </td></tr>
<tr><td class="paramname">input_message_buffer</td><td>messages to wrap </td></tr>
<tr><td class="paramname">conf_state</td><td>returns non zero if confidentiality was honoured. </td></tr>
<tr><td class="paramname">output_message_buffer</td><td>the resulting buffer, release with gss_release_buffer(). </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a id="gab02ec963066cc8e5e6682799457208e9"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gab02ec963066cc8e5e6682799457208e9">◆ </a></span>gss_wrap_iov()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">GSSAPI_LIB_FUNCTION OM_uint32 GSSAPI_LIB_CALL gss_wrap_iov </td>
<td>(</td>
<td class="paramtype">OM_uint32 * </td>
<td class="paramname"><em>minor_status</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gss_ctx_id_t </td>
<td class="paramname"><em>context_handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>conf_req_flag</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gss_qop_t </td>
<td class="paramname"><em>qop_req</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int * </td>
<td class="paramname"><em>conf_state</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gss_iov_buffer_desc * </td>
<td class="paramname"><em>iov</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>iov_count</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Encrypts or sign the data.</p>
<p>This is a more complicated version of <a class="el" href="group__gssapi.html#ga4058cf5c3b04fd25f8339c71dd5e964c">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>
<p>The maximum packet size is gss_context_stream_sizes.max_msg_size.</p>
<p>The caller needs provide the folloing buffers when using in conf_req_flag=1 mode:</p>
<ul>
<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>
<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>
<p>HEADER, PADDING, TRAILER will be shrunken to the size required to transmit any of them too large.</p>
<p>To generate <a class="el" href="group__gssapi.html#ga4058cf5c3b04fd25f8339c71dd5e964c">gss_wrap()</a> compatible packets, use: HEADER | DATA | PADDING | TRAILER</p>
<p>When used in conf_req_flag=0,</p>
<ul>
<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>
<p>The input sizes of HEADER, PADDING and TRAILER can be fetched using <a class="el" href="group__gssapi.html#ga6216cfcb1ba8dc2d1a1d680d21752f26">gss_wrap_iov_length()</a> or gss_context_query_attributes(). </p>
</div>
</div>
<a id="ga6216cfcb1ba8dc2d1a1d680d21752f26"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga6216cfcb1ba8dc2d1a1d680d21752f26">◆ </a></span>gss_wrap_iov_length()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">GSSAPI_LIB_FUNCTION OM_uint32 GSSAPI_LIB_CALL gss_wrap_iov_length </td>
<td>(</td>
<td class="paramtype">OM_uint32 * </td>
<td class="paramname"><em>minor_status</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gss_ctx_id_t </td>
<td class="paramname"><em>context_handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>conf_req_flag</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gss_qop_t </td>
<td class="paramname"><em>qop_req</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int * </td>
<td class="paramname"><em>conf_state</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">gss_iov_buffer_desc * </td>
<td class="paramname"><em>iov</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>iov_count</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Update the length fields in iov buffer for the types:</p><ul>
<li>GSS_IOV_BUFFER_TYPE_HEADER</li>
<li>GSS_IOV_BUFFER_TYPE_PADDING</li>
<li>GSS_IOV_BUFFER_TYPE_TRAILER</li>
</ul>
<p>Consider using gss_context_query_attributes() to fetch the data instead. </p>
</div>
</div>
<h2 class="groupheader">Variable Documentation</h2>
<a id="ga961f7a7f9f92e06b91c6d503e524a672"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga961f7a7f9f92e06b91c6d503e524a672">◆ </a></span>__gss_c_attr_stream_sizes_oid_desc</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">gss_OID_desc GSSAPI_LIB_FUNCTION __gss_c_attr_stream_sizes_oid_desc</td>
</tr>
</table>
</div><div class="memdoc">
<b>Initial value:</b><div class="fragment"><div class="line">=</div>
<div class="line"> {10, rk_UNCONST(<span class="stringliteral">"\x2a\x86\x48\x86\xf7\x12\x01\x02\x01\x03"</span>)}</div>
</div><!-- fragment --><p>Query the context for parameters.</p>
<p>SSPI equivalent if this function is QueryContextAttributes.</p>
<ul>
<li>GSS_C_ATTR_STREAM_SIZES data is a gss_context_stream_sizes. </li>
</ul>
</div>
</div>
</div><!-- contents -->
<hr size="1"><address style="text-align: right;"><small>
Generated on Tue Nov 15 2022 14:04:25 for Heimdal GSS-API library by <a href="http://www.doxygen.org/index.html"><img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.9.1</small></address>
</body>
</html>