libssh2_userauth_publickey(3)

💅 libssh2_userauth_publickey — bestie, we're logging in with a callback

okay so real talk: this page lives in the libssh2 manual, and it's about authenticating with a public key, except instead of handing over a file path you hand over a callback function that does the signing for you. main character energy honestly 🫶

✨ NAME ✨

libssh2_userauth_publickey — authenticate using a callback function

🌸 SYNOPSIS 🌸

#include <libssh2.h>

int
libssh2_userauth_publickey(LIBSSH2_SESSION *session,
                           const char *user,
                           const unsigned char *pubkeydata,
                           size_t pubkeydata_len,
                           sign_callback,
                           void **abstract);

🦋 DESCRIPTION 🦋

So basically you authenticate using the sign_callback callback, and that callback has to match the prototype down there in the CALLBACK section. That's the whole vibe. No file paths, no drama — you bring the function, it brings the signature ✨

🎀 CALLBACK 🎀

here's the shape your callback has to have, bestie, keep it exact:

int name(LIBSSH2_SESSION *session, unsigned char **sig, size_t *sig_len,
         const unsigned char *data, size_t data_len, void **abstract);

This function gets called...

ngl that trailing ellipsis is literally all the original gives us 🙈 we are NOT inventing more, that's the rules.

💖 RETURN VALUE 💖

Returns 0 on success, or negative on failure. periodt.

👑 SEE ALSO 👑

• libssh2_userauth_publickey_fromfile_ex(3)

that's the page!! 💜 it's from the libssh2 manual, version 0.15, dated 1 Jun 2007 — so like, vintage, but she still ate. go sign something gorgeous, bestie 🌈🎀🦋