libssh2_sftp_last_error(3)

💖 libssh2_sftp_last_error — the libssh2 manual, bestie edition 💖

okay so real talk, this one lives in the libssh2 manual set, and it's a tiny lil function with a big "read the fine print" energy. let's get into it 🫶

✨ NAME ✨

libssh2_sftp_last_error — returns the last SFTP-specific error code, no cap

🌸 SYNOPSIS 🌸

#include <libssh2.h>
#include <libssh2_sftp.h>

unsigned long
libssh2_sftp_last_error(LIBSSH2_SFTP *sftp);

🦋 DESCRIPTION 🦋

• sftp — your SFTP instance, aka the thing libssh2_sftp_init(3) handed you back. that's the whole vibe.

so what does it do? it returns the last error code produced by the SFTP layer. that's it. that's the girl. 💅

🚨 BUT. and this is the important part, bestie, do not skip it: this only gives you a sensible error code if libssh2 previously returned LIBSSH2_ERROR_SFTP_PROTOCOL in an earlier call. that's the condition. that's the whole thing.

and if you call libssh2_sftp_last_error(3) without a preceding SFTP protocol error? it will return an unspecified value. not a real answer. not useful. just vibes. so don't be out here reading tea leaves, okay? 🙈

⭐ RETURN VALUE ⭐

the current error code state of the SFTP instance. that's the return, periodt. 👑

🎀 SEE ALSO 🎀

• libssh2_sftp_init(3)

and that's the whole page, bestie!! slay ✨ this was written for libssh2 0.15, dated 1 Jun 2007 — yeah, she's an elder icon, been serving since before most of us could read, and she still ate 💖🦋🌸

mwah, go forth and check your error codes responsibly 🫶💅