dns-client-lwt 8.0.0 · OCaml Package (2024)

Table of Contents
ocaml-dns - a Domain Name System (DNS) library Supported RFCs Installation Documentation Transition from older versions Development

ocaml-dns - a Domain Name System (DNS) library

(c) 2017-2019 Hannes Mehnert (robur.io, Center for the Cultivation of Technology)

v8.0.0

This library supports most of the domain name system used in the wild. It adheres to strict conventions. Failing early and hard. It is mostly implemented in the pure fragment of OCaml (no mutation, isolated IO, no exceptions).

It all started out as an experiment to run a recursive resolver, but after initial prototypes it turned out that every configurable recursive resolver needs a fully-fledged authoritative nameserver as well (for overriding various zones such as .localhost and reverse lookups of RFC 1918 IP ranges).

Legacy resource record types are not dealt with, and there is no plan to support ISDN, MAILA, MAILB, WKS, MB, HINFO, ... . AXFR, IXFR, and UPDATE is only handled via TCP connections. The only resource class supported is IN (the Internet). Truncated hmac in TSIG are not supported (always the full length of the hash algorithm is used).

Please read the blog article for a more detailed overview.

This library is published under the 2 clause BSD license.

Supported RFCs

*: Please note that the RFCs marked with * are only partially implemented (i.e. only wire format, but no logic handling the feature).

Installation

You first need to install OCaml (at least 4.08.2) and opam, the OCaml package manager (at least 2.0.0) on your machine (you can use opam to install an up-to-date OCaml (opam switch 4.08.2)).

You may want to follow the mirage installation instructions to get mirage installed on your computer.

To minimize the amount of run-time dependencies for each individual functionality, the library is split into multiple opam packages (core, server, client, resolver, cli, certify), with multiple ocamlfind libraries for the different backends (no optional dependencies) -- i.e. dns-server.mirage contains the MirageOS-specific DNS server code.

Now the µDNS library is installed, and you can try out the examples. Find some examples at the unikernel repository.

Documentation

API documentation is available online.

Transition from older versions

The pre-4.0.0 versions of ocaml-dns had a significantly different interface, and so applications using them will need to be rewritten to follow the stricter coding style used in the post-4.0.0 branches. The major improvements from 1.x to the 4.x series are:

  • data (rrset) is defined in a single GADT in Rr_map

  • added support for: notify, dynamic update, zone transfer, tsig (hmac authentication), edns

  • no mutable data structures, leading to easier reasoning about library state

  • switched to an independent domain_name library which uses a faster and more compact string array instead of string list for storing domain names

  • integration with LetsEncrypt for provisioning valid X.509 certificates

  • no use of exceptions, instead preferring explicit result values from API functions

Please get in touch on mirageos-devel@lists.xenproject.org or on the Discuss forum at https://discuss.ocaml.org (with the mirageos tag) if you have any questions about migrating (or just general questions).

Development

To work with the opam packages provided when developing modifications to DNS, or when pinning a specific version, you will have to pin the same version for all of them:

: csh syntaxset version=4.99.0set repo=git+https://github.com/mirage/ocaml-dns.git# the -y parameter means "force" or# "do go ahead and register a new package"# the -n parameter means# "just register the pin, don't actually install it yet"foreach pkg ( dns dns-{certify,cli,client,resolver,server,mirage,tsig,stub} ) opam pin add -y -n $pkg.$version --dev $repoend
: bash syntaxversion=4.99.0repo=git+https://github.com/mirage/ocaml-dns.gitfor pkg in dns dns-{certify,cli,client,resolver,server,mirage,tsig,stub}do opam pin add -y -n $pkg.$version --dev $repodone

Now you can install the packages you need, for instance:

opam install dns-client

or

opam install dns-resolver
dns-client-lwt 8.0.0 · OCaml Package (2024)
Top Articles
AXIS Q6078-E PTZ Camera | Axis Communications
AXIS Q6078-E PTZ Camera | Axis Communications
Craigslist For Tennessee
Costa Rica Sightseeing: 10 Must-Visit Places - Caravan Tours
The Civil Rights movement Evolvement
Election latest: Party leaders vote as the UK goes to the polls; dogs spotted at polling stations
Stamp Dealers Near Me- West Coast Stamp Company
Who Buys Stamps Near Me [Buyers Map + Selling Guide + FAQ]
Dezire Spa 917-780-0869 Indian Queens Village
The Long Island Utopia Guide: Exploring Paradise on Earth - THE SECRET LINE
La Copa América se queda sin anfitrión: Estados Unidos es eliminado por Uruguay
How to spend a glamorous weekend in Los Angeles
Latest Posts
Canon QY6-0086 ab 88,96 € günstig im Preisvergleich kaufen
AXIS Q6078-E PTZ Camera | Axis Communications
Article information

Author: Edwin Metz

Last Updated:

Views: 6816

Rating: 4.8 / 5 (58 voted)

Reviews: 81% of readers found this page helpful

Author information

Name: Edwin Metz

Birthday: 1997-04-16

Address: 51593 Leanne Light, Kuphalmouth, DE 50012-5183

Phone: +639107620957

Job: Corporate Banking Technician

Hobby: Reading, scrapbook, role-playing games, Fishing, Fishing, Scuba diving, Beekeeping

Introduction: My name is Edwin Metz, I am a fair, energetic, helpful, brave, outstanding, nice, helpful person who loves writing and wants to share my knowledge and understanding with you.