Document some GSS-API functions and fix some spelling errors. No code changes.

Signed-off-by: Love Hornquist Astrand <lha@h5l.org>
This commit is contained in:
Marco Molteni
2012-09-25 10:05:34 +02:00
committed by Love Hornquist Astrand
parent b0b94a445a
commit 8cc9326f64
5 changed files with 74 additions and 20 deletions

View File

@@ -134,25 +134,43 @@ supplementary_error(OM_uint32 v)
return msgs[v];
}
/**
* Convert a GSS-API status code to text
*
* @param minor_status minor status code
* @param status_value status value to convert
* @param status_type One of:
* GSS_C_GSS_CODE - status_value is a GSS status code,
* GSS_C_MECH_CODE - status_value is a mechanism status code
* @param mech_type underlying mechanism. Use GSS_C_NO_OID to obtain the
* system default.
* @param message_context state information to extract further messages from the
* status_value
* @param status_string the allocated text representation. Release with
* gss_release_buffer()
*
* @returns a gss_error code.
*
* @ingroup gssapi
*/
GSSAPI_LIB_FUNCTION OM_uint32 GSSAPI_LIB_CALL
gss_display_status(OM_uint32 *minor_status,
OM_uint32 status_value,
int status_type,
const gss_OID mech_type,
OM_uint32 *message_content,
OM_uint32 *message_context,
gss_buffer_t status_string)
{
OM_uint32 major_status;
_mg_buffer_zero(status_string);
*message_content = 0;
*message_context = 0;
major_status = _gss_mg_get_error(mech_type, status_type,
status_value, status_string);
if (major_status == GSS_S_COMPLETE) {
*message_content = 0;
*message_context = 0;
*minor_status = 0;
return GSS_S_COMPLETE;
}