Struct hickory_proto::op::query::Query

pub struct Query { /* private fields */ }

Query struct for looking up resource records, basically a resource record without RDATA.

RFC 1035, DOMAIN NAMES - IMPLEMENTATION AND SPECIFICATION, November 1987

4.1.2. Question section format

The question section is used to carry the "question" in most queries,
i.e., the parameters that define what is being asked.  The section
contains QDCOUNT (usually 1) entries, each of the following format:

                                    1  1  1  1  1  1
      0  1  2  3  4  5  6  7  8  9  0  1  2  3  4  5
    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
    |                                               |
    /                     QNAME / ZNAME             /
    /                                               /
    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
    |                     QTYPE / ZTYPE             |
    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
    |                     QCLASS / ZCLASS           |
    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+

Implementations

impl Query

pub fn new() -> Self

Return a default query with an empty name and A, IN for the query_type and query_class

pub fn query(name: Name, query_type: RecordType) -> Self

Create a new query from name and type, class defaults to IN

pub fn set_name(&mut self, name: Name) -> &mut Self

replaces name with the new name

pub fn set_query_type(&mut self, query_type: RecordType) -> &mut Self

Specify the RecordType being queried

pub fn set_query_class(&mut self, query_class: DNSClass) -> &mut Self

Specify÷ the DNS class of the Query, almost always IN

pub fn set_mdns_unicast_response(&mut self, flag: bool) -> &mut Self

Available on crate feature mdns only.

Changes mDNS unicast-response bit See RFC 6762

pub fn name(&self) -> &Name

QNAME           a domain name represented as a sequence of labels, where
                each label consists of a length octet followed by that
                number of octets.  The domain name terminates with the
                zero length octet for the null label of the root.  Note
                that this field may be an odd number of octets; no
                padding is used.

pub fn query_type(&self) -> RecordType

QTYPE           a two octet code which specifies the type of the query.
                The values for this field include all codes valid for a
                TYPE field, together with some more general codes which
                can match more than one type of RR.

pub fn query_class(&self) -> DNSClass

QCLASS          a two octet code that specifies the class of the query.
                For example, the QCLASS field is IN for the Internet.

pub fn mdns_unicast_response(&self) -> bool

Available on crate feature mdns only.

Returns if the mDNS unicast-response bit is set or not See RFC 6762

pub fn into_parts(self) -> QueryParts

Consumes Query and returns it’s components

Trait Implementations

impl<'r> BinDecodable<'r> for Query

fn read(decoder: &mut BinDecoder<'r>) -> ProtoResult<Self>

Read the type from the stream

fn from_bytes(bytes: &'r [u8]) -> ProtoResult<Self>

Returns the object in binary form

impl BinEncodable for Query

fn emit(&self, encoder: &mut BinEncoder<'_>) -> ProtoResult<()>

Write the type to the stream

fn to_bytes(&self) -> ProtoResult<Vec<u8>>

Returns the object in binary form

impl Clone for Query

fn clone(&self) -> Query

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Query

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Query

fn default() -> Self

Return a default query with an empty name and A, IN for the query_type and query_class

impl Display for Query

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl From<Query> for LowerQuery

fn from(query: Query) -> Self

Converts to this type from the input type.

impl From<Query> for QueryParts

fn from(q: Query) -> Self

Converts to this type from the input type.

impl Hash for Query

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Query

fn eq(&self, other: &Query) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Query

impl StructuralPartialEq for Query