package hvsock

  1. Overview
  2. Docs
Bindings for Hyper-V AF_VSOCK

Install

Dune Dependency

Authors

Maintainers

Sources

hvsock-1.0.1.tbz
sha256=2bf6d8b2cb9bb965a2ce07b428b5c0a9b84df8c4295339966d4c3e7680a42e63
md5=3da19c12c7fdad73ad337a83f6e0bb2c

Description

Build Status (Linux) Build status (Windows)

These bindings allow Host <-> VM communication on Hyper-V systems on both Linux and Windows.

Warning: the AF_HYPERV patches for Linux are not yet merged and hence the definition of AF_HYPERV is not yet stable. If other address families are merged before this one then the value of AF_HYPERV will change!

Please read the API documentation.

Published: 18 Sep 2017

README

ocaml-hvsock -- bindings for Hyper-V AF_VSOCK

These bindings allow Host <-> VM communication on Hyper-V systems on both Linux and Windows.

Warning: the AF_HYPERV patches for Linux are not yet merged and hence the definition of AF_HYPERV is not yet stable. If other address families are merged before this one then the value of AF_HYPERV will change!

Please read the API documentation.

Example

An address on a Hyper-V host consists of two parts:

  • a VM GUID

  • a well-known service GUID

First generate yourself a service GUID and add this to the registry: this is like opening a hole in a firewall for a TCP port.

New-Item -Path "HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Virtualization\GuestCommunicationServices" -Name <Service GUID>

Second discover the GUID of the VM you wish to talk to:

(Get-VM -Name <MY VM NAME>).Id

Third, run a listening server in the VM:

./hvcat -l --echo <Service GUID>

Finally, connect the client on the host to the VM:

./hvcat --vmid <VM GUID> <Service GUID>

Limitations

Although the connections use the regular SOCKET APIs, current kernels don't support calls like select so we must always use blocking I/O from background threads, rather than regular asynchronous I/O. This means that the Lwt connection type has been made opaque.

The client connect call seems to block forever if the server calls listen after the client calls connect. The Lwt_hvsock.connect works around this with a self-imposed 1s timeout after which time it will raise ECONNREFUSED.

Background

For background, see the MSDN article on making an integration service

Dev Dependencies (1)

  1. alcotest with-test & >= "0.4.0"

Used by (3)

  1. datakit >= "0.10.0"
  2. datakit-bridge-github >= "0.10.0"
  3. vpnkit >= "0.1.1"

Conflicts

None

OCaml

Innovation. Community. Security.