libssh2_trace(3)

✨ libssh2_trace — bestie edition ✨

okay so this is a page from the libssh2 manual, and today we're doing libssh2_trace(3). yes queen, we're getting into the debug guts 💅

🎀 NAME 🎀

libssh2_trace — enable debug info from inside libssh2

🌸 SYNOPSIS 🌸

#include <libssh2.h>

void
libssh2_trace(LIBSSH2_SESSION *session, int bitmask);

🦋 DESCRIPTION 🦋

okay so listen. this is a function that literally lives inside the library, and its whole job is to hand you debug info from within libssh2 while it's running. it's giving "backstage pass to the vibes". super helpful when you're trying to trace stuff or debug behaviors, like when something's acting up and you're just sitting there like 😭 why.

🚨 huge caveat, do not skip this one bestie: this function has no effect unless libssh2 was built to support tracing! it is usually disabled in release builds. so if you're calling it and getting absolutely nothing, that's not you, that's the build. no cap.

so 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 🗝️

and that's the whole page, bestie. every flag, every word, nothing skipped, periodt. 💖

this was libssh2 1.0, dated 26 Dec 2008, and the page you just read is libssh2_trace(3). slay, go trace something 🫶✨