Skip to main content

Crate pharos_plugins

Crate pharos_plugins 

Source
Expand description

Plugins are enabled by plugin-<directive> Cargo features (underscores in Directive names become hyphens). Enabled but unimplemented Directives reject configuration rather than silently accepting it.

Modules§

any
bind
Bind Directive setup and interface expansion.
bufsize
Limit the EDNS UDP payload advertised to downstream Plugins.
cache
Cache configuration and DNS Response storage.
chaos
CH-class identity Responses.
errors
CoreDNS error logging configuration.
forward
Forward Queries to configured Upstreams.
header
Modify DNS header flags in Queries and Responses.
health
Health endpoint configuration.
hosts
Hosts Directive configuration.
kubernetes
Kubernetes authoritative DNS backend.
loadbalance
Loadbalance Directive configuration.
local
Localhost and locally served reverse Domains.
log
Corefile access logging rules.
log_format
Compiled CoreDNS-style query log formats.
loop
Detect forwarding loops during startup.
metadata
Per-Query Metadata collection.
minimal
Remove unnecessary sections from positive Responses.
nsid
NSID Directive.
prometheus
Prometheus Directive configuration.
proxy
Upstream DNS exchange. Independent cache shards hold idle connections only; no lock or manager task is held while a Query waits for its Response. DNS-over-TLS is deferred to M3. CoreDNS’s forward performs the prefer_udp TC retry; Pharos does it here, so a forward caller must not retry the same truncated Response again.
ready
Readiness endpoint configuration and state.
reload
Reload Directive configuration.
whoami

Structs§

Chain
Unimplemented
Placeholder for enabled but unimplemented Plugins, whose setup always fails.

Constants§

PLUGINS_LISTING

Statics§

DIRECTIVES

Functions§

directives
Directive registry in Plugin Order.
plugins_listing
CoreDNS-style alphabetically sorted plugin listing, including final blank line.
servers
Group Server Blocks by Listener and collect their hooks in block order. The caller runs Startup before serving and Shutdown before Listeners drain.
servers_with_registry
Build servers using a process-wide metrics registry.

Type Aliases§

Servers
Configured DNS Servers keyed by Listener.