KNET_LINK_INSERT_ACL(3)

💖 KNET_LINK_INSERT_ACL(3) 💖

okay bestie, sit down, hydrate, because we're doing a kronosnet manpage from the Kronosnet Programmer's Manual and honestly? it's giving niche-but-powerful. ✨

---

🌸 NAME 🌸

knet_link_insert_acl — insert an access list entry to an open link at a given index. like, you're slipping a new VIP into the guest list at a specific spot, not just yeeting it at the end. 💅

---

✨ SYNOPSIS ✨

#include <libknet.h>

int knet_link_insert_acl(
    knet_handle_t              knet_h,
    knet_node_id_t             host_id,
    uint8_t                    link_id,
    int                        index,
    struct sockaddr_storage   *ss1,
    struct sockaddr_storage   *ss2,
    check_type_t               type,
    check_acceptreject_t       acceptreject
);

---

🦋 DESCRIPTION 🦋

knet_link_insert_acl — that's the function, that's the whole vibe. here's what each lil parameter is doing:

• knet_h — pointer to a knet_handle_t. this is your main character handle, hold onto it. 👑
• host_id — go peek at knet_host_add(3) for the deets on this one.
• link_id — and this one lives over in knet_link_set_config(3), so go read that.
• index — insert at position "index", where 0 is the first entry and -1 appends to the current list. so like, 0 = front of the line bestie, -1 = back of the line, no cutting. 🎀
• ss1 / ss2 / type / acceptreject — check the typedef definitions for the full tea. 🔍

---

🧚 STRUCTURES 🧚

enum check_type_t {
      CHECK_TYPE_ADDRESS;
      CHECK_TYPE_MASK;
      CHECK_TYPE_RANGE;
};

enum check_acceptreject_t {
      CHECK_ACCEPT;
      CHECK_REJECT;
};

the options are: CHECK_TYPE_ADDRESS, CHECK_TYPE_MASK, CHECK_TYPE_RANGE — and then for the vibe check, CHECK_ACCEPT or CHECK_REJECT. pick your fighter. ⚔️

---

💀 RETURN VALUE 💀

knet_link_insert_acl returns 0 on success — slay. ✨

-1 on error, and errno is set — so yeah, check errno, she's telling you what went wrong. 😭

---

🌈 SEE ALSO 🌈

a whole friend group of functions, 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_link_set_ping_timers(3)
• knet_handle_setprio_dscp(3)

---

🫶 COPYRIGHT 🫶

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

---

and that's the page, babe 💖 this one came from kronosnet, dated 2026-07-20, and yeah it's literally titled KNET_LINK_INSERT_ACL(3). go insert some ACLs responsibly, ily, bye! 🦋✨