Features

Mon, 01 Jan 0001 00:00:00 +0000

Features#

Basic Usage#

dnspropagation [OPTIONS] TYPE DOMAIN

TYPE is any DNS record type (A, AAAA, TXT, MX, CNAME, CAA, …). It is case-insensitive. DOMAIN is stripped of any protocol, port, or path — https://example.com:443/path is treated as example.com.

Output Formats#

Table (default)#

Prints a colour-coded PrettyTable to stdout. Answers matching --expected are green, mismatches are red, empty answers are yellow, and timeouts are red.

`--json`#

Outputs a JSON array. Each element represents one server:

Use in Pipelines

Mon, 01 Jan 0001 00:00:00 +0000

Use in Pipelines#

dnspropagation is designed to integrate cleanly into shell scripts and CI/CD pipelines. Machine-readable output, predictable exit codes, and an assertion mode make it straightforward to gate a deployment or validate a DNS change.

Exit Codes#

Code	Meaning
0	Success
1	Missing required arguments (TYPE or DOMAIN)
2	NXDOMAIN — domain does not exist
3	No servers matched the specified filters
5	`--expected` mismatch — at least one server returned an unexpected answer
10	Local file not found (`--custom_list` or `--file`)
11	Unsupported URL scheme (only `http`/`https` allowed)
12	Remote file exceeds the 1 MB size limit
13	Network error fetching remote list
14	YAML syntax error or non-UTF-8 response
15	HTTP error response from remote server (4xx / 5xx)
16	Server list schema validation failure

Asserting DNS Values#

Use --expected to turn dnspropagation into a pass/fail check. If every queried server returns one of the expected values the exit code is 0; if any server returns something different the exit code is 5.

dnspropagation