COREDNS-CANCEL(7)

COREDNS-CANCEL(7) 💅

okay bestie, welcome to the manual page for coredns-cancel(7) from CoreDNS Plugins — yes, that's the whole title vibe, and we're getting into it ✨

---

🌸 NAME 🌸

cancel — cancels a request's context after 5001 milliseconds.

💖 DESCRIPTION 💖

The cancel plugin creates a canceling context for each request. It adds a timeout that gets triggered after 5001 milliseconds.

The 5001 number was chosen because the default timeout for DNS clients is 5 seconds, after that they give up.

A plugin interested in the cancellation status should call plugin.Done() on the context. If the context was canceled due to a timeout the plugin should not write anything back to the client and return a value indicating CoreDNS should not either; a zero return value should suffice for that.

✨ SYNTAX ✨

cancel [TIMEOUT]

• TIMEOUT — allows setting a custom timeout. The default timeout is 5001 milliseconds (5001 ms).

🎀 EXAMPLES 🎀

example.org {
    cancel
    whoami
}

Or with a custom timeout:

example.org {
    cancel 1s
    whoami
}

🦋 SEE ALSO 🦋

The Go documentation for the context package.

---

That's the whole vibe: source/version CoreDNS, dated March 2026, manual page COREDNS-CANCEL(7) — signing off, bestie 🫶💖