.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gsasl_server_callback_securid_set" 3 "1.10.0" "gsasl" "gsasl" .SH NAME gsasl_server_callback_securid_set \- API function .SH SYNOPSIS .B #include .sp .BI "void gsasl_server_callback_securid_set(Gsasl * " ctx ", Gsasl_server_callback_securid " cb ");" .SH ARGUMENTS .IP "Gsasl * ctx" 12 libgsasl handle. .IP "Gsasl_server_callback_securid cb" 12 callback function .SH "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 \fBgsasl_server_callback_securid_get()\fP. .SH "DEPRECATED" This function is part of the old callback interface. The new interface uses \fBgsasl_callback_set()\fP to set the application callback, and uses \fBgsasl_callback()\fP or \fBgsasl_property_get()\fP to invoke the callback for certain properties. .SH "REPORTING BUGS" Report bugs to . .br General guidelines for reporting bugs: http://www.gnu.org/gethelp/ .br GNU SASL home page: http://www.gnu.org/software/gsasl/ .SH COPYRIGHT Copyright \(co 2002-2021 Simon Josefsson. .br 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. .SH "SEE ALSO" The full documentation for .B gsasl is maintained as a Texinfo manual. If the .B info and .B gsasl programs are properly installed at your site, the command .IP .B info gsasl .PP should give you access to the complete manual. As an alternative you may obtain the manual from: .IP .B http://www.gnu.org/software/gsasl/manual/ .PP