gsasl_server_callback_securid_set

Section: gsasl (3)
Updated: 1.8.0
Index Return to Main Contents

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.