KNET_LIN...NG_TIMERS(3)

✨ KNET_LIN...NG_TIMERS(3) ✨

okay bestie, welcome to the Kronosnet Programmer's Manual 💖 you're reading knet_link_set_ping_timers(3) and honestly? it's giving "I control the heartbeat of your link" energy. sit down, grab a boba, let's get into it 🧋

---

💫 NAME 💫

knet_link_set_ping_timers — Set the ping timers for a link.

like, you're literally telling a link how often to say "u up?" and how long to wait before deciding the other side ghosted you 💀

---

🌸 SYNOPSIS 🌸

#include <libknet.h>

int knet_link_set_ping_timers(
    knet_handle_t   knet_h,
    knet_node_id_t  host_id,
    uint8_t         link_id,
    time_t          interval,
    time_t          timeout,
    unsigned int    precision
);

---

🦋 DESCRIPTION 🦋

knet_link_set_ping_timers — no cap, this is the one that sets your ping vibes ✨

• knet_h — pointer to knet_handle_t 💅
• host_id — see knet_host_add(3) 👑
• link_id — see knet_link_set_config(3) 🔗
• interval — specify the ping interval in milliseconds ⏱️
• timeout — if no pong is received within this time, the link is declared dead, in milliseconds. NOTE: in future it will be possible to set timeout to 0 for an autocalculated timeout based on interval, pong_count and latency. The API already accept 0 as value and it will return ENOSYS / -1. Once the automatic calculation feature will be implemented, this call will only return EINVAL for incorrect values. 🚨 so rn, 0 is NOT the glow-up you think it is, bestie — it just errors out.
• precision — how many values of latency are used to calculate the average link latency (see also knet_link_get_status(3)) 📊

---

🎀 RETURN VALUE 🎀

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

slay when it's 0, 😭 when it's -1, and that's the whole vibe check.

---

🌈 SEE ALSO 🌈

bestie the friend group is HUGE, here's the whole crew fr fr 🫶

• 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_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_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 little icon dropped as part of the kronosnet manual, dated 2026-07-20, and yes the page name really is KNET_LIN...NG_TIMERS(3) — the dots are doing their own thing and we respect the aesthetic ✨ go set some timers, you main character 👑