Coverage Report

Created: 2025-06-13 06:28

/src/pdns/pdns/dnswriter.hh
Line
Count
Source (jump to first uncovered line)
1
/*
2
 * This file is part of PowerDNS or dnsdist.
3
 * Copyright -- PowerDNS.COM B.V. and its contributors
4
 *
5
 * This program is free software; you can redistribute it and/or modify
6
 * it under the terms of version 2 of the GNU General Public License as
7
 * published by the Free Software Foundation.
8
 *
9
 * In addition, for the avoidance of any doubt, permission is granted to
10
 * link this program with OpenSSL and to (re)distribute the binaries
11
 * produced as the result of such linking.
12
 *
13
 * This program is distributed in the hope that it will be useful,
14
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16
 * GNU General Public License for more details.
17
 *
18
 * You should have received a copy of the GNU General Public License
19
 * along with this program; if not, write to the Free Software
20
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
21
 */
22
#pragma once
23
#include <string>
24
#include <vector>
25
#include <map>
26
#include "dns.hh"
27
#include "dnsname.hh"
28
#include "namespaces.hh"
29
#include "iputils.hh"
30
#include "svc-records.hh"
31
#include <arpa/inet.h>
32
33
34
/** this class can be used to write DNS packets. It knows about DNS in the sense that it makes
35
    the packet header and record headers.
36
37
    The model is:
38
39
    packetheader (recordheader recordcontent)*
40
41
    The packetheader needs to be updated with the amount of packets of each kind (answer, auth, additional)
42
43
    Each recordheader contains the length of a dns record.
44
45
    Calling convention:
46
47
    vector<uint8_t> content;
48
    DNSPacketWriter dpw(content, const string& qname, uint16_t qtype, uint16_t qclass=QClass:IN);  // sets the question
49
    dpw.startrecord("this.is.an.ip.address.", ns_t_a);    // does nothing, except store qname and qtype
50
    dpw.xfr32BitInt(0x01020304);                         // adds 4 bytes (0x01020304) to the record buffer
51
    dpw.startrecord("this.is.an.ip.address.", ns_t_a);    // aha! writes out dnsrecord header containing qname and qtype and length 4, plus the recordbuffer, which gets emptied
52
                                                         // new qname and qtype are stored
53
    dpw.xfr32BitInt(0x04030201);                         // adds 4 bytes (0x04030201) to the record buffer
54
    dpw.commit();                                        // writes out dnsrecord header containing qname and qtype and length 4, plus the recordbuffer
55
56
    // content now contains the ready packet, with 1 question and 2 answers
57
58
*/
59
60
template <typename Container> class GenericDNSPacketWriter : public boost::noncopyable
61
{
62
63
public:
64
  //! Start a DNS Packet in the vector passed, with question qname, qtype and qclass
65
  GenericDNSPacketWriter(Container& content, const DNSName& qname, uint16_t  qtype, uint16_t qclass=QClass::IN, uint8_t opcode=0);
66
67
  /** Start a new DNS record within this packet for name, qtype, ttl, class and in the requested place. Note that packets can only be written in natural order -
68
      ANSWER, AUTHORITY, ADDITIONAL */
69
  void startRecord(const DNSName& name, uint16_t qtype, uint32_t ttl=3600, uint16_t qclass=QClass::IN, DNSResourceRecord::Place place=DNSResourceRecord::ANSWER, bool compress=true);
70
71
  /** Shorthand way to add an Opt-record, for example for EDNS0 purposes */
72
  using optvect_t = vector<pair<uint16_t,std::string> >;
73
  void addOpt(const uint16_t udpsize, const uint16_t extRCode, const uint16_t ednsFlags, const optvect_t& options=optvect_t(), const uint8_t version=0);
74
75
  /** needs to be called after the last record is added, but can be called again and again later on. Is called internally by startRecord too.
76
      The content of the vector<> passed to the constructor is inconsistent until commit is called.
77
   */
78
  void commit();
79
80
  uint32_t size() const; // needs to be 32 bit because otherwise we don't see the wrap coming when it happened!
81
82
  /** Should the packet have grown too big for the writer's liking, rollback removes the record currently being written */
83
  void rollback();
84
85
  /** Discard all content except the question section */
86
  void truncate();
87
88
  void xfr48BitInt(uint64_t val);
89
  void xfrNodeOrLocatorID(const NodeOrLocatorID& val);
90
  void xfr32BitInt(uint32_t val);
91
  void xfr16BitInt(uint16_t val);
92
  void xfrType(uint16_t val)
93
0
  {
94
0
    xfr16BitInt(val);
95
0
  }
Unexecuted instantiation: GenericDNSPacketWriter<std::__1::vector<unsigned char, std::__1::allocator<unsigned char> > >::xfrType(unsigned short)
Unexecuted instantiation: GenericDNSPacketWriter<std::__1::vector<unsigned char, noinit_adaptor<std::__1::allocator<unsigned char> > > >::xfrType(unsigned short)
96
  void xfrIP(const uint32_t& val)
97
0
  {
98
0
    xfr32BitInt(htonl(val));
99
0
  }
Unexecuted instantiation: GenericDNSPacketWriter<std::__1::vector<unsigned char, std::__1::allocator<unsigned char> > >::xfrIP(unsigned int const&)
Unexecuted instantiation: GenericDNSPacketWriter<std::__1::vector<unsigned char, noinit_adaptor<std::__1::allocator<unsigned char> > > >::xfrIP(unsigned int const&)
100
  void xfrIP6(const std::string& val)
101
0
  {
102
0
    xfrBlob(val,16);
103
0
  }
Unexecuted instantiation: GenericDNSPacketWriter<std::__1::vector<unsigned char, std::__1::allocator<unsigned char> > >::xfrIP6(std::__1::basic_string<char, std::__1::char_traits<char>, std::__1::allocator<char> > const&)
Unexecuted instantiation: GenericDNSPacketWriter<std::__1::vector<unsigned char, noinit_adaptor<std::__1::allocator<unsigned char> > > >::xfrIP6(std::__1::basic_string<char, std::__1::char_traits<char>, std::__1::allocator<char> > const&)
104
105
  void xfrCAWithoutPort(uint8_t version, const ComboAddress &val)
106
0
  {
107
0
    if (version == 4) xfrIP(val.sin4.sin_addr.s_addr);
108
0
    else if (version == 6) {
109
0
      string blob;
110
0
      blob.assign((const char*)val.sin6.sin6_addr.s6_addr, 16);
111
0
      xfrBlob(blob, 16);
112
0
    }
113
0
    else throw runtime_error("invalid IP protocol");
114
0
  }
Unexecuted instantiation: GenericDNSPacketWriter<std::__1::vector<unsigned char, std::__1::allocator<unsigned char> > >::xfrCAWithoutPort(unsigned char, ComboAddress const&)
Unexecuted instantiation: GenericDNSPacketWriter<std::__1::vector<unsigned char, noinit_adaptor<std::__1::allocator<unsigned char> > > >::xfrCAWithoutPort(unsigned char, ComboAddress const&)
115
116
  void xfrCAPort(const ComboAddress &val)
117
0
  {
118
0
    uint16_t port;
119
0
    port = val.sin4.sin_port;
120
0
    xfr16BitInt(port);
121
0
  }
Unexecuted instantiation: GenericDNSPacketWriter<std::__1::vector<unsigned char, std::__1::allocator<unsigned char> > >::xfrCAPort(ComboAddress const&)
Unexecuted instantiation: GenericDNSPacketWriter<std::__1::vector<unsigned char, noinit_adaptor<std::__1::allocator<unsigned char> > > >::xfrCAPort(ComboAddress const&)
122
123
  void xfrTime(const uint32_t& val)
124
0
  {
125
0
    xfr32BitInt(val);
126
0
  }
Unexecuted instantiation: GenericDNSPacketWriter<std::__1::vector<unsigned char, std::__1::allocator<unsigned char> > >::xfrTime(unsigned int const&)
Unexecuted instantiation: GenericDNSPacketWriter<std::__1::vector<unsigned char, noinit_adaptor<std::__1::allocator<unsigned char> > > >::xfrTime(unsigned int const&)
127
128
  void xfr8BitInt(uint8_t val);
129
130
  void xfrName(const DNSName& name, bool compress=false);
131
  void xfrText(const string& text, bool multi=false, bool lenField=true);
132
  void xfrUnquotedText(const string& text, bool lenField);
133
  void xfrBlob(const string& blob, int len=-1);
134
  void xfrBlob(const vector<uint8_t>& blob);
135
  void xfrSvcParamKeyVals(const set<SvcParam>& kvs);
136
  void xfrBlobNoSpaces(const string& blob, int len=-1);
137
  void xfrHexBlob(const string& blob, bool keepReading=false);
138
139
  dnsheader* getHeader();
140
  void getRecordPayload(string& records); // call __before commit__
141
  void getWireFormatContent(string& record); // call __before commit__
142
143
  void setCanonic(bool val)
144
0
  {
145
0
    d_canonic=val;
146
0
  }
Unexecuted instantiation: GenericDNSPacketWriter<std::__1::vector<unsigned char, std::__1::allocator<unsigned char> > >::setCanonic(bool)
Unexecuted instantiation: GenericDNSPacketWriter<std::__1::vector<unsigned char, noinit_adaptor<std::__1::allocator<unsigned char> > > >::setCanonic(bool)
147
148
  void setLowercase(bool val)
149
0
  {
150
0
    d_lowerCase=val;
151
0
  }
Unexecuted instantiation: GenericDNSPacketWriter<std::__1::vector<unsigned char, std::__1::allocator<unsigned char> > >::setLowercase(bool)
Unexecuted instantiation: GenericDNSPacketWriter<std::__1::vector<unsigned char, noinit_adaptor<std::__1::allocator<unsigned char> > > >::setLowercase(bool)
152
  Container& getContent()
153
0
  {
154
0
    return d_content;
155
0
  }
Unexecuted instantiation: GenericDNSPacketWriter<std::__1::vector<unsigned char, std::__1::allocator<unsigned char> > >::getContent()
Unexecuted instantiation: GenericDNSPacketWriter<std::__1::vector<unsigned char, noinit_adaptor<std::__1::allocator<unsigned char> > > >::getContent()
156
0
  bool eof() { return true; } // we don't know how long the record should be
Unexecuted instantiation: GenericDNSPacketWriter<std::__1::vector<unsigned char, std::__1::allocator<unsigned char> > >::eof()
Unexecuted instantiation: GenericDNSPacketWriter<std::__1::vector<unsigned char, noinit_adaptor<std::__1::allocator<unsigned char> > > >::eof()
157
158
0
  const string getRemaining() const {
159
0
    return "";
160
0
  }
Unexecuted instantiation: GenericDNSPacketWriter<std::__1::vector<unsigned char, std::__1::allocator<unsigned char> > >::getRemaining() const
Unexecuted instantiation: GenericDNSPacketWriter<std::__1::vector<unsigned char, noinit_adaptor<std::__1::allocator<unsigned char> > > >::getRemaining() const
161
162
  size_t getSizeWithOpts(const optvect_t& options) const;
163
164
private:
165
  uint16_t lookupName(const DNSName& name, uint16_t* matchlen);
166
  vector<uint16_t> d_namepositions;
167
  // We declare 1 uint_16 in the public section, these 3 align on a 8-byte boundary
168
  uint16_t d_sor;
169
  uint16_t d_rollbackmarker; // start of last complete packet, for rollback
170
171
  Container& d_content;
172
  DNSName d_qname;
173
174
  uint16_t d_truncatemarker; // end of header, for truncate
175
  DNSResourceRecord::Place d_recordplace{DNSResourceRecord::QUESTION};
176
  bool d_canonic{false}, d_lowerCase{false}, d_compress{false};
177
};
178
179
using DNSPacketWriter = GenericDNSPacketWriter<std::vector<uint8_t>>;
180
181
typedef vector<pair<string::size_type, string::size_type> > labelparts_t;
182
// bool labeltokUnescape(labelparts_t& parts, const DNSName& label);
183
std::vector<string> segmentDNSText(const string& text); // from dnslabeltext.rl