gss_get_mic(3) gss_get_mic(3)
NAME [Toc] [Back]
gss_get_mic() - calculate a cryptographic message integrity code (MIC)
for a message and return in a token
SYNOPSIS [Toc] [Back]
#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 [Toc] [Back]
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 [Toc] [Back]
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 [Toc] [Back]
msg_token Buffer to receive the sealed message.
minor_status Returns a status code from the security
mechanism.
STATUS CODES [Toc] [Back]
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 [Toc] [Back]
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.
Hewlett-Packard Company - 1 - HP-UX 11i Version 2: August 2003
gss_get_mic(3) gss_get_mic(3)
GSS_S_BAD_QOP The specified QOP is not supported by the
mechanism.
AUTHOR [Toc] [Back]
gss_get_mic() was developed by Sun Microsystems, Inc.
SEE ALSO [Toc] [Back]
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.
Hewlett-Packard Company - 2 - HP-UX 11i Version 2: August 2003 [ Back ] |
