package dns-async
Install
Dune Dependency
Authors
Maintainers
Sources
sha256=75493f52caacaf6093a29781fdbe46217e34d21ca0a5930f0d8ac109babad021
md5=42a49a41d3b53567e074b864926d4411
CHANGES.md.html
v1.1.1 2019-01-25
Support Base64.3.0.0 interface (@avsm)
v1.1.0 2019-01-05
Improve parsing robustness with:
invalid pointers in packets
taking total packet size limitations into account
handling unknown opcodes gracefully without an exception Work done by @Willy-Tan in #154.
Port build from jbuilder to Dune (#155 #152 #153 by @paurkedal @samoht)
Update opam metadata to the 2.0 format.
v1.0.1 2017-11-06
dns-lwt-unix: add missing dependency on cmdliner (#145 by @avsm)
async: close reader and writer properly (#147 by @1yefuwang1)
fix build with OCaml 4.06 (and -safe-string) (#148 by @djs55)
v1.0.0 2017-06-23
Rearrange the opam
packages to eliminate optional dependencies, and have explicit and separate packages for the Lwt, Async and Mirage implementations. The opam
and ocamlfind
layouts now have the same names:
dns
: the core packagedns-lwt
: Lwt implementationdns-lwt-unix
: Lwt Unix, including serversdns-async
: Async implementation (this currently uses Unix)
This layout is not compatible with the older releases which had ocamlfind subpackages, so an upper bound will be needed in OPAM for those. However, porting should be relatively straightforward to the new release, and in return your users will not have to deal with specifying a myriad of optional dependencies in OPAM.
This release also ports the build to use Jbuilder, which speeds it up quite a bit and removes boilerplate files.
Depend on Lwt 3.0.0 interfaces, including the blocking bind.
v0.20.2 2017-06-01
Depend explicitly on
Ipaddr_unix
andUri_services
modules.Add a basic server example which has a static lookup table and does not use the Trie structure. It is in [examples/server.ml].
v0.20.1 2017-05-16
Port to lwt >= 3.0 (#136, @djs55)
v0.20.0 2017-03-23
Remove the
Dns.Buf
module that formerly wrapped Cstruct, now that the latter is a mature library.Add an
?alloc
optional argument to functions that would formerly accept aDns.Buf
. By default, this allocates a single page, but consumers of this library can override it in order to supply their own allocation logic (e.g. a pool allocator).Remove dependency on
io-page
to follow theDns.Buf
removal.
All these changes were part of #132 by @hannesm.
v0.19.1 2017-02-15
Use topkg instead of oasis (#126
Do not reverse the order of resource records in the parser (#109
Restrict to OCaml 4.03.0+.
Fix bug parsing pointers to pointers to DNS name labels (#129
v0.19.0 2017-01-20
Port to MirageOS 3 module types.
Remove runtime dependency on PPX from META file
Bugfixes and improvements for async backend compilation (#100 by @vbmithr).
v0.18.1 2016-04-17
Clear AA bit on requests, as some servers will drop these otherwise
v0.18.0 2016-03-12
Remove dependency on camlp4, switch to ppx
v0.17.0 2016-03-11
This library now depends on the
hashcons
package rather than containing a fork of it. Now that there is no LGPL (+ linking exception code left, clarify that the license is ISC. Previously theopam
file claimed a mixture of licenses (#86 via @djs55).Add multi-distro Travis testing support.
Library now depends on OCaml 4.02+
v0.16.0 2015-10-21
Change source port randomization to avoid overflow in the port range (#83 from @yomimono).
Improve mDNS support (#82 from Luke Dunstan):
Add
Dns.Probe
to implement the unique name probing portion of mDNS.Expose the
Dns.Name.Set
construct.Added a functor
Mdns_resolver_mirage.Chain
that is intended to compose an mDNS resolver with a normal DNS resolver such that*.local
is resolved via mDNS and everything else is done with DNS.Changed
Dns.Query
to not respond to queries for classes other than IN.Fixed mDNS legacy responses to use TTL <= 10 sec
Fixed mDNS responses to use RD=0.
v0.15.3 2015-07-30
Fix regression in 0.15.2 which prevented
Dns_server_unix.listen
from answering more than one query (#80 from Magnus Skjegstad)
v0.15.2 2015-07-04
Fix incorrect mirage dependency on tcpip
Improve clarity and formatting of Lwt use
Remove camlp4 dependency
Now requires lwt >2.4.7
v0.15.1 2015-07-02
Fix critical DNS resolver timeout bug causing unexpected exceptions
v0.15.0 2015-05-14
Name.domain_name has been renamed to Name.t and is now abstract
Name.domain_name_to_string has been renamed to Name.to_string
Name.string_to_domain_name has been deprecated for Name.of_string
Name.parse_name has been renamed to Name.parse
Name.marshal_name has been renamed to Name.marshal
Name.hashcons_charstring has been renamed to Name.hashcons_string
Name.hashcons_domainname has been renamed to Name.hashcons
Name.canon2key has been renamed to Name.to_key
Name.for_reverse has been replaced by Name.of_ipaddr
Name.of_ipaddr accepts a Ipaddr.t and produces a name suitable for reverse DNS
We now require >= ipaddr.2.6.0 to support Name.of_ipaddr
uri 1.7.0+ is now required for its uri.services service registry
Named service lookups are now supported in zone files
Dig string serializations are now in Dns.Dig (#61 from Heidi Howard
v0.14.1 2015-03-29
Reduce namespace pollution in
name.ml
to avoid breaking with Cstruct 1.6.0+.Add a
Dns_server.compose
function to make it easier to build resolution pipelines (#58).Add a
Dns_server_mirage
functor (#55).Add
Dns_resolver.resolve_pkt
to support custom query packets (#49).Split out the experimental Async_resolver into a
Async_kernel
and Unix libraries. This introduces thedns.async-unix
library.
v0.14.0 2015-01-29
Renamed
Packet.QM
toPacket.Q_Normal
andQU
toQ_mDNS_Unicast
for clarity and added more detailed doc comments. Added constructor functionPacket.make_question
for convenience. (#41Support
io-page
1.3.0+ interface. (#40
v0.13.0 2015-01-26
Add support for multicast DNS (RFC6762) in the trie. (#35 from Luke Dunstan
mDNS doesn't use SOA nor delegation (RFC 6762 section 12), so some minor changes to Trie are required to handle this.
mDNS doesn't echo the questions in the response (RFC 6762 section 6), except in legacy mode, so a
bool
argument was added toQuery.response_of_answer
.Query.answer
still exists but nowQuery.answer_multiple
is also available for answering multiple questions in one query to produce a single answer (RFC 6762 section 5.3). One caveat is that responses may exceed the maximum message length, but that is not really specific to mDNS. Also, in theory multiple questions might require multiple separate response messages in unusual cases, but that is complicated and the library does not deal with that yet.Query.answer_multiple
takes an optional function to allow the caller to control thecache-flush
bit. This bit is only set for records that have been "confirmed as unique". Using a callback requires minimal changes here but puts the burden of maintaining uniqueness state elsewhere.Query.answer_multiple
takes an optional function to filter the answer, in order to support "known answer suppression" (RFC 6762 section 7.1). Again, using a callback requires minimal change to the core, but later on the mDNS-specific known answer suppression logic could move into theQuery
module if that turns out to be simpler.A query for
PTR
returns additional records forSRV
andTXT
, to support efficient service discovery.Trie.iter
was added to support mDNS announcements.Switch to
Bytes
instead ofString
for eventual-safe-string
support.Partially remove some error printing to stderr. (#36
Unit tests were added for some of the changes above, including a test-only dependency on pcap-format
.
v0.12.0 2014-12-24
Parse and marshal the mDNS unicast-response bit (#29).
Add OUnit tests for
Dns.Packet.parse
usingpcap
files.Fix parsing of
SRV
records (#30).Use
Bytes
instead ofString
for mutable buffers.Switch to
Base64
v2, which usesB64
as the toplevel module name to avoid linking conflicts with other community libraries.
v0.11.0 2014-11-02
Do not depend in Io_page; instead
Dns.Buf.create
now accepts an optionalalloc
parameter to use a custom allocator such asIo_page
.Add Async DNS resolver modules from @marklrh (#22).
Add a Dns_resolver_mirage.Static for a static DNS interface.
v0.10.0 2014-08-20
Add
Dns_resolver_mirage
module for making stub resolution requests using the Mirage module types.Dns.Resolvconf
parses/etc/resolv.conf
entries usingIpaddr.t
instead ofstring
values now.Adapt
Dns_resolver
andDns_resolver_unix
to useIpaddr.t
more.Improve
mldig
to useIpaddr
more and add more RR printing to match the conventionaldig
tool behaviour.Expose
Dns.Packet.Not_implemented
exception rather than a pattern match failure.Depend on external
Base64
package instead of bundling one inside theDns
packed module.Add a local
opam
file for easier pinning.Add an
examples/
directory with a DNS forwarder sample (#21).
v0.9.1 2014-07-29
Fix file descriptor leak in resolver (#15, #16) by expanding
commfn
with a cleanup function.
v0.9.0 2014-06-16
Ensure that all
Dns.Buf.t
buffers are page-aligned, viaIo_page
.Remove a Unix dependency that snuck into the
Dns_resolver
portable core, by adding a timeout argument to thecommfn
type.Improve ocamldoc in
Dns_resolver_unix
.
v0.8.1 2014-04-19
Add
process_of_zonebufs
to handle multiple zone files.Adapt
Dns_server_unix
to expose multiple zonebuf functions.
v0.8.0 2014-02-21
Use
Ipaddr.V6
to restore IPv6/AAAA RR support.process_query
now takes an output buffer so it doesn't have to overwrite the input buffer it just parsed.Add Travis continuous integration scripts.
Regenerate with OASIS 0.4.1
Split the
dns.lwt
into a portabledns.lwt-core
that doesn't require Unix (from which a Mirage version can be built). The only change to existing applications is that Unix-specific functions have shifted intoDns_resolver_unix
orDns_server_unix
, with the module types forPROCESSOR
andCLIENT
unchanged.
v0.7.0 2013-08-26
Add path argument to `Resolv_conf in Dns_resolver.config.
Dns_resolver.t
is now a record type rather than a first-class module.Fix
mldig
server and port options.Change
Zone.load_zone
toZone.load
and make it functional overLoader.db
.Use
Ipaddr.V4.t
addresses in favor of Cstruct or Uri_IP representations.Fix
RRSIG
signed type to be of the answer rather than the question.Fix
ANY
queries.Add
Buf
to provide a nickname forchar Bigarray
s.Change
Packet.{parse,marshal}
to use Buf.t rather than exposing Cstruct.tChange
Packet.parse
to remove name map parameterFactor protocol modules into
Protocol
with default DNS implementationsAdd first-class
PROCESSOR
module toDns_server
for contextual protocol extensionsChange
Dns_server.listen
to accept processorRename
Dns_server.listen_with_zonebuf
andDns_server.listen_with_zonefile
toDns_server.serve_with_zonebuf
andDns_server.serve_with_zonefile
resp.Add
processor_of_process
,process_of_zonebuf
,eventual_process_of_zonefile
, andserve_with_processor
toDns_server
Rename
Query.query_answer
toQuery.answer
Add
Query.response_of_answer
andQuery.answer_of_response
Move
Dns_resolver.build_query
toQuery.create
By default, DNS packet IDs are randomly generated with Random
Dns_resolver
now supports simultaneous resolver protocol requestsFix reversed multiple TXT parse bug
Move DNSSEC implementation to <//github.com/dsheets/ocaml-dnssec>
v0.6.2 2013-02-13
Fix Lwt compilation after switch to
Dns.Names.Map
instead ofHashtbl
.Fix Lwt Makefile detection (
Lwt.unix
instead ofLwt.ssl
v0.6.1 2013-02-12
Improve performance of packet marshalling.
Add a Mirage
Dns_server
subpackage.
v0.6.0 2012-12-31
(Very) experimental DNSSEC support.
Use cstruct-0.6.0 API.
Improve robustness of
Dns_resolver
.Add EDNS0 support for larger packet sizes.
v0.5.2 2012-11-28
Fix the server interface to be fully asynchronous.
Correct
q_type
/q_class
arguments being ignored in the Lwt Dns_resolver (from Pierre Chambart).
v0.5.1 2012-10-05
Remain compatible with OCaml-3.12.1 with the more verbose first-class module syntax.
v0.5.0 2012-09-29
Add mldig as a full(ish)-featured dig clone, with similar output format.
Add
Dns.Resolvconf
for parsing/etc/resolv.conf
files on POSIX hosts.Move the Lwt bits (resolver, server, cmdline client) into a separate directory, to follow the Cohttp convention.
v0.4.0 2012-09-18
Initial public release.