Trait domain::base::octets::Compose

pub trait Compose {
    fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>;

    fn compose_canonical<T: OctetsBuilder>(
        &self, 
        target: &mut T
    ) -> Result<(), ShortBuf> { ... }
}

A type that knows how to compose itself into an octets builder.

The term ‘composing’ refers to the process of creating a DNS wire-format representation of a value’s data by appending this representation to the end of an octets builder.

The trait supports two different representations: a concrete and a canonical representation. The former represents the actual data of the value. For instance, it reflects the capitalisation of strings. The canonical representation is used when calculating digests or ordering values. Typically, it ignores capitalization and never compresses domain names. See the documentation of CanonicalOrd for more details on canonical representation.

Required methods

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

Appends the concrete representation of the value to the target.

If the representation doesn’t fit into the builder, returns an error. In this case the target is considered undefined. If it is supposed to be reused, it needs to be reset specifically.

Loading content...

Provided methods

fn compose_canonical<T: OctetsBuilder>(
    &self,
    target: &mut T
) -> Result<(), ShortBuf>

Appends the canonical representation of the value to the target.

If the representation doesn’t fit into the builder, returns an error. In this case the target is considered undefined. If it is supposed to be reused, it needs to be reset specifically.

Loading content...

Implementations on Foreign Types

impl<'a, C: Compose + ?Sized> Compose for &'a C

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

fn compose_canonical<T: OctetsBuilder>(
    &self,
    target: &mut T
) -> Result<(), ShortBuf>

impl Compose for i8

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

impl Compose for u8

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

impl Compose for i16

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

impl Compose for u16

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

impl Compose for i32

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

impl Compose for u32

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

Loading content...

Implementors

impl Compose for Class

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

impl Compose for DigestAlg

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

impl Compose for Nsec3HashAlg

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

impl Compose for Opcode

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

impl Compose for OptionCode

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

impl Compose for TsigRcode

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

impl Compose for Rtype

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

impl Compose for SecAlg

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

impl Compose for HeaderSection

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

impl Compose for Label

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

fn compose_canonical<T: OctetsBuilder>(
    &self,
    target: &mut T
) -> Result<(), ShortBuf>

impl Compose for Ipv4Addr

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

impl Compose for Ipv6Addr

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

impl Compose for Expire

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

impl Compose for TcpKeepalive

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

impl Compose for Padding

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

impl Compose for ClientSubnet

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

impl Compose for Cookie

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

impl Compose for OptHeader

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

impl Compose for OptionHeader

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

impl Compose for Serial

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

impl Compose for A

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

impl Compose for Time48

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

impl Compose for Aaaa

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

impl<L: ToRelativeDname, R: ToEitherDname> Compose for domain::base::name::Chain<L, R>

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

fn compose_canonical<T: OctetsBuilder>(
    &self,
    target: &mut T
) -> Result<(), ShortBuf>

impl<N: ToDname> Compose for Question<N>

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

fn compose_canonical<T: OctetsBuilder>(
    &self,
    target: &mut T
) -> Result<(), ShortBuf>

impl<N: ToDname> Compose for Cname<N>

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

fn compose_canonical<T: OctetsBuilder>(
    &self,
    target: &mut T
) -> Result<(), ShortBuf>

impl<N: ToDname> Compose for Mb<N>

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

fn compose_canonical<T: OctetsBuilder>(
    &self,
    target: &mut T
) -> Result<(), ShortBuf>

impl<N: ToDname> Compose for Md<N>

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

fn compose_canonical<T: OctetsBuilder>(
    &self,
    target: &mut T
) -> Result<(), ShortBuf>

impl<N: ToDname> Compose for Mf<N>

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

fn compose_canonical<T: OctetsBuilder>(
    &self,
    target: &mut T
) -> Result<(), ShortBuf>

impl<N: ToDname> Compose for Mg<N>

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

fn compose_canonical<T: OctetsBuilder>(
    &self,
    target: &mut T
) -> Result<(), ShortBuf>

impl<N: ToDname> Compose for Minfo<N>

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

fn compose_canonical<T: OctetsBuilder>(
    &self,
    target: &mut T
) -> Result<(), ShortBuf>

impl<N: ToDname> Compose for Mr<N>

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

fn compose_canonical<T: OctetsBuilder>(
    &self,
    target: &mut T
) -> Result<(), ShortBuf>

impl<N: ToDname> Compose for Mx<N>

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

fn compose_canonical<T: OctetsBuilder>(
    &self,
    target: &mut T
) -> Result<(), ShortBuf>

impl<N: ToDname> Compose for Ns<N>

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

fn compose_canonical<T: OctetsBuilder>(
    &self,
    target: &mut T
) -> Result<(), ShortBuf>

impl<N: ToDname> Compose for Ptr<N>

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

fn compose_canonical<T: OctetsBuilder>(
    &self,
    target: &mut T
) -> Result<(), ShortBuf>

impl<N: ToDname> Compose for Soa<N>

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

fn compose_canonical<T: OctetsBuilder>(
    &self,
    target: &mut T
) -> Result<(), ShortBuf>

impl<N: ToDname> Compose for domain::rdata::rfc6672::Dname<N>

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

