mirrors/hello-dns
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

clarify documentation on dnsmessagewriter

Browse Source
This commit is contained in:
bert hubert
2018-04-13 18:08:49 +02:00
parent 90e51417f0
commit b1cfe3a36a
1 changed files with 5 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
tdns/README.md
View File

@ -671,14 +671,12 @@ to do pointer arithmetic. For security purposes, `DNSMessageReader` uses
bounds checking access methods exclusively.
## DNSMessageWriter
This class creates DNS messages. It has a method for setting the `qname` and
`qtype` of the message. If called, this also resets the message to its
original state. Packets are only written in order. So it is not possible to
change the `qname` after adding a resource record. This is why the state
resets on calling `setQuestion()`.
This class creates DNS messages, and in its constructor it needs to know the
name and type it is creating a message for.
Note: this should probably move to the constructor so it becomes impossible
to do it wrong.
Packets are only written in order. So it is not possible to
change the `qname` after adding a resource record. Resource records must
also be added together as RRSets, and in 'section order'.
Internally `DNSMessageWriter` again only uses bounds checked methods for
modifying its state.