libssh2_userau...tbased_fromfile(3)

💖 libssh2_userauth_hostbased_fromfile — the girlies' guide 💖

okay bestie, so this one lives in the libssh2 manual, and it's honestly the shortest little baddie you'll ever meet. no cap. 🎀

✨ NAME ✨

libssh2_userauth_hostbased_fromfile — it's giving "convenience macro", and it exists purely to make calls to libssh2_userauth_hostbased_fromfile_ex(3) easier. that's the whole vibe. 🦋

✨ SYNOPSIS ✨

#include <libssh2.h>

int
libssh2_userauth_hostbased_fromfile(LIBSSH2_SESSION *session,
                                    const char *username,
                                    const char *publickey,
                                    const char *privatekey,
                                    const char *passphrase,
                                    const char *hostname);

look at that parameter list. six little arguments, all lined up, main character energy. 💅

✨ DESCRIPTION ✨

so here's the tea 🍓: this is not a full-blown function, bestie. it's a macro — and it's defined in a public libssh2 header file, so it's just sitting there ready for you. and what does that macro do? it's out here using the underlying function libssh2_userauth_hostbased_fromfile_ex(3). that's it. that's the whole job. the macro is the cute little wrapper, the _ex function is the one doing the actual heavy lifting. iykyk. ✨

✨ RETURN VALUE ✨

ngl, this one doesn't do its own thing here — it says See libssh2_userauth_hostbased_fromfile_ex(3). go peek at that page, it's got the answers. 👑

✨ ERRORS ✨

same situation, bestie — See libssh2_userauth_hostbased_fromfile_ex(3). the _ex page is holding all the error lore. 🫶

✨ SEE ALSO ✨

• libssh2_userauth_hostbased_fromfile_ex(3) — the icon, the blueprint, the one this macro is obsessed with 💖

real talk: since this page keeps pointing you at libssh2_userauth_hostbased_fromfile_ex(3) for the return values and the errors, that page is your actual bestie for the details. this one's just the intro. 🙈

mwah 💋 that's the whole page, and it came straight out of libssh2 1.2.4, dated 20 Feb 2010. slay, you're done, go read the _ex page now ✨💜