---
name: "gss_verify_mic"
section: "3"
platform: "linux"
package: "gss-man"
version: "1.0.4-4"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/gss_verify_mic"
---

# gss\_verify\_mic(3)

API function

## NAME

gss\_verify\_mic - API function

## SYNOPSIS

**#include \<gss.h\>**

**OM\_uint32 gss\_verify\_mic(OM\_uint32 \*** *minor\_status***, const gss\_ctx\_id\_t** *context\_handle***, const gss\_buffer\_t** *message\_buffer***, const gss\_buffer\_t** *token\_buffer***, gss\_qop\_t \*** *qop\_state***);**

## ARGUMENTS

- OM\_uint32 \* minor\_status

  (Integer, modify) Mechanism specific status code.

- const gss\_ctx\_id\_t context\_handle

  (gss\_ctx\_id\_t, read) Identifies the context on\
     which the message arrived.

- const gss\_buffer\_t message\_buffer

  (buffer, opaque, read) Message to be verified.

- const gss\_buffer\_t token\_buffer

  (buffer, opaque, read) Token associated with\
     message.

- gss\_qop\_t \* qop\_state

  (gss\_qop\_t, modify, optional) Quality of protection\
     gained from MIC Specify NULL if not required.

## DESCRIPTION

Verifies that a cryptographic MIC, contained in the token parameter, fits the supplied message.  The qop\_state parameter allows a message recipient to determine the strength of protection that was applied to the message.

Since some application-level protocols may wish to use tokens emitted by **gss\_wrap()** to provide "secure framing", implementations must support the calculation and verification of MICs over zero-length messages.

## RETURN VALUE

\`GSS\_S\_COMPLETE\`: Successful completion.

\`GSS\_S\_DEFECTIVE\_TOKEN\`: The token failed consistency checks.

\`GSS\_S\_BAD\_SIG\`: The MIC was incorrect.

\`GSS\_S\_DUPLICATE\_TOKEN\`: The token was valid, and contained a correct MIC for the message, but it had already been processed.

\`GSS\_S\_OLD\_TOKEN\`: The token was valid, and contained a correct MIC for the message, but it is too old to check for duplication.

\`GSS\_S\_UNSEQ\_TOKEN\`: 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.

\`GSS\_S\_GAP\_TOKEN\`: 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.

\`GSS\_S\_CONTEXT\_EXPIRED\`: The context has already expired.

\`GSS\_S\_NO\_CONTEXT\`: The context\_handle parameter did not identify a valid context.

## REPORTING BUGS

Report bugs to \<bug-gss@gnu.org\>. GNU Generic Security Service home page: http://www.gnu.org/software/gss/ General help using GNU software: http://www.gnu.org/gethelp/

## COPYRIGHT

Copyright © 2003-2022 Simon Josefsson.\
 Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved.

## SEE ALSO

The full documentation for **gss** is maintained as a Texinfo manual.  If the **info** and **gss** programs are properly installed at your site, the command

-

  **info gss**

should give you access to the complete manual.