Fast python library encapsulating the nfqueue netlink interface.
Fast netfilter nfqueue python and C interface. Gets the speed from
- avoiding memory allocation
- batching reads (uses
It also does not use the callback-like interface of libnetfilter-queue and provides a more python like iterator interface. Additionally, it doesn't assume anything and therefore doesn't automatically set verdicts on packets (unlike python-nfqueue in debian which accepts everything after you return from the callback...)
It can handle
ping -f (even
iperf if the moon is in the right spot) to localhost from within python.
Focus is on a python like interface.
Short example for mangling packets:
iptables -A OUTPUT <filter here> -j NFQUEUE --queue-num 1
import fnfqueue queue = 1 conn = nfqueue.Connection() try: q = conn.bind(queue) q.set_mode(0xffff, nfqueue.COPY_PACKET) except PermissionError: print("Access denied; Do I have root rights or the needed capabilities?") sys.exit(-1) while True: try: for packet in conn: packet.payload = packet.payload # modify the packet here packet.mangle() except nfqueue.BufferOverflowException: print("buffer error") pass conn.close()
Help is provided as python docs.
No C libraries are needed. Needs cffi for building. Kernel and libc must be recent enough to support
recvmmsg (linux 2.6.33, glibc 2.12 - more recent kernels provide better performance).