DragonFly On-Line Manual Pages

gsasl_server_callback_securid_set(3)                                     gsasl

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 (C) 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_server_callback_securid_set(3)