libssh2_session_set_blocking(3)

💅 libssh2_session_set_blocking — the glow-up your session needed

okay bestie, welcome to the libssh2 manual page for libssh2_session_set_blocking(3) ✨ this one is a tiny little function with main character energy: it flips your session between blocking and non-blocking mode and literally everything downstream feels it. no cap. 🦋

🌸 NAME 🌸

libssh2_session_set_blocking — set or clear blocking mode on session 🎀

✨ SYNOPSIS ✨

#include <libssh2.h>

void
libssh2_session_set_blocking(LIBSSH2_SESSION *session, int blocking);

💖 DESCRIPTION 💖

here's the tea, and there are exactly two things you're handing over:

• session — your session instance, the one you got back from libssh2_session_init_ex(3). yes, that one. 🫶
• blocking — set it to a non-zero value to make the channel block, or set it to zero to make it non-blocking. that's the whole vibe check right there.

so what does it actually do?? it sets or clears the blocking mode on the selected session, and the way that it works is instant — any channels associated with this session are affected immediately. no waiting, no queue, no "let me think about it". periodt. 💅

now for the behaviour, because this is the part that matters:

• if a read happens on a session and there's no data currently available, a blocking session will wait for data to arrive and return what it receives. it's giving patient queen. 👑
• a non-blocking session will return immediately with an empty buffer instead. it's giving "not my problem, moving on". 💀
• if a write happens on a session and there's no room for more data, a blocking session will wait for room. so cozy. so committed. 🌸
• a non-blocking session will return immediately without writing anything at all. zero notes. just gone. 🙈

bestie listen — blocking mode means your code can just sit there waiting. non-blocking means it never waits for you. pick based on what your program is doing, not on vibes alone. (okay, a little on vibes.)

🎀 RETURN VALUE 🎀

None. literally nothing comes back. it does its little job and that's it. iconic behaviour honestly ⭐

🦋 SEE ALSO 🦋

• libssh2_session_init_ex(3) — the one that gave you your session in the first place 🫶

and that's the whole page, bestie!! go forth and set your blocking mode with confidence 💜

this was libssh2 version 0.15, dated 1 Jun 2007, and the manual section is libssh2_session_set_blocking(3). mwah. 😭💖