NAME

       libssh2_trace_sethandler - set a trace output handler

SYNOPSIS

       #include <libssh2.h>

       typedef void (*libssh2_trace_handler_func)(LIBSSH2_SESSION *session,
                                                  void* context,
                                                  const char *data,
                                                  size_t length);

       int libssh2_trace_sethandler(LIBSSH2_SESSION *session,
                                    void* context,
                                    libssh2_trace_handler_func callback);

DESCRIPTION

       libssh2_trace_sethandler  installs a trace output handler for your application.  By default, when tracing
       has been switched on via a call to libssh2_trace(), all output is written to  stderr.   By  calling  this
       method and passing a function pointer that matches the libssh2_trace_handler_func prototype, libssh2 will
       call back as it generates trace output.  This can be used to capture the trace output and put it  into  a
       log  file  or  diagnostic  window.   This function has no effect unless libssh2 was built to support this
       option, and a typical "release build" might not.

       context can be used to pass arbitrary user defined data back into the callback when invoked.

AVAILABILITY

       Added in libssh2 version 1.2.3