Enum Command 

pub enum Command {
    Config(ConfigCmd),
    Mcp,
    Zone(ZoneCmd),
    Record(RecordCmd),
    Query(QueryArgs),
    Sync {
        profile: Option<String>,
        from: Option<String>,
        to: Option<String>,
        zone: Vec<String>,
        map: Vec<String>,
        apply: bool,
        json: bool,
    },
    Cache(CacheCmd),
    Stats {
        type: String,
    },
    Blocked(BlockedCmd),
    Allowed(AllowedCmd),
    Settings {
        show_secrets: bool,
    },
    Logs {
        lines: u32,
        start: Option<String>,
        end: Option<String>,
        level: Option<LogLevel>,
    },
    Completions {
        shell: Shell,
    },
    ServerIds,
}

Variants

Config(ConfigCmd)

Write a starter config file

Mcp

Start the MCP stdio server

Zone(ZoneCmd)

Manage DNS zones

Record(RecordCmd)

Manage DNS records

Query(QueryArgs)

Resolve a name directly against the system, a configured server, or any ad-hoc nameserver. Supports DNS, DoT, DoH, and (with --features doq) DoQ transports.

Sync

Sync records between two configured servers, optionally remapping IPs

Fields

profile: Option<String>

Named sync profile from the config file

from: Option<String>

Source server ID (overrides the profile’s from)

to: Option<String>

Destination server ID (overrides the profile’s to)

zone: Vec<String>

Zone to sync (repeatable; overrides the profile’s zones)

map: Vec<String>

IP rewrite for A/AAAA records, given as SRC=DST (repeatable)

apply: bool

Write the changes (without this flag, sync only previews them)

json: bool

Output the sync plan as JSON

Cache(CacheCmd)

Manage the DNS cache

Stats

View server statistics

Fields

type: String

Stats window: LastHour, LastDay, LastWeek, LastMonth, LastYear

Blocked(BlockedCmd)

Manage manually blocked domains

Allowed(AllowedCmd)

Manage the allowed (whitelist) domains

Settings

Show server settings

Fields

show_secrets: bool

Display sensitive settings values instead of redacting them

Logs

Fetch DNS server logs

Fields

lines: u32

Maximum number of log entries to return

start: Option<String>

Start time: ISO 8601 (2024-01-01T10:00:00), relative duration (10m, 2h, 1d, 30s), or time of day (14:30 → most recent occurrence)

end: Option<String>

End time: same format as –start

level: Option<LogLevel>

Minimum log level; omit to show all

Completions

Print a shell completion script to stdout.

Redirect the output to a file in your shell’s completions directory: dns completions fish > ~/.config/fish/completions/dns.fish dns completions bash > ~/.local/share/bash-completion/completions/dns dns completions zsh > ~/.zsh/completions/_dns

Fields

shell: Shell

ServerIds

Print configured server IDs (used by shell completions)

Trait Implementations

impl FromArgMatches for Command

fn from_arg_matches(__clap_arg_matches: &ArgMatches) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

fn update_from_arg_matches_mut<'b>( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

impl Subcommand for Command

fn augment_subcommands<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate Self via FromArgMatches::from_arg_matches_mut

fn augment_subcommands_for_update<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate self via FromArgMatches::update_from_arg_matches_mut

fn has_subcommand(__clap_name: &str) -> bool

Test whether Self can parse a specific subcommand