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
Specifies the context on which the message is sent.
- qop_req
Specifies 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
Specifies 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 identified in the
context_handle
parameter was not valid.
- GSS_S_BAD_QOP
The specified QOP is not supported by the mechanism.
AUTHOR
gss_get_mic()
was developed by Sun Microsystems, Inc.
SEE ALSO
gss_verify_mic(3).
The manpages for DCE-GSSAPI are included with the DCE-CoreTools product.
To see those manpages add
/opt/dce/share/man
to
MANPATH.