Struct ForwardZoneHandler 

pub struct ForwardZoneHandler<P: ConnectionProvider = TokioRuntimeProvider> { /* private fields */ }

Available on crate feature resolver only.

A zone handler that will forward resolutions to upstream resolvers.

This uses the hickory-resolver crate for resolving requests.

Implementations

impl<P: ConnectionProvider> ForwardZoneHandler<P>

pub fn builder(runtime: P) -> Result<ForwardZoneHandlerBuilder<P>, String>

Construct a new ForwardZoneHandler via ForwardZoneHandlerBuilder, using the operating system’s resolver configuration.

pub fn builder_with_config( config: ForwardConfig, runtime: P, ) -> ForwardZoneHandlerBuilder<P>

Construct a new ForwardZoneHandler via ForwardZoneHandlerBuilder with the provided configuration.

impl ForwardZoneHandler<TokioRuntimeProvider>

pub fn builder_tokio( config: ForwardConfig, ) -> ForwardZoneHandlerBuilder<TokioRuntimeProvider>

Construct a new ForwardZoneHandler via ForwardZoneHandlerBuilder with the provided configuration.

Trait Implementations

impl<P: ConnectionProvider> ZoneHandler for ForwardZoneHandler<P>

fn zone_type(&self) -> ZoneType

Always External

fn axfr_policy(&self) -> AxfrPolicy

AXFR requests are always denied for Forward zones

fn can_validate_dnssec(&self) -> bool

Whether the zone handler can perform DNSSEC validation

fn origin(&self) -> &LowerName

Get the origin of this zone, i.e. example.com is the origin for www.example.com

In the context of a forwarder, this is either a zone which this forwarder is associated, or ., the root zone for all zones. If this is not the root zone, then it will only forward for lookups which match the given zone name.

fn lookup<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, name: &'life1 LowerName, rtype: RecordType, _request_info: Option<&'life2 RequestInfo<'life3>>, _lookup_options: LookupOptions, ) -> Pin<Box<dyn Future<Output = LookupControlFlow<AuthLookup>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait,

Forwards a lookup given the resolver configuration for this Forwarded zone

fn search<'life0, 'life1, 'async_trait>( &'life0 self, request: &'life1 Request, lookup_options: LookupOptions, ) -> Pin<Box<dyn Future<Output = (LookupControlFlow<AuthLookup>, Option<TSigResponseContext>)> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Using the specified query, perform a lookup against this zone.

fn nsec_records<'life0, 'life1, 'async_trait>( &'life0 self, _name: &'life1 LowerName, _lookup_options: LookupOptions, ) -> Pin<Box<dyn Future<Output = LookupControlFlow<AuthLookup>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Return the NSEC records based on the given name

fn nsec3_records<'life0, 'life1, 'async_trait>( &'life0 self, _info: Nsec3QueryInfo<'life1>, _lookup_options: LookupOptions, ) -> Pin<Box<dyn Future<Output = LookupControlFlow<AuthLookup>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Available on crate feature __dnssec only.

Return the NSEC3 records based on the information available for a query.

fn nx_proof_kind(&self) -> Option<&NxProofKind>

Available on crate feature __dnssec only.

Returns the kind of non-existence proof used for this zone.

fn metrics_label(&self) -> &'static str

Available on crate feature metrics only.

Returns the zone handler metrics label.

fn update<'life0, 'life1, 'async_trait>( &'life0 self, _update: &'life1 Request, _now: u64, ) -> Pin<Box<dyn Future<Output = (Result<bool, ResponseCode>, Option<TSigResponseContext>)> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Perform a dynamic update of a zone

fn consult<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, _name: &'life1 LowerName, _rtype: RecordType, _request_info: Option<&'life2 RequestInfo<'life3>>, _lookup_options: LookupOptions, last_result: LookupControlFlow<AuthLookup>, ) -> Pin<Box<dyn Future<Output = (LookupControlFlow<AuthLookup>, Option<TSigResponseContext>)> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait,

Consulting lookup for all Resource Records matching the given Name and RecordType. This will be called in a chained zone handler configuration after a zone handler in the chain has returned a lookup with a LookupControlFlow::Continue action. Every other zone handler in the chain will be called via this consult method, until one either returns a LookupControlFlow::Break action, or all zone handlers have been consulted. The zone handler that generated the primary lookup (the one returned via ‘lookup’) will not be consulted.

fn zone_transfer<'life0, 'life1, 'async_trait>( &'life0 self, _request: &'life1 Request, _lookup_options: LookupOptions, _now: u64, ) -> Pin<Box<dyn Future<Output = Option<(Result<ZoneTransfer, LookupError>, Option<TSigResponseContext>)>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Returns all records in the zone.