KNET_HOST_GET_STATUS(3)

okay bestie, welcome to KNET_HOST_GET_STATUS(3) 💖 straight out of the Kronosnet Programmer's Manual. it's giving "how's that host doing tho" energy and honestly? we love a little status check 🫶

---

🌸 NAME 🌸

knet_host_get_status — get the status of a host ✨ that's it, that's the whole job.

---

🦋 SYNOPSIS 🦋

#include <libknet.h>

int knet_host_get_status(
    knet_handle_t              knet_h,
    knet_node_id_t             host_id,
    struct knet_host_status   *status
);

yes bestie, it's one function call and it hands you back a lil struct. chef's kiss 💅

---

🎀 DESCRIPTION 🎀

okay so. knet_host_get_status — that's our main character here 👑

• knet_h — a pointer to a knet_handle_t. the handle. the vibe. the whole operation.
• host_id — go look at knet_host_add(3) for this one, that's where the lore lives 📖
• status — a pointer to a knet_host_status struct. this is where the tea gets poured ☕ (details below, keep scrolling, it's worth it)

---

🌈 STRUCTURES 🌈

so this is the status of a knet host, and it's what gets returned from knet_host_get_status() — struct reveal time ✨

struct knet_host_status {
    uint8_t  reachable;  /* Whether the host is currently reachable */
    /*
     * Whether the host is a remote node (not currently implemented)
     */
    uint8_t  remote;
    /*
     * Whether the host is external (not currently implemented)
     */
    uint8_t  external;
};

let me break the vibes down for you bestie:

• reachable — whether the host is currently reachable. this one actually works. slay.
• remote — whether the host is a remote node. not currently implemented 💀 so like, don't get your hopes up, she's just sitting there.
• external — whether the host is external. also not currently implemented 🙈 same deal. placeholder core.

---

⭐ RETURN VALUE ⭐

okay so, word for word, the page says this:

knet_handle_pmtud_get returns 0 on success, -1 on error and errno is set.

and yes, bestie, the page literally writes knet_handle_pmtud_get right there — that's what it says, i'm just the messenger 🫠

but the actual tea is: 0 = we ate, -1 = we did not eat, and errno gets set so you can find out why. periodt. 💅

---

👑 SEE ALSO 👑

so many icons, honestly, the whole family tree 🌳:

• 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_id_by_host_name(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)

---

💜 COPYRIGHT 💜

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

---

and that's the whole page, bestie 🎀 this one's from kronosnet, dated 2026-07-20, and it's filed under KNET_HOST_GET_STATUS(3). go check on your hosts, they deserve it 🦋✨💅