package happy-eyeballs-mirage

  1. Overview
  2. Docs
Connecting to a remote host via IP version 4 or 6 using Mirage

Install

Dune Dependency

Authors

Maintainers

Sources

happy-eyeballs-0.3.1.tbz
sha256=de866cb7b4d689813bf42265093f07d0fb77498959955c037c86f0e5cb80e2d5
sha512=11dc45c9fe1c5932bb8649f4173d779b8d124bb021922e8a90fcdad17709348be4c83951bfd6e664426d28a394ec0e004f7de81991403011a27db985be93f3d0

Description

Happy eyeballs is an implementation of RFC 8305 which specifies how to connect to a remote host using either IP protocol version 4 or IP protocol version 6. This uses Lwt and Mirage for side effects.

Published: 25 Nov 2022

README

happy eyeballs -- connecting to a remote host

RFC 8305 describes how to connect to a remote host, given that the host may have multiple addresses (IPv4 and IPv6, via DNS A and AAAA resource records), and the local host may have connectivity via IPv4 only, IPv6 only, or both. The preference is to use IPv6.

This package implements the given RFC in its core (Happy_eyeballs module). In addition, the Happy_eyeballs_lwt is a Lwt implementation using Unix.

The implemented state machine is kept in-sync with the code (source: happy_eyeballs.dot at the root of this repository).

It is licensed under the ISC license.

Installation

opam install happy-eyeballs happy-eyeballs-lwt happy-eyeballs-mirage

Development

Since dns-client depends on happy-eyeballs and happy-eyeballs-lwt, happy-eyeballs-mirage depend on dns-client, the dune build system is easily confused. A workaround is after a git clone of happy-eyeballs, do an opam source dns-client. Then dune will use the local dns-client package, and there will be no circularity issue.

Dependencies (14)

  1. mirage-time >= "2.0.0"
  2. mirage-random >= "2.0.0" & < "4.0.0"
  3. tcpip >= "7.0.0"
  4. mirage-clock >= "3.0.0"
  5. lwt
  6. logs
  7. fmt
  8. ipaddr
  9. domain-name
  10. dns-client >= "6.2.0" & < "7.0.0"
  11. duration
  12. happy-eyeballs = version
  13. dune >= "2.0.0"
  14. ocaml >= "4.08.0"

Dev Dependencies

None

Used by (2)

  1. git-mirage = "3.7.1" | >= "3.8.1"
  2. mimic-happy-eyeballs

Conflicts

None