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

# gss\_process\_context\_token(3)

API function

## NAME

gss\_process\_context\_token - API function

## SYNOPSIS

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

**OM\_uint32 gss\_process\_context\_token(OM\_uint32 \*** *minor\_status***, const gss\_ctx\_id\_t** *context\_handle***, const gss\_buffer\_t** *token\_buffer***);**

## ARGUMENTS

- OM\_uint32 \* minor\_status

  (Integer, modify) Implementation specific status code.

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

  (gss\_ctx\_id\_t, read) Context handle of context on\
     which token is to be processed

- const gss\_buffer\_t token\_buffer

  (buffer, opaque, read) Token to process.

## DESCRIPTION

Provides a way to pass an asynchronous token to the security service.  Most context-level tokens are emitted and processed synchronously by gss\_init\_sec\_context and gss\_accept\_sec\_context, and the application is informed as to whether further tokens are expected by the GSS\_C\_CONTINUE\_NEEDED major status bit. Occasionally, a mechanism may need to emit a context-level token at a point when the peer entity is not expecting a token.  For example, the initiator's final call to gss\_init\_sec\_context may emit a token and return a status of GSS\_S\_COMPLETE, but the acceptor's call to gss\_accept\_sec\_context may fail.  The acceptor's mechanism may wish to send a token containing an error indication to the initiator, but the initiator is not expecting a token at this point, believing that the context is fully established. Gss\_process\_context\_token provides a way to pass such a token to the mechanism at any time.

## RETURN VALUE

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

\`GSS\_S\_DEFECTIVE\_TOKEN\`: Indicates that consistency checks performed on the token failed.

\`GSS\_S\_NO\_CONTEXT\`: The context\_handle did not refer to 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.