vmnet

AuthorAnil Madhavapeddy <anil@recoil.org>
LicenseISC
Homepagehttps://github.com/mirage/ocaml-vmnet
Issue Trackerhttps://github.com/mirage/ocaml-vmnet/issues
MaintainerAnil Madhavapeddy <anil@recoil.org>
Dependencies
&cstruct>= 1.9.0
cstruct-unix
ipaddr>= 1.4.0
jbuilder>= 1.0+beta9
lwt>= 2.4.3
ocaml-migrate-parsetree
ppx_sexp_conv
ppx_tools
sexplib>= 113.24.00
Availableos = "darwin"
PublishedJan 23, 2018
Source [http] https://github.com/mirage/ocaml-vmnet/releases/download/1.3.1/vmnet-1.3.1.tbz
2d29f60735a4579fcce6dee37bd015fe
StatisticsInstalled 2 times last month.
Edithttps://github.com/ocaml/opam-repository/tree/master/packages/vmnet/vmnet.1.3.1/opam

MacOS X `vmnet` NAT networking

MacOS X 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.

Necessary for
mirage-net-macosx