KNET_HOST_ADD(3)

✨ KNET_HOST_ADD(3) ✨

okay bestie, pull up a chair 💖 this one's from the Kronosnet Programmer's Manual, it's called knet_host_add, and it is literally the "hey everybody, meet the new node" function. lowkey iconic.

---

🌸 NAME 🌸

knet_host_add — add a new host ID to knet.

like. you're adding a whole new friend to the group chat. that's the function. that's it. slay. 💅

---

🦋 SYNOPSIS 🦋

#include <libknet.h>

int knet_host_add(
    knet_handle_t   knet_h,
    knet_node_id_t  host_id
);

yes the include is #include <libknet.h>, don't forget it or the compiler will simply not know who you are 😭

---

🎀 DESCRIPTION 🎀

knet_host_add — the moment of arrival. the main character entrance. ✨

Here's what you're handing over:

• knet_h — a pointer to knet_handle_t. that's your knet handle, the whole vibe container.
• host_id — every host in a knet is identified by a unique ID (see also knet_handle_new(3), bestie, it's all connected 🫶). unique means unique fr fr, don't be out here duplicating IDs, that's not the move.

---

💜 RETURN VALUE 💜

knet_host_add returns:

• 0 on success 🎉 periodt.
• -1 on error, and errno gets set. so if you get a -1, go check errno immediately, don't just stare at your terminal like 👁️👄👁️

---

🌈 SEE ALSO 🌈

okay so this function has a whole extended friend group and we're listing every single one of them because nobody gets left out in this house 👑

• knet_handle_remove_datafd(3)
• knet_handle_get_stats(3)
• knet_handle_pmtud_setfreq(3)
• knet_handle_pmtud_get(3)
• knet_handle_crypto_use_config(3)
• knet_host_get_id_by_host_name(3)
• knet_host_get_status(3)
• knet_link_add_acl(3)
• knet_link_get_pong_count(3)
• knet_link_get_priority(3)
• knet_handle_free(3)
• knet_handle_enable_sock_notify(3)
• knet_handle_get_datafd(3)
• knet_recv(3)
• knet_link_get_ping_timers(3)
• knet_log_get_subsystem_id(3)
• knet_host_remove(3)
• knet_host_enable_status_change_notify(3)
• knet_strtoaddr(3)
• knet_link_rm_acl(3)
• knet_send(3)
• knet_handle_enable_pmtud_notify(3)
• knet_get_crypto_cipher_list(3)
• knet_handle_get_transport_reconnect_interval(3)
• knet_link_get_enable(3)
• knet_link_set_priority(3)
• knet_log_set_loglevel(3)
• knet_handle_get_channel(3)
• knet_link_get_config(3)
• knet_link_get_link_list(3)
• knet_get_crypto_hash_list(3)
• knet_get_transport_list(3)
• knet_get_transport_id_by_name(3)
• knet_log_get_loglevel_id(3)
• knet_handle_new_ex(3)
• knet_host_set_name(3)
• knet_addrtostr(3)
• knet_handle_setfwd(3)
• knet_get_compress_list(3)
• knet_host_set_policy(3)
• knet_get_transport_name_by_id(3)
• knet_handle_enable_filter(3)
• knet_handle_crypto_rx_clear_traffic(3)
• knet_handle_compress(3)
• knet_link_get_status(3)
• knet_handle_add_datafd(3)
• knet_send_sync(3)
• knet_log_get_loglevel_name(3)
• knet_handle_enable_access_lists(3)
• knet_host_get_host_list(3)
• knet_host_get_policy(3)
• knet_link_set_enable(3)
• knet_link_set_pong_count(3)
• knet_log_get_subsystem_name(3)
• knet_host_get_name_by_host_id(3)
• knet_link_clear_config(3)
• knet_log_get_loglevel(3)
• knet_handle_new(3)
• knet_handle_pmtud_getfreq(3)
• knet_handle_pmtud_set(3)
• knet_handle_clear_stats(3)
• knet_link_set_config(3)
• knet_handle_crypto_set_config(3)
• knet_handle_crypto(3)
• knet_get_crypto_list(3)
• knet_handle_set_transport_reconnect_interval(3)
• knet_link_clear_acl(3)
• knet_link_set_ping_timers(3)
• knet_handle_setprio_dscp(3)
• knet_link_insert_acl(3)

go read them all. iykyk. 📚✨

---

👑 COPYRIGHT 👑

Copyright (C) 2010-2026 Red Hat, Inc. All rights reserved.

---

heads up bestie: that copyright line is verbatim and it is not a vibe, it's a legal thing. respect it. 💀

---

and that's the whole page, no cap 🧚 this was kronosnet, dated 2026-07-20, filed under KNET_HOST_ADD(3) — go add some hosts and absolutely eat 💖🌸🦋