/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 |