libssh2_trace(3)

libssh2_trace3

Enable debug info from inside libssh2

Usage

#include <libssh2.h>
void
libssh2_trace(LIBSSH2_SESSION *session, int bitmask);

Overview

This is a function present in the library that can be used to get debug info from within libssh2 when it is running. Helpful when trying to trace or debug behaviors. Note that this function has no effect unless libssh2 was built to support tracing! It is usually disabled in release builds.

bitmask can be set to the logical OR of none, one or more of these:

LIBSSH2_TRACE_SOCKET

Socket low-level debugging

LIBSSH2_TRACE_TRANS

Transport layer debugging

LIBSSH2_TRACE_KEX

Key exchange debugging

LIBSSH2_TRACE_AUTH

Authentication debugging

LIBSSH2_TRACE_CONN

Connection layer debugging

LIBSSH2_TRACE_SCP

SCP debugging

LIBSSH2_TRACE_SFTP

SFTP debugging

LIBSSH2_TRACE_ERROR

Error debugging

LIBSSH2_TRACE_PUBLICKEY

Public Key debugging

Releases

9 releases since Debian 6.0 (Squeeze); the text changed 2 times.

  1. 6.0
  2. 7–12
  3. 13–Arch

From libssh2 1.11.1-7 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.