xref: /openbmc/linux/tools/testing/vsock/README (revision a72594ca)
1AF_VSOCK test suite
2-------------------
3These tests exercise net/vmw_vsock/ host<->guest sockets for VMware, KVM, and
4Hyper-V.
5
6The following tests are available:
7
8  * vsock_diag_test - vsock_diag.ko module for listing open sockets
9
10The following prerequisite steps are not automated and must be performed prior
11to running tests:
12
131. Build the kernel and these tests.
142. Install the kernel and tests on the host.
153. Install the kernel and tests inside the guest.
164. Boot the guest and ensure that the AF_VSOCK transport is enabled.
17
18Invoke test binaries in both directions as follows:
19
20  # host=server, guest=client
21  (host)# $TEST_BINARY --mode=server \
22                       --control-port=1234 \
23                       --peer-cid=3
24  (guest)# $TEST_BINARY --mode=client \
25                        --control-host=$HOST_IP \
26                        --control-port=1234 \
27                        --peer-cid=2
28
29  # host=client, guest=server
30  (guest)# $TEST_BINARY --mode=server \
31                        --control-port=1234 \
32                        --peer-cid=2
33  (host)# $TEST_BINARY --mode=client \
34                       --control-port=$GUEST_IP \
35                       --control-port=1234 \
36                       --peer-cid=3
37