18c2ecf20Sopenharmony_ciAF_VSOCK test suite
28c2ecf20Sopenharmony_ci-------------------
38c2ecf20Sopenharmony_ciThese tests exercise net/vmw_vsock/ host<->guest sockets for VMware, KVM, and
48c2ecf20Sopenharmony_ciHyper-V.
58c2ecf20Sopenharmony_ci
68c2ecf20Sopenharmony_ciThe following tests are available:
78c2ecf20Sopenharmony_ci
88c2ecf20Sopenharmony_ci  * vsock_test - core AF_VSOCK socket functionality
98c2ecf20Sopenharmony_ci  * vsock_diag_test - vsock_diag.ko module for listing open sockets
108c2ecf20Sopenharmony_ci
118c2ecf20Sopenharmony_ciThe following prerequisite steps are not automated and must be performed prior
128c2ecf20Sopenharmony_cito running tests:
138c2ecf20Sopenharmony_ci
148c2ecf20Sopenharmony_ci1. Build the kernel, make headers_install, and build these tests.
158c2ecf20Sopenharmony_ci2. Install the kernel and tests on the host.
168c2ecf20Sopenharmony_ci3. Install the kernel and tests inside the guest.
178c2ecf20Sopenharmony_ci4. Boot the guest and ensure that the AF_VSOCK transport is enabled.
188c2ecf20Sopenharmony_ci
198c2ecf20Sopenharmony_ciInvoke test binaries in both directions as follows:
208c2ecf20Sopenharmony_ci
218c2ecf20Sopenharmony_ci  # host=server, guest=client
228c2ecf20Sopenharmony_ci  (host)# $TEST_BINARY --mode=server \
238c2ecf20Sopenharmony_ci                       --control-port=1234 \
248c2ecf20Sopenharmony_ci                       --peer-cid=3
258c2ecf20Sopenharmony_ci  (guest)# $TEST_BINARY --mode=client \
268c2ecf20Sopenharmony_ci                        --control-host=$HOST_IP \
278c2ecf20Sopenharmony_ci                        --control-port=1234 \
288c2ecf20Sopenharmony_ci                        --peer-cid=2
298c2ecf20Sopenharmony_ci
308c2ecf20Sopenharmony_ci  # host=client, guest=server
318c2ecf20Sopenharmony_ci  (guest)# $TEST_BINARY --mode=server \
328c2ecf20Sopenharmony_ci                        --control-port=1234 \
338c2ecf20Sopenharmony_ci                        --peer-cid=2
348c2ecf20Sopenharmony_ci  (host)# $TEST_BINARY --mode=client \
358c2ecf20Sopenharmony_ci                       --control-port=$GUEST_IP \
368c2ecf20Sopenharmony_ci                       --control-port=1234 \
378c2ecf20Sopenharmony_ci                       --peer-cid=3
38