bufsize

README

bufsize

Name

bufsize - limits EDNS0 buffer size to prevent IP fragmentation.

Description

bufsize limits a requester's UDP payload size to within a maximum value. If a request with an OPT RR has a bufsize greater than the limit, the bufsize of the request will be reduced. Otherwise the request is unaffected. It prevents IP fragmentation, mitigating certain DNS vulnerabilities. It cannot increase UDP size requested by the client, it can be reduced only. This will only affect queries that have an OPT RR (EDNS(0)).

Syntax

bufsize [SIZE]

[SIZE] is an int value for setting the buffer size. The default value is 1232, and the value must be within 512 - 4096. Only one argument is acceptable, and it covers both IPv4 and IPv6.

Examples

Enable limiting the buffer size of outgoing query to the resolver (172.31.0.10):

. {
    bufsize 1100
    forward . 172.31.0.10
    log
}

Enable limiting the buffer size as an authoritative nameserver:

. {
    bufsize 1220
    file db.example.org
    log
}

Considerations

• Setting 1232 bytes to bufsize may avoid fragmentation on the majority of networks in use today, but it depends on the MTU of the physical network links.

Documentation

Overview

Package bufsize implements a plugin that clamps EDNS0 buffer size preventing packet fragmentation.

Index

• type Bufsize
  • func (buf Bufsize) Name() string
  • func (buf Bufsize) ServeDNS(ctx context.Context, w dns.ResponseWriter, r *dns.Msg) (int, error)

Types

type Bufsize

type Bufsize struct {
	Next plugin.Handler
	Size int
}

Bufsize implements bufsize plugin.

func (Bufsize) Name

func (buf Bufsize) Name() string

Name implements the Handler interface.

func (Bufsize) ServeDNS

func (buf Bufsize) ServeDNS(ctx context.Context, w dns.ResponseWriter, r *dns.Msg) (int, error)

ServeDNS implements the plugin.Handler interface.