gsasl_callback_set

Section: gsasl (3)
Updated: 1.8.0
Index Return to Main Contents

NAME

gsasl_callback_set - API function

SYNOPSIS

#include <gsasl.h>

void gsasl_callback_set(Gsasl * ctx, Gsasl_callback_function cb);

ARGUMENTS

Gsasl * ctx: handle received from gsasl_init().
Gsasl_callback_function cb: pointer to function implemented by application.

DESCRIPTION

Store the pointer to the application provided callback in the library handle. The callback will be used, via gsasl_callback(), by mechanisms to discover various parameters (such as username and passwords). The callback function will be called with a Gsasl_property value indicating the requested behaviour. For example, for GSASL_ANONYMOUS_TOKEN, the function is expected to invoke gsasl_property_set(CTX, 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.

SINCE

0.2.0

REPORTING BUGS

Report bugs to <bug-gsasl@gnu.org>. GNU SASL home page: http://www.gnu.org/software/gsasl/ General help using GNU software: http://www.gnu.org/gethelp/

COPYRIGHT

Copyright © 2002-2012 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.