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.