HP-UX Reference (11i v1 05/09) - 3 Library Functions A-M (vol 6)

gss_get_mic(3) gss_get_mic(3)

NAME

gss_get_mic() - calculate a cryptographic message integrity code (MIC) for a message and return in a token

SYNOPSIS

#include <gssapi.h>

OM_uint32 gss_get_mic (

OM_uint32 *minor_status,

const gss_ctx_id_t context_handle,

gss_qop_t qop_req,

const gss_buffer_t message_buffer,

gss_buffer_t msg_token)

DESCRIPTION

The gss_get_mic()

routine generates a cryptographic message integrity code (MIC) for the supplied

message and places the MIC in a token for transfer to the peer application. The qop_req parameter allows

a choice between several cryptographic algorithms, if supported by the chosen mechanism.

Input Parameters

context_handle Speciﬁes the context on which the message is sent.

qop_req Speciﬁes the cryptographic algorithm, or quality of protection. To accept the default

quality of protection offered by the chosen mechanism specify

GSS_C_QOP_DEFAULT

message_buffer Speciﬁes the message to be protected.

Output Parameters

msg_token Buffer to receive the sealed message.

minor_status Returns a status code from the security mechanism.

STATUS CODES

The following status codes can be returned:

GSS_S_COMPLETE The routine was completed successfully.

GSS_S_CONTEXT_EXPIRED

The context has already expired.

GSS_S_CREDENTIALS_EXPIRED

The context is recognized but the associated credentials have expired.

GSS_S_NO_CONTEXT

The context identiﬁed in the context_handle parameter was not valid.

GSS_S_BAD_QOP The speciﬁed QOP is not supported by the mechanism.

AUTHOR

gss_get_mic() was developed by Sun Microsystems, Inc.