man/coredns-cancel.7


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67

.\" Generated by Mmark Markdown Processer - mmark.miek.nl
.TH "COREDNS-CANCEL" 7 "March 2021" "CoreDNS" "CoreDNS Plugins"

.SH "NAME"
.PP
\fIcancel\fP - cancels a request's context after 5001 milliseconds.

.SH "DESCRIPTION"
.PP
The \fIcancel\fP plugin creates a canceling context for each request. It adds a timeout that gets
triggered after 5001 milliseconds.

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

.PP
A plugin interested in the cancellation status should call \fB\fCplugin.Done()\fR 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.

.SH "SYNTAX"
.PP
.RS

.nf
cancel [TIMEOUT]

.fi
.RE

.IP \(bu 4
\fBTIMEOUT\fP allows setting a custom timeout. The default timeout is 5001 milliseconds (\fB\fC5001 ms\fR)


.SH "EXAMPLES"
.PP
.RS

.nf
example.org {
    cancel
    whoami
}

.fi
.RE

.PP
Or with a custom timeout:

.PP
.RS

.nf
example.org {
    cancel 1s
    whoami
}

.fi
.RE

.SH "SEE ALSO"
.PP
The Go documentation for the context package.