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.