gensio_accepter_event(3) | Library Functions Manual | gensio_accepter_event(3) |
gensio_accepter_event - Event handler for events from a gensio
#include <gensio/gensio.h>
When an event happens on a gensio accepter that is reported to the user, the gensio library calls the gensio_accepter_event type handler that was registered with the gensio accepter.
The use of the various parameters depends on the particular event. The parameters that don't vary are:
Events follow.
Got a new connection on the accepter. data points to the new gensio.
The gensio accepter had an issue that wouldn't otherwise be reported as an error return. data points to a struct gensio_loginfo.
Called right before certificate verification on a new incoming connection. See GENSIO_EVENT_PRECERT_VERIFY in gensio_event(3) for details. data points to the new gensio object. Note that this gensio has not yet been reported in a new connection.
Called at the start of an authorization process for a new connection. See GENSIO_EVENT_AUTH_BEGIN in gensio_event(3) for details. data points to the new gensio object. Note that this gensio has not yet been reported in a new connection.
A server gensio has received a password that requires verification. The gensio handlers do not actually verify the passwords, they transfer them and provide them for the user to verify. data points to a struct gensio_acc_password_verify_data that holds the new gensio and the password information. See GENSIO_EVENT_PASSWORD_VERIFY in gensio_event(3) for details.
A remote server gensio has requested that a password be sent for verification data points to a struct gensio_acc_password_verify_data that holds the new gensio and the password information. See GENSIO_EVENT_REQUEST_PASSWORD in gensio_event(3) for details.
A server gensio has finished certificate verification (and has not done any password verification). data points to a struct gensio_acc_postcert_verify_data that holds the new gensio and error information. See GENSIO_EVENT_POSTCERT_VERIFY in gensio_event(3) for details.
Other gensio accepters that are not part of the gensio library proper may have their own events, too.
See the individual events for the values you should return. If an event is not handled by the event handler, the handler must return GE_NOTSUP, except in the case of GENSIO_ACC_EVENT_NEW_CONNECTION which must be handled.
gensio_err(3), gensio(5), gensio_event(3), gensio_acc_set_callback(3), str_to_gensio_accepter(3)
27 Feb 2019 |