libssh2_knownhost_del(3)

💖 libssh2_knownhost_del(3) 💖

okay bestie, so this is a page from the libssh2 manual, and it's all about libssh2_knownhost_del — the little function that says "girl, bye" to a known host entry. no cap. let's get into it 🦋

✨ NAME ✨

libssh2_knownhost_del — delete a known host entry 💅

✨ SYNOPSIS ✨

#include <libssh2.h>

int
libssh2_knownhost_del(LIBSSH2_KNOWNHOSTS *hosts,
                      struct libssh2_knownhost *entry);

like, that's the whole vibe. two args. one job. iconic. 🎀

✨ DESCRIPTION ✨

So what does it actually do? It deletes a known host entry from the collection of known hosts. that's it. that's the whole thing. it's giving "declutter your life" energy ✨

and entry? that's a pointer to a struct — and you don't just vibe your way into getting one of those, you extract it with libssh2_knownhost_check(3) or libssh2_knownhost_get(3). those are your two plug-ins for the pointer, iykyk. so like, get your entry from one of those first, then come back here and delete it. 🫶

✨ RETURN VALUE ✨

It returns a regular libssh2 error code. and here's the thing, bestie, listen close:

• negative values = error codes 😭
• 0 = success 🎉

so if you get a zero, you ate. periodt. 💅

✨ AVAILABILITY ✨

Added in libssh2 1.2 — so it's been around a minute, it's a classic, it's lowkey a legend. ⭐

✨ SEE ALSO ✨

go read these too, they're all in the same friend group:

• libssh2_knownhost_init(3)
• libssh2_knownhost_free(3)
• libssh2_knownhost_add(3)
• libssh2_knownhost_check(3)

and that's the page, bestie!! 🧚 this little gem is brought to you by libssh2, dated 28 May 2009 🌸 — yeah she's an elder but she still serves. mwah, go delete some hosts responsibly 💜👑