]> git.ipfire.org Git - thirdparty/pdns.git/commitdiff
both CAP_SYS_ADMIN and CAP_BPF mightr be relevant 11525/head
authorOtto Moerbeek <otto.moerbeek@open-xchange.com>
Tue, 12 Apr 2022 08:22:14 +0000 (10:22 +0200)
committerGitHub <noreply@github.com>
Tue, 12 Apr 2022 08:22:14 +0000 (10:22 +0200)
Co-authored-by: Remi Gacogne <github@coredump.fr>
pdns/dnsdistdist/docs/advanced/ebpf.rst

index ee3981dce26d86b2fbfb2dffa518e87306d59b4d..c073a8d6ceae120959311b1574b8943899c26ce9 100644 (file)
@@ -4,7 +4,7 @@ eBPF Socket Filtering
 :program:`dnsdist` can use `eBPF <http://www.brendangregg.com/ebpf.html>`_ socket filtering on recent Linux kernels (4.1+) built with eBPF support (``CONFIG_BPF``, ``CONFIG_BPF_SYSCALL``, ideally ``CONFIG_BPF_JIT``). It requires dnsdist to have the ``CAP_SYS_ADMIN`` capabilities at startup, or the more restrictive ``CAP_BPF`` one since Linux 5.8.
 
 .. note::
-   To retain the ``CAP_BPF`` capability, it is necessary to call :func:`addCapabilitiesToRetain` during startup, as :program:`dnsdist` drops capabilities after startup.
+   To retain the required capability, ``CAP_SYS_ADMIN`` or ``CAP_BPF`` depending on the Linux kernel version, it is necessary to call :func:`addCapabilitiesToRetain` during startup, as :program:`dnsdist` drops capabilities after startup.
 
 This feature allows dnsdist to ask the kernel to discard incoming packets in kernel-space instead of them being copied to userspace just to be dropped, thus being a lot of faster. The current implementation supports dropping UDP and TCP queries based on the source IP and UDP datagrams on exact DNS names. We have not been able to implement suffix matching yet, due to a limit on the maximum number of EBPF instructions.