dnsjit.filter.timing(3)

✨ dnsjit.filter.timing ✨

okay bestie, so this is a page from the Library Functions Manual — it's dnsjit.filter.timing, and it's literally the little timing bouncer for your packet pipeline 💅

---

💖 NAME 💖

dnsjit.filter.timing — a filter that passes objects along to the next receiver based on the timing between packets. like, it's the vibe-checker for when packets get to move. 🕐✨

---

🎀 SYNOPSIS 🎀

local filter = require("dnsjit.filter.timing").new()
...
filter:receiver(...)

---

🦋 DESCRIPTION 🦋

So the whole point of this filter is to manipulate processing — either so it simulates the actual timing of when packets arrived, or so it just delays processing on purpose. it's giving "time travel but make it a filter" fr fr 😭

🌸 Functions 🌸

• Timing.new() — creates a brand new Timing filter. fresh out the box, no cap. ✨
• Timing:log() — hands you back the Log object so you can control logging for this instance or module. go off, log queen 👑
• Timing:keep() — sets the timing mode to keep the timing between packets. i.e. leave it exactly as it is, we're not touching a thing 💅
• Timing:increase(ns) — sets the timing mode to increase the timing between packets by the given number of nanoseconds. stretch that gap out bestie 🫶
• Timing:reduce(ns) — sets the timing mode to reduce the timing between packets by the given number of nanoseconds. squeeze it in, we're speeding up ⚡
• Timing:multiply(factor) — sets the timing mode to multiply the timing between packets by the given factor. and the factor is a float/double, so decimals are welcome here 🍓
• Timing:fixed(ns) — sets the timing mode to a fixed number of nanoseconds between packets. every packet gets the same little pause. consistent, iconic, periodt.
• Timing:realtime(drift, batch_size) — sets the timing mode to simulate the timing of packets in realtime. Packets are processed in batches of given size (batch_size, default 128) before adjusting time. It aborts if real time drifts ahead more than the given number of seconds (drift, default 1.0s). so like, it's got a limit and it WILL pull the plug, no cap 💀
• Timing:receive() — returns the C functions and context for receiving objects. lowkey the plumbing ✨
• Timing:receiver(o) — sets the receiver to pass objects to. this is your bestie downstream, o 🫶
• Timing:produce() — returns the C functions and context for producing objects. more plumbing, but make it cute 🎀
• Timing:producer(o) — sets the producer to get objects from. that's where the objects come from, o 💜

---

👑 AUTHORS and CONTRIBUTORS 👑

The absolute legends behind this:

• Jerry Lundström (DNS-OARC)
• Tomáš Křížek (CZ.NIC)
• Petr Špaček (ISC)

Maintained by DNS-OARC

https://www.dns-oarc.net/

---

🌈 BUGS 🌈

found a bug? want a feature? don't be shy, spill:

https://codeberg.org/DNS-OARC/dnsjit/issues

got a question or need a hand? hit up:

admin@dns-oarc.net

---

and that's the whole page bestie, you ate it 💅✨ this was dnsjit version 1.5.1, page dnsjit.filter.timing(3) — go forth and time those packets, mwah 🎀🦋💖