gsasl_callback

Langue: en

Autres versions - même langue

Version: 0.2.26 (ubuntu - 07/07/09)

Section: 3 (Bibliothèques de fonctions)

Sommaire

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 return, or GSASL_NO_CALLBACK if no application was known.

SINCE

0.2.0

REPORTING BUGS

Report bugs to <bug-gsasl@gnu.org>. Copyright © 2002, 2003, 2004, 2005, 2006, 2007, 2008 Simon Josefsson.
Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are preserved on all copies.

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.