xref: /linux/tools/testing/vsock/README (revision a4eb44a6435d6d8f9e642407a4a06f65eb90ca04)
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_test - core AF_VSOCK socket functionality
9  * vsock_diag_test - vsock_diag.ko module for listing open sockets
10
11The following prerequisite steps are not automated and must be performed prior
12to running tests:
13
141. Build the kernel, make headers_install, and build these tests.
152. Install the kernel and tests on the host.
163. Install the kernel and tests inside the guest.
174. Boot the guest and ensure that the AF_VSOCK transport is enabled.
18
19Invoke test binaries in both directions as follows:
20
21  # host=server, guest=client
22  (host)# $TEST_BINARY --mode=server \
23                       --control-port=1234 \
24                       --peer-cid=3
25  (guest)# $TEST_BINARY --mode=client \
26                        --control-host=$HOST_IP \
27                        --control-port=1234 \
28                        --peer-cid=2
29
30  # host=client, guest=server
31  (guest)# $TEST_BINARY --mode=server \
32                        --control-port=1234 \
33                        --peer-cid=2
34  (host)# $TEST_BINARY --mode=client \
35                       --control-port=$GUEST_IP \
36                       --control-port=1234 \
37                       --peer-cid=3
38