KNET_HOST_SET_POLICY(3)

💖 KNET_HOST_SET_POLICY(3) 💖

okay bestie, welcome to knet_host_set_policy from the Kronosnet Programmer's Manual — this is the one that lets you pick how a host's links get chosen when there's traffic to send 🦋 no cap, it's lowkey one of the most important vibes in the whole link situation.

---

✨ NAME ✨

knet_host_set_policy — Set the switching policy for a host's links.

like. you're literally deciding which link is the main character 💅

---

🌸 SYNOPSIS 🌸

#include <libknet.h>

int knet_host_set_policy(
    knet_handle_t   knet_h,
    knet_node_id_t  host_id,
    uint8_t         policy
);

---

🎀 DESCRIPTION 🎀

so, knet_host_set_policy — here's the breakdown, bestie:

• knet_h — pointer to knet_handle_t. your handle. your whole world tbh 🫶
• host_id — see knet_host_add(3). that's where the id lore lives ✨
• policy — okay so currently there are 3 kinds of simple switching policies, and they're all based on link configuration. let me give you the tea on each one:
  • KNET_LINK_POLICY_PASSIVE — the active link with the highest priority (highest number) will be used. and if one or more active links share the same priority? then the one with the lowest link_id will be used. tiebreaker energy 💅
  • KNET_LINK_POLICY_ACTIVE — all active links will be used simultaneously to send traffic. link priority is ignored. everybody works, nobody's the favorite, periodt.
  • KNET_LINK_POLICY_RR — round-robin policy, every packet will be send on a different active link. yes it says "send", that's the original wording, we don't edit the ancestors 🙈 rotating like a turntable fr fr 🔥

---

⭐ RETURN VALUE ⭐

knet_host_set_policy returns 0 on success, -1 on error, and errno is set. classic. slay when it works, cry when it doesn't 😭

---

🌈 SEE ALSO 🌈

the whole group chat, alphabetically-ish, all of them, no skipping 💖:

• 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_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_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 🫶 kronosnet, dated 2026-07-20, filed under KNET_HOST_SET_POLICY(3) — go set a policy and slay 💅✨