IPQ_CREATE_HANDLE(3)

okay bestie, gather round — this is IPQ_CREATE_HANDLE(3) from the Linux Programmer's Manual, and we're talking about creating and destroying libipq handles like it's main character energy 💅✨

🌸 NAME 🌸

ipq_create_handle, ipq_destroy_handle — bestie, these two literally create and destroy libipq handles 🫶

🎀 SYNOPSIS 🎀

#include <linux/netfilter.h>
#include <libipq.h>

struct ipq_handle *ipq_create_handle(uint32_t flags, uint32_t protocol);
int ipq_destroy_handle(struct ipq_handle *h);

✨ DESCRIPTION ✨

So ipq_create_handle initialises libipq for an application — it attempts to bind to the Netlink socket used by ip_queue, and returns an opaque context handle 😌✨ It should be the first libipq function your app calls, no cap. And the handle it returns? Use that same handle in all subsequent library calls that require a handle parameter, periodt.

The flags parameter is not currently used, so the application should set it to zero for forward compatibility — it's giving "placeholder but make it future-proof" 🎀

The protocol parameter specifies the protocol of the packets to be queued. Valid values are NFPROTO_IPV4 for IPv4 and NFPROTO_IPV6 for IPv6. Currently, only one protocol may be queued at a time for a handle — that's the vibe check, bestie.

The ipq_destroy_handle function frees up resources allocated by ipq_create_handle, and should be used when the handle is no longer required by the application. Cleanup queen behavior, honestly 🧹👑

🌈 RETURN VALUES 🌈

• On success, ipq_create_handle returns a pointer to a context handle. On failure, NULL is returned 😭
• On success, ipq_destroy_handle returns zero. On failure, -1 is returned 💀

🚨 ERRORS 🚨

On failure, a descriptive error message will be available via the ipq_errstr function. So if something goes sideways, go ask ipq_errstr — it's literally the receipts 🔥

🐛 BUGS 🐛

None known. Iconic, honestly. No known bugs, no drama 💅✨

👑 AUTHOR 👑

James Morris <jmorris@intercode.com.au> 🫶

📜 COPYRIGHT 📜

Copyright (c) 2000-2001 Netfilter Core Team.

Distributed under the GNU General Public License.

🦋 SEE ALSO 🦋

• iptables(8)
• libipq(3)

and that's the page, bestie — from Linux iptables 1.2, dated 16 October 2001. mwah, go slay your queue 💖🫶✨