Description

macOS 10.10 (Yosemite) introduced the somewhat undocumented vmnet framework. This exposes virtual network interfaces to userland applications. There are a number of advantages of this over previous implementations:

  • Unlike tuntaposx, this is builtin to MacOS X now and so is easier to package up and distribute for end users.
  • vmnet uses the XPC sandboxing interfaces and should make it easier to drop a hard dependency on running networking applications as root.
  • Most significantly, vmnet optionally supports NATing network traffic to the outside world, which was previously unsupported.

These OCaml bindings are constructed against the documentation contained in the <vmnet.h> header file in Yosemite, and may not be correct due to the lack of any other example code. However, they do suffice to run MirageOS applications that can connect to the outside world.

Note the application must be configured to use DHCP: static IPs are not supported.

Published: 27 Dec 2018

Dependencies (8)

  1. cstruct-unix
  2. cstruct >= "1.9.0"
  3. lwt >= "2.4.3"
  4. ipaddr >= "1.4.0" & < "3.0.0"
  5. sexplib >= "113.24.00"
  6. ppx_sexp_conv
  7. dune
  8. ocaml >= "4.04"

Reverse Dependencies (1)

  1. mirage-net-macosx < "1.6.0"

Conflicts

    None