取消

cancel 在 5001 毫秒后取消请求的上下文。

说明

cancel 插件为每个请求创建一个取消上下文。它添加了一个超时,该超时会在 5001 毫秒后触发。

之所以选择数字 5001,是因为 DNS 客户端的默认超时时间为 5 秒,之后它们就会放弃。

如果某个插件对取消状态感兴趣,则应在上下文中调用 plugin.Done()。如果上下文因超时而被取消,则该插件不应向客户端写回任何内容,并返回一个值,指示 CoreDNS 也不应写回任何内容;一个零返回值应该足以满足此要求。

语法

cancel [TIMEOUT]
  • TIMEOUT 允许设置自定义超时。默认超时时间为 5001 毫秒(5001 ms

示例

example.org {
    cancel
    whoami
}

或使用自定义超时

example.org {
    cancel 1s
    whoami
}

另请参见

上下文包的 Go 文档。