KNET_HAN...ESS_LISTS(3)

✨ KNET_HAN...ESS_LISTS(3) ✨

okay bestie, welcome to the Kronosnet Programmer's Manual 💖 this is the section-3 page for knet_handle_enable_access_lists, and it's literally the switch that decides whether your access lists are actually doing something or just vibing in the void. let's get into it 🫶

---

🌸 NAME 🌸

knet_handle_enable_access_lists — turn usage of access lists on or off (default: off, bestie, it starts off)

---

🎀 SYNOPSIS 🎀

#include <libknet.h>

int knet_handle_enable_access_lists(
    knet_handle_t  knet_h,
    unsigned int   enabled
);

---

🦋 DESCRIPTION 🦋

knet_handle_enable_access_lists — the function itself, the main character 👑

knet_h — pointer to knet_handle_t ✨

enable — set to 1 to use access lists, 0 to disable access_lists.

so here's the tea, bestie: access lists are bound to links. and there are exactly 2 types of links:

1. point to point — where both source and destinations are well known at configuration time 🔒
2. open links — where only the source is known at configuration time 🙈

and here's the slay part: knet will automatically generate access lists for point to point links. no work required, she does it herself 💅

for open links tho? that's on you, babes. knet provides 4 API calls to manipulate access lists: knet_link_add_acl(3), knet_link_rm_acl(3), knet_link_insert_acl(3) and knet_link_clear_acl(3). those API calls will work exclusively on open links as they are of no use on point to point links. exclusive behavior, we love to see it ✨

⚠️ important warning bestie: knet will not enforce any access list unless specifically enabled by knet_handle_enable_access_lists(3). no cap. it will just sit there doing nothing.

from a security / programming perspective we recommend: create the knet handle

1. create the knet handle
2. enable access lists
3. configure hosts and links
4. configure access lists for open links

in that order, fr fr, don't freestyle it 🧚

---

💜 RETURN VALUE 💜

knet_handle_enable_access_lists returns 0 on success, -1 on error, and errno is set. that's the whole vibe check right there 😭

---

🌈 SEE ALSO 🌈

a whole group chat of friends, bestie, every single one of them:

• 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_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 came from the kronosnet source, dated 2026-07-20, so if you ever need to cite it: kronosnet, 2026-07-20, page KNET_HAN...ESS_LISTS(3). now go forth and enable those access lists, you absolute icon 💖✨🦋