Struct trust_dns::client::BasicClientHandle

pub struct BasicClientHandle { /* fields omitted */ }

Root ClientHandle implementaton returned by ClientFuture

This can be used directly to perform queries. See trust_dns::client::SecureClientHandle for a DNSSEc chain validator.

Trait Implementations

impl<CC> Client<BasicClientHandle> for SyncClient<CC> where
    CC: ClientConnection, 

fn new_future(
    &self
) -> ClientResult<Box<Future<Item = BasicClientHandle, Error = ClientError> + Send>>

Return the inner Futures items

fn query(
    &self,
    name: &Name,
    query_class: DNSClass,
    query_type: RecordType
) -> ClientResult<DnsResponse>

A classic DNS query, i.e. does not perform any DNSSec operations

fn notify<R>(
    &mut self,
    name: Name,
    query_class: DNSClass,
    query_type: RecordType,
    rrset: Option<R>
) -> ClientResult<DnsResponse> where
    R: IntoRecordSet, 

Sends a NOTIFY message to the remote system

fn create<R>(&self, rrset: R, zone_origin: Name) -> ClientResult<DnsResponse> where
    R: IntoRecordSet, 

Sends a record to create on the server, this will fail if the record exists (atomicity depends on the server)

fn append<R>(
    &self,
    rrset: R,
    zone_origin: Name,
    must_exist: bool
) -> ClientResult<DnsResponse> where
    R: IntoRecordSet, 

Appends a record to an existing rrset, optionally require the rrset to exist (atomicity depends on the server)

fn compare_and_swap<CR, NR>(
    &self,
    current: CR,
    new: NR,
    zone_origin: Name
) -> ClientResult<DnsResponse> where
    CR: IntoRecordSet,
    NR: IntoRecordSet, 

Compares and if it matches, swaps it for the new value (atomicity depends on the server)

fn delete_by_rdata<R>(
    &self,
    record: R,
    zone_origin: Name
) -> ClientResult<DnsResponse> where
    R: IntoRecordSet, 

Deletes a record (by rdata) from an rrset, optionally require the rrset to exist.

fn delete_rrset(
    &self,
    record: Record,
    zone_origin: Name
) -> ClientResult<DnsResponse>

Deletes an entire rrset, optionally require the rrset to exist.

fn delete_all(
    &self,
    name_of_records: Name,
    zone_origin: Name,
    dns_class: DNSClass
) -> ClientResult<DnsResponse>

Deletes all records at the specified name

impl Clone for BasicClientHandle

fn clone(&self) -> BasicClientHandle

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl DnsHandle for BasicClientHandle

type Error = ClientError

The associated error type returned by future send operations

Important traits for Box<W>

impl<W> Write for Box<W> where
    W: Write + ?Sized, impl<R> Read for Box<R> where
    R: Read + ?Sized, impl<I> Iterator for Box<I> where
    I: Iterator + ?Sized,  type Item = <I as Iterator>::Item;

fn send<R: Into<DnsRequest>>(
    &mut self,
    request: R
) -> Box<Future<Item = DnsResponse, Error = Self::Error> + Send>

Send a message via the channel in the client

fn is_verifying_dnssec(&self) -> bool

Ony returns true if and only if this DNS handle is validating DNSSec.

Important traits for Box<W>

impl<W> Write for Box<W> where
    W: Write + ?Sized, impl<R> Read for Box<R> where
    R: Read + ?Sized, impl<I> Iterator for Box<I> where
    I: Iterator + ?Sized,  type Item = <I as Iterator>::Item;

fn lookup(
    &mut self,
    query: Query,
    options: DnsRequestOptions
) -> Box<Future<Error = Self::Error, Item = DnsResponse> + 'static + Send>

A classic DNS query