---
name: "gsasl_callback"
section: "3"
platform: "linux"
package: "gsasl"
version: "2.2.4-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/gsasl_callback"
---

# gsasl\_callback(3)

API function

## NAME

gsasl\_callback - API function

## SYNOPSIS

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

**int gsasl\_callback(Gsasl \*** *ctx***, Gsasl\_session \*** *sctx***, Gsasl\_property** *prop***);**

## ARGUMENTS

- Gsasl \* ctx

  handle received from **gsasl\_init()**, may be NULL to derive it from  *sctx* .

- Gsasl\_session \* sctx

  session handle.

- Gsasl\_property prop

  enumerated value of Gsasl\_property type.

## DESCRIPTION

Invoke the application callback.  The  *prop* value indicate what the callback is expected to do.  For example, for **GSASL\_ANONYMOUS\_TOKEN**, the function is expected to invoke gsasl\_property\_set( *SCTX* , **GSASL\_ANONYMOUS\_TOKEN**, "token") where "token" is the anonymous token the application wishes the SASL mechanism to use.  See the manual for the meaning of all parameters.

Return value: Returns whatever the application callback returns, or **GSASL\_NO\_CALLBACK** if no application was known.

## SINCE

0\.2.0

## REPORTING BUGS

Report bugs to \<bug-gsasl@gnu.org\>.\
 General guidelines for reporting bugs: https://www.gnu.org/gethelp/\
 GNU SASL home page: https://www.gnu.org/software/gsasl/

## COPYRIGHT

Copyright © 2002-2026 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 **gsasl** is maintained as a Texinfo manual.  If the **info** and **gsasl** programs are properly installed at your site, the command

-

  **info gsasl**

should give you access to the complete manual. As an alternative you may obtain the manual from:

-

  **https://www.gnu.org/software/libidn/gsasl/manual/**