---
name: "gss_decapsulate_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_decapsulate_token"
---

# gss\_decapsulate\_token(3)

API function

## NAME

gss\_decapsulate\_token - API function

## SYNOPSIS

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

**OM\_uint32 gss\_decapsulate\_token(gss\_const\_buffer\_t** *input\_token***, gss\_const\_OID** *token\_oid***, gss\_buffer\_t** *output\_token***);**

## ARGUMENTS

- gss\_const\_buffer\_t input\_token

  (buffer, opaque, read) Buffer with GSS-API context token.

- gss\_const\_OID token\_oid

  (Object ID, read) Expected object identifier of token.

- gss\_buffer\_t output\_token

  (buffer, opaque, modify) Decapsulated token data;\
     caller must release with **gss\_release\_buffer()**.

## DESCRIPTION

Remove the mechanism-independent token header from an initial GSS-API context token.  Unwrap a buffer in the mechanism-independent token format.  This is the reverse of **gss\_encapsulate\_token()**.  The translation is loss-less, all data is preserved as is.  This function is standardized in RFC 6339.

## RETURN VALUE

\`GSS\_S\_COMPLETE\`: Indicates successful completion, and that output parameters holds correct information.

\`GSS\_S\_DEFECTIVE\_TOKEN\`: Means that the token failed consistency checks (e.g., OID mismatch or ASN.1 DER length errors).

\`GSS\_S\_FAILURE\`: Indicates that decapsulation failed for reasons unspecified at the GSS-API level.

## 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.