blob: 4d5045e7d2c3d5865583b997cdca5fc0a6d9b63e [file] [log] [blame]
Stefan Hajnoczi0b025032017-10-05 16:46:54 -04001AF_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
Stefan Hajnoczicdbcc182019-12-18 19:07:04 +01008 * vsock_test - core AF_VSOCK socket functionality
Stefan Hajnoczi0b025032017-10-05 16:46:54 -04009 * 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
Stefan Hajnoczi43985462019-12-18 19:06:58 +0100141. Build the kernel, make headers_install, and build these tests.
Stefan Hajnoczi0b025032017-10-05 16:46:54 -0400152. 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