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-2025 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/