KNET_HOS...HOST_NAME(3)

💖 KNET_HOS...HOST_NAME(3) 💖

okay bestie, sit down, we're doing Kronosnet Programmer's Manual today and honestly? this one's a lil bop. it's knet_host_get_id_by_host_name(3) and she does exactly what her name says, no plot twists. ✨

---

🌸 NAME 🌸

knet_host_get_id_by_host_name — Get the ID of a host given its name. that's it. that's the whole gig. 🎀

---

✨ SYNOPSIS ✨

#include <libknet.h>

int knet_host_get_id_by_host_name(
    knet_handle_t     knet_h,
    const char       *name,
    knet_node_id_t   *host_id
);

---

🦋 DESCRIPTION 🦋

so, knet_host_get_id_by_host_name — the main character of this page, lowkey iconic — takes the stuff below and hands you back the ID of a host when all you've got is its name. reverse-engineering the group chat, but for hosts. 💅

• knet_h — pointer to knet_handle_t. your handle. your home base. your girl. 🫶
• name — name to lookup, max len KNET_MAX_HOST_LEN. do not try to be extra with a longer name, she has limits and KNET_MAX_HOST_LEN is them. 😭
• host_id — where to store the result. you bring the empty cup, she fills it. 🍓

---

💀 RETURN VALUE 💀

knet_host_get_id_by_host_name returns:

• 0 on success 🎉
• -1 on error and errno is set 🙈

bestie fr fr, if you see -1, go check errno. she's not being mysterious, she literally told you where the info lives. 👑

---

🌈 SEE ALSO 🌈

the whole crew, the entire friend group, no one left out, we don't do exclusion here:

• knet_handle_remove_datafd(3)
• knet_handle_get_stats(3)
• knet_host_add(3)
• knet_handle_pmtud_setfreq(3)
• knet_handle_pmtud_get(3)
• knet_handle_crypto_use_config(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)

like, that's a lot of friends. she's popular. we love that for her. 👑

---

🎀 COPYRIGHT 🎀

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

---

okay that's the whole page, you ate that, we both did. this lil manual page is from kronosnet, dated 2026-07-20, and yes she's been out here since 2010 serving the same flawless energy. go call knet_host_get_id_by_host_name(3) bestie, she's ready when you are 💜✨🦋