sock_stress

README

Operating System Specific

Windows

Under Windows, we assume Docker for Windows is installed since this ships with a suitably patched Linux kernel (though the tests can also be run to a Windows VM). Currently, there is also the restriction that one can only connect from the host to the (Linux) VM.

First register the Hyper-V socket GUID in the registry. Follow the instructions on making an integration service:

• create a new registry key (e.g. with regedit.exe) called 3049197C-FACB-11E6-BD58-64006A7986D3 under HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Virtualization\GuestCommunicationServices
• inside the new key create a String value called ElementName. The Data can be anything you like but typically this is a description such as "sock_stress".

Next build a Linux container with the test program as shown below.

Linux

After building the binary can be run from a suitably privileged container:

$ cat >Dockerfile <<EOF
FROM alpine
RUN apk update && apk add strace
ADD sock_stress.linux /sock_stress
ENTRYPOINT ["/sock_stress"]
EOF
$ docker build -t stress . && docker run -it --rm --net=host --privileged stress [...options...]

MacOS

Under MacOS the default is to assume Hyperkit as configured by Docker for Mac (since the path to the sockets and the names of the sockets themselves differ).

To run against standalone Hyperkit the path to the sockets must be specified when starting Hyperkit and must be passed to the option:

macos$ ./sock_stress.darwin -s vsock -m hyperkit:/var/run/

(this assumes hyperkit was built without PRI_ADDR_PREFIX or CONNECT_SOCKET_NAME set at build time and run with e.g. -s 7,virtio-sock,guest_cid=3,path=/var/run)

In Docker mode everything is implied to be as it is configured by Docker for Mac. This is the default but can be given explicitly with:

macos$ ./sock_stress.darwin -s vsock -m docker

Specific OS Pairs

Linux & Docker for Windows

Start the linux container with program in server mode:

PS> docker run -it --rm --net=host --privileged stress -s hvsock

The start the client in a separate powershell window:

PS> $vmId = (Get-VM MobyLinuxVM).Id
PS> .\sock_stress.exe -c hvsock://$vmId

Linux & Docker for Mac

When running as a client on the Linux side the correct address is cid "2" (the host):

linux$ docker run -it --rm --net=host --privileged stress -c vsock://2
macos$ ./sock_stress.darwin -s vsock

When running as a client on the MacOS side the correct address is cid is "3" (the guest, as configued by Docker for Mac):

linux$ docker run -it --rm --net=host --privileged stress -s vsock
macos$ ./sock_stress.darwin -c vsock://3