fn compose_canonical<T: OctetsBuilder>(
    &self,
    target: &mut T
) -> Result<(), ShortBuf>

impl<N: ToDname, D: RecordData> Compose for Record<N, D>

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

fn compose_canonical<T: OctetsBuilder>(
    &self,
    target: &mut T
) -> Result<(), ShortBuf>

impl<N: Compose> Compose for Srv<N>

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

fn compose_canonical<T: OctetsBuilder>(
    &self,
    target: &mut T
) -> Result<(), ShortBuf>

impl<Name: Compose> Compose for RecordHeader<Name>

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

fn compose_canonical<T: OctetsBuilder>(
    &self,
    target: &mut T
) -> Result<(), ShortBuf>

impl<Name: Compose> Compose for ProtoRrsig<Name>

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

fn compose_canonical<T: OctetsBuilder>(
    &self,
    target: &mut T
) -> Result<(), ShortBuf>

impl<O, N> Compose for AllRecordData<O, N> where
    O: AsRef<[u8]>,
    N: ToDname, 

fn compose<T: OctetsBuilder>(&self, buf: &mut T) -> Result<(), ShortBuf>

fn compose_canonical<T: OctetsBuilder>(
    &self,
    buf: &mut T
) -> Result<(), ShortBuf>

impl<O, N> Compose for MasterRecordData<O, N> where
    O: AsRef<[u8]>,
    N: ToDname, 

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

fn compose_canonical<T: OctetsBuilder>(
    &self,
    target: &mut T
) -> Result<(), ShortBuf>

impl<O: AsRef<[u8]>, N: Compose> Compose for Tsig<O, N>

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

impl<Octets, R: ToDname> Compose for domain::base::name::Chain<UncertainDname<Octets>, R> where
    Octets: AsRef<[u8]>,
    R: ToDname, 

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

fn compose_canonical<T: OctetsBuilder>(
    &self,
    target: &mut T
) -> Result<(), ShortBuf>

impl<Octets: AsRef<[u8]> + ?Sized> Compose for CharStr<Octets>

fn compose<Target: OctetsBuilder>(
    &self,
    target: &mut Target
) -> Result<(), ShortBuf>

impl<Octets: AsRef<[u8]> + ?Sized> Compose for domain::base::Dname<Octets>

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

fn compose_canonical<T: OctetsBuilder>(
    &self,
    target: &mut T
) -> Result<(), ShortBuf>

impl<Octets: AsRef<[u8]> + ?Sized> Compose for RelativeDname<Octets>

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

fn compose_canonical<T: OctetsBuilder>(
    &self,
    target: &mut T
) -> Result<(), ShortBuf>

impl<Octets: AsRef<[u8]>> Compose for UncertainDname<Octets>

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

fn compose_canonical<T: OctetsBuilder>(
    &self,
    target: &mut T
) -> Result<(), ShortBuf>

impl<Octets: AsRef<[u8]>> Compose for AllOptData<Octets>

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

impl<Octets: AsRef<[u8]>> Compose for Opt<Octets>

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

impl<Octets: AsRef<[u8]>> Compose for UnknownOptData<Octets>

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

impl<Octets: AsRef<[u8]>> Compose for UnknownRecordData<Octets>

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

impl<Octets: AsRef<[u8]>> Compose for Nsid<Octets>

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

impl<Octets: AsRef<[u8]>> Compose for Dau<Octets>

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

impl<Octets: AsRef<[u8]>> Compose for Dhu<Octets>

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

impl<Octets: AsRef<[u8]>> Compose for N3u<Octets>

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

impl<Octets: AsRef<[u8]>> Compose for domain::base::opt::rfc7901::Chain<Octets>

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

impl<Octets: AsRef<[u8]>> Compose for KeyTag<Octets>

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

impl<Octets: AsRef<[u8]>> Compose for Hinfo<Octets>

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

impl<Octets: AsRef<[u8]>> Compose for Null<Octets>

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

impl<Octets: AsRef<[u8]>> Compose for Txt<Octets>

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

impl<Octets: AsRef<[u8]>> Compose for Dnskey<Octets>

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

impl<Octets: AsRef<[u8]>> Compose for Ds<Octets>

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

impl<Octets: AsRef<[u8]>> Compose for RtypeBitmap<Octets>

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

impl<Octets: AsRef<[u8]>> Compose for Nsec3<Octets>

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

impl<Octets: AsRef<[u8]>> Compose for Nsec3param<Octets>

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

impl<Octets: AsRef<[u8]>> Compose for Cdnskey<Octets>

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

impl<Octets: AsRef<[u8]>> Compose for Cds<Octets>

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

impl<Octets: AsRef<[u8]>, Name: Compose> Compose for Nsec<Octets, Name>

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

impl<Octets: AsRef<[u8]>, Name: Compose> Compose for Rrsig<Octets, Name>

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

fn compose_canonical<T: OctetsBuilder>(
    &self,
    target: &mut T
) -> Result<(), ShortBuf>

impl<Ref: AsRef<[u8]>> Compose for ParsedDname<Ref>

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

fn compose_canonical<T: OctetsBuilder>(
    &self,
    target: &mut T
) -> Result<(), ShortBuf>

Loading content...