NAME¶
gsasl_server_callback_securid_set - API function
SYNOPSIS¶
#include <gsasl.h>
void gsasl_server_callback_securid_set(Gsasl * ctx,
Gsasl_server_callback_securid cb);
ARGUMENTS¶
- Gsasl * ctx
- libgsasl handle.
- Gsasl_server_callback_securid cb
- callback function
DESCRIPTION¶
Specify the callback function to use in the server for validating a user via the
SECURID mechanism. The function should return GSASL_OK if user authenticated
successfully, GSASL_SECURID_SERVER_NEED_ADDITIONAL_PASSCODE if it wants
another passcode, GSASL_SECURID_SERVER_NEED_NEW_PIN if it wants a PIN change,
or an error. When (and only when) GSASL_SECURID_SERVER_NEED_NEW_PIN is
returned, suggestpin can be populated with a PIN code the server suggests, and
suggestpinlen set to the length of the PIN. The function can be later
retrieved using
gsasl_server_callback_securid_get().
DEPRECATED¶
This function is part of the old callback interface. The new interface uses
gsasl_callback_set() to set the application callback, and uses
gsasl_callback() or
gsasl_property_get() to invoke the callback
for certain properties.
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.