dnsscope(1)

dnsscope1

A powerdns nameserver debugging tool

Usage

dnsscope [OPTION] ... INFILE

Overview

dnsscope takes an INFILE in PCAP format. It generates some simple statistics outputs these to STDOUT.

Options

INFILE

Path to a PCAP file.

-h, --help

Show the help.

--rd

Only process packets in INFILE with the RD (Recursion Desired) flag set. By default, we process all DNS packets in INFILE.

--ipv4=<state>

Process IPv4 packets. On by default, disable with --ipv4 false.

--ipv6=<state>

Process IPv6 packets. On by default, disable with --ipv6 false.

-f,--filter-name=<domain>

Only process packets within this domain

--full-histogram <msec>

Write out histogram with specified bin-size to 'full-histogram'

--log-histogram

Write out a log-histogram of response times to 'log-histogram'

--no-servfail-stats

Remove servfail responses from latency statistics

--port

The source and destination port to consider. Default is looking at packets from and to ports 53 and 5300.

--servfail-tree

Figure out subtrees that generate servfails.

--stats-dir <directory>

Drop statistics files in this directory. Defaults to ./

-l, --load-stats

Emit per-second load statistics (questions, answers, outstanding).

-w <file>, --write-failures <file>

Write weird packets to a PCAP file at FILENAME.

-v, --verbose

Be more verbose.

Releases

6 releases since Debian 9 (Stretch); the text changed 5 times.

  1. 9
  2. 10
  3. 11
  4. 12
  5. 13
  6. Arch

--filter-name since Debian 11 (Bullseye); --log-histogram since Debian 11 (Bullseye); --no-servfail-stats since Debian 11 (Bullseye); --port since Debian 13 (Trixie); -f since Debian 11 (Bullseye).

--write-failures until Debian 9 (Stretch); -w until Debian 9 (Stretch).

Author

PowerDNS.COM BV

From powerdns 5.1.5-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.