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.

       Note that if no callback has been set by the application, but the obsolete callback  interface  has  been
       used,  this  function  will  translate the old callback interface into the new.  This interface should be
       sufficient to invoke all callbacks, both new and old.

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

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.

gsasl                                                 1.8.0                                    gsasl_callback(3)