1 //! Logic to read and write resource record (streams)
4 use alloc::string::String;
8 pub(crate) fn read_u8(inp: &mut &[u8]) -> Result<u8, ()> {
9 let res = *inp.get(0).ok_or(())?;
13 pub(crate) fn read_u16(inp: &mut &[u8]) -> Result<u16, ()> {
14 if inp.len() < 2 { return Err(()); }
15 let mut bytes = [0; 2];
16 bytes.copy_from_slice(&inp[..2]);
18 Ok(u16::from_be_bytes(bytes))
20 pub(crate) fn read_u32(inp: &mut &[u8]) -> Result<u32, ()> {
21 if inp.len() < 4 { return Err(()); }
22 let mut bytes = [0; 4];
23 bytes.copy_from_slice(&inp[..4]);
25 Ok(u32::from_be_bytes(bytes))
28 fn read_wire_packet_labels(inp: &mut &[u8], wire_packet: &[u8], name: &mut String) -> Result<(), ()> {
30 let len = read_u8(inp)? as usize;
32 if name.is_empty() { *name += "."; }
34 } else if len >= 0xc0 {
35 let offs = ((len & !0xc0) << 8) | read_u8(inp)? as usize;
36 if offs >= wire_packet.len() { return Err(()); }
37 read_wire_packet_labels(&mut &wire_packet[offs..], wire_packet, name)?;
40 if inp.len() <= len { return Err(()); }
41 *name += core::str::from_utf8(&inp[..len]).map_err(|_| ())?;
44 if name.len() > 255 { return Err(()); }
49 pub(crate) fn read_wire_packet_name(inp: &mut &[u8], wire_packet: &[u8]) -> Result<Name, ()> {
50 let mut name = String::with_capacity(1024);
51 read_wire_packet_labels(inp, wire_packet, &mut name)?;
55 pub(crate) trait Writer { fn write(&mut self, buf: &[u8]); }
56 impl Writer for Vec<u8> { fn write(&mut self, buf: &[u8]) { self.extend_from_slice(buf); } }
57 #[cfg(feature = "validation")]
58 impl Writer for ring::digest::Context { fn write(&mut self, buf: &[u8]) { self.update(buf); } }
59 pub(crate) fn write_name<W: Writer>(out: &mut W, name: &str) {
60 let canonical_name = name.to_ascii_lowercase();
61 if canonical_name == "." {
64 for label in canonical_name.split(".") {
65 out.write(&(label.len() as u8).to_be_bytes());
66 out.write(label.as_bytes());
70 pub(crate) fn name_len(name: &Name) -> u16 {
71 if name.as_str() == "." {
75 for label in name.split(".") {
76 res += 1 + label.len();
82 pub(crate) fn parse_wire_packet_rr(inp: &mut &[u8], wire_packet: &[u8]) -> Result<(RR, u32), ()> {
83 let name = read_wire_packet_name(inp, wire_packet)?;
84 let ty = read_u16(inp)?;
85 let class = read_u16(inp)?;
86 if class != 1 { return Err(()); } // We only support the INternet
87 let ttl = read_u32(inp)?;
88 let data_len = read_u16(inp)? as usize;
89 if inp.len() < data_len { return Err(()); }
90 let data = &inp[..data_len];
91 *inp = &inp[data_len..];
94 A::TYPE => RR::A(A::read_from_data(name, data, wire_packet)?),
95 AAAA::TYPE => RR::AAAA(AAAA::read_from_data(name, data, wire_packet)?),
96 NS::TYPE => RR::NS(NS::read_from_data(name, data, wire_packet)?),
97 Txt::TYPE => RR::Txt(Txt::read_from_data(name, data, wire_packet)?),
98 CName::TYPE => RR::CName(CName::read_from_data(name, data, wire_packet)?),
99 TLSA::TYPE => RR::TLSA(TLSA::read_from_data(name, data, wire_packet)?),
100 DnsKey::TYPE => RR::DnsKey(DnsKey::read_from_data(name, data, wire_packet)?),
101 DS::TYPE => RR::DS(DS::read_from_data(name, data, wire_packet)?),
102 RRSig::TYPE => RR::RRSig(RRSig::read_from_data(name, data, wire_packet)?),
108 pub(crate) fn parse_rr(inp: &mut &[u8]) -> Result<RR, ()> {
109 parse_wire_packet_rr(inp, &[]).map(|(rr, _)| rr)
112 /// Parse a stream of [`RR`]s from the format described in [RFC 9102](https://www.rfc-editor.org/rfc/rfc9102.html).
114 /// Note that this is only the series of `AuthenticationChain` records, and does not read the
115 /// `ExtSupportLifetime` field at the start of a `DnssecChainExtension`.
116 pub fn parse_rr_stream(mut inp: &[u8]) -> Result<Vec<RR>, ()> {
117 let mut res = Vec::with_capacity(32);
118 while !inp.is_empty() {
119 res.push(parse_rr(&mut inp)?);
124 /// Writes the given resource record in its wire encoding to the given `Vec`.
126 /// An [RFC 9102](https://www.rfc-editor.org/rfc/rfc9102.html) `AuthenticationChain` is simply a
127 /// series of such records with no additional bytes in between.
128 pub fn write_rr<RR: Record>(rr: &RR, ttl: u32, out: &mut Vec<u8>) {
129 write_name(out, rr.name());
130 out.extend_from_slice(&rr.ty().to_be_bytes());
131 out.extend_from_slice(&1u16.to_be_bytes()); // The INternet class
132 out.extend_from_slice(&ttl.to_be_bytes());
133 rr.write_u16_len_prefixed_data(out);