gss_verify_mic(3)gss_verify_mic(3)NAMEgss_verify_mic() - check a cryptographic message integrity code (MIC)
against a message to verify its integrity
SYNOPSISDESCRIPTION
The routine verifies that a cryptographic MIC, contained in the
token_buffer parameter, fits the supplied message. The application
receiving the message can use the qop_state parameter to check the
strength of protection.
Input Parameters
context_handle Specifies the context on which the message
arrived.
message_buffer Specifies the message to be verified.
token_buffer Specifies the token to be associated with the
message.
Output Parameters
qop_state Returns the quality of protection gained from
message integrity code (MIC). Specify NULL if
not required.
minor_status Returns a status code from the security mecha‐
nism.
STATUS CODES
The following status codes can be returned:
The routine was completed successfully.
The token failed consistency checks.
The MIC was incorrect.
The token was valid, and contained a correct
MIC for the message, but it had already been
processed.
The token was valid, and contained a correct
MIC for the message, but it is too old.
The token was valid, and contained a correct MIC
for the message, but has been verified out of
sequence. A later token has already been
received.
The token was valid, and contained a correct MIC
for the message, but has been verified out of
sequence. An earlier expected token has not
yet been received.
The context has already expired.
The routine failed. Check the
minor_status parameter for details.
The context identified in the
context_handle parameter was not valid.
AUTHOR
was developed by Sun Microsystems, Inc.
SEE ALSOgss_get_mic(3), gss_wrap(3).
The manpages for DCE-GSSAPI are included with the DCE-CoreTools prod‐
uct. To see those manpages add to
gss_verify_mic(3)