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