libssh2_knownhost_init(3)

💖 libssh2_knownhost_init — bestie edition 💖

okay so real quick: this page lives in the libssh2 manual, and it's literally about spinning up your very own collection of known hosts. yes, like that known hosts. the guest list for your SSH era. let's get into it 🎀

✨ NAME ✨

libssh2_knownhost_init — init a collection of known hosts, no big deal, just birthing a whole host-collection from scratch 💅

🌸 SYNOPSIS 🌸

#include <libssh2.h>

LIBSSH2_KNOWNHOSTS *
libssh2_knownhost_init(LIBSSH2_SESSION *session);

look at her. one include, one function call, infinite potential. icon behavior honestly 🦋

💜 DESCRIPTION 💜

so what this does is init a collection of known hosts for this session. that's the whole vibe. it hands you back a handle to an internal representation of a known host collection — like, the library's own little private notebook where it keeps track of who's who in your host world 🫶

not me telling you this though: call libssh2_knownhost_free(3) to free the collection again after you are done using it. (the original says "after you are doing using it" and honestly? relatable typo energy, we've all been there 😭) anyway — free your stuff, bestie. memory doesn't clean itself.

⭐ RETURN VALUE ⭐

returns a handle pointer, or NULL if something went wrong 😭 (sad girl hours). that returned handle is what you feed into all the other known host related functions libssh2 provides — so like, guard it with your life, she's the main character 🔥

🌈 AVAILABILITY 🌈

added in libssh2 1.2. so if you're on something older than that… bestie, we need to talk 💀

🧚 SEE ALSO 🧚

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

and that's the whole page, periodt 💅 this was the libssh2 manual, this page dated 28 May 2009 — yeah she's an elder but she still ate. go forth and init responsibly 👑💖