PDNS Grep

Search through PowerDNS records via API.

The wildcard * can be used as a placeholder in search_term and the ? character can be used as a placeholder for a single character.

Installation

Under Releases the binary can be downloaded directly.

Alternatively, you can install it with go: go install github.com/akquinet/pdnsgrep@latest

Configuration

Environment variables

export PDNSGREP_URL="https://pdns.example.domain"
export PDNSGREP_TOKEN="your-api-token"

Config file

A config file can be created under $HOME/.pdnsgrep.yaml or selected via --config.

---
url: "https://pdns.example.domain"
token: "your-api-token"
debug: false
verbose: false

Usage

Help

pdnsgrep --help

Record

❯ pdnsgrep "sub.example.domain"
Zone            Name              Type  Content         TTL
example.domain. sub.example.domain. A   [IPv4 Address]  300

IP

❯ pdnsgrep "10.187.102.42"
Zone             Name                 Type  Content         TTL
example2.domain. sub.example2.domain. A     [IPv4 Address]  300
example.domain.  sub.example.domain.  A     [IPv4 Address]  300

Multiple records

❯ pdnsgrep "fw" "fw*"
Zone            Name                      Type  Content          TTL
example.domain. fw.example.domain.        A     [IPv4 Address]   3600
example.domain. fw-ham-1.example.domain.  A     [IPv4 Address]   3600
example.domain. fw-ham-1.example.domain.  AAAA  [IPv6 Address]   3600

Only specific record types

❯ pdnsgrep "lab-asa" --type AAAA
Zone       Name                             Type   Content          TTL
example.domain. lab-asa-01.example.domain.  AAAA   [IPv6 Address]   3600
example.domain. lab-asa-02.example.domain.  AAAA   [IPv6 Address]   3600

Disable colored output

❯ pdnsgrep "fw" --no-color

Piping into less

❯ pdnsgrep "*firewall*" | less -S

Get only the names

❯ pdnsgrep "fw" --output raw --no-header | cut -d' ' -f 2 | sort -u
fw-01.example.domain
fw-02.example.domain.

CSV Export

❯ pdnsgrep "fw" --output csv
Zone;Name;Type;Content;TTL;Object Type
example.domain.;fw-1.example.domain.;AAAA;IPv6 Address;3600;record
example.domain.;fw-1.example.domain.;A;IPv4 Address;3600;record
....

JSON Export

❯ pdnsgrep "fw" --output json
[
  {
    "name": "fw-1.example.domain.",
    "type": "A",
    "content": "[IPv4 Address]",
    "object_type": "record",
    "zone": "example.domain.",
    "ttl": 3600
  },
  ...
]

Sort Results

❯ pdnsgrep "fw*" --sort-by name
❯ pdnsgrep "fw*" --sort-by zone
❯ pdnsgrep "fw*" --sort-by ttl
❯ pdnsgrep "fw*" --sort-by type

Statistics Mode

❯ pdnsgrep "fw*" --stats
Total Records: 42

By Type:
  A      28
  AAAA   14

By Zone:
  example.domain.                12
  example2.domain.               18
  example3.domain.               12

Watch Mode

Continuously poll and display changes:

# Continuous print (default) - appends each update
❯ pdnsgrep "app-server" --watch
=== 14:30:15 ===
Zone            Name                      Type  Content          TTL
example.domain. app-server.example.domain. A    [IPv4 Address]   300

=== 14:30:20 ===
Zone            Name                      Type  Content          TTL
example.domain. app-server.example.domain. A    [IPv4 Address]   300

=== 14:30:25 (CHANGED) ===
Zone            Name                      Type  Content          TTL
example.domain. app-server.example.domain. A    [IPv4 Address]   300
example.domain. app-server.example.domain. AAAA [IPv6 Address]   300

# Clear screen mode - refreshes display in place
❯ pdnsgrep "app-server" --watch --watch-clear

# Only show output when changes are detected
❯ pdnsgrep "app-server" --watch --watch-only-changed

Change the polling interval (default 5 seconds):

❯ pdnsgrep "app-server" --watch --watch-interval 10