bionic (3) gsasl_server_callback_securid_set.3.gz

Provided by: libgsasl7-dev_1.8.0-8ubuntu3_amd64 bug

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 © 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.