xref: /linux/tools/testing/vsock/util.h (revision 02680c23d7b3febe45ea3d4f9818c2b2dc89020a)
1 /* SPDX-License-Identifier: GPL-2.0-only */
2 #ifndef UTIL_H
3 #define UTIL_H
4 
5 #include <sys/socket.h>
6 #include <linux/vm_sockets.h>
7 
8 /* Tests can either run as the client or the server */
9 enum test_mode {
10 	TEST_MODE_UNSET,
11 	TEST_MODE_CLIENT,
12 	TEST_MODE_SERVER
13 };
14 
15 /* Test runner options */
16 struct test_opts {
17 	enum test_mode mode;
18 	unsigned int peer_cid;
19 };
20 
21 /* A test case definition.  Test functions must print failures to stderr and
22  * terminate with exit(EXIT_FAILURE).
23  */
24 struct test_case {
25 	const char *name; /* human-readable name */
26 
27 	/* Called when test mode is TEST_MODE_CLIENT */
28 	void (*run_client)(const struct test_opts *opts);
29 
30 	/* Called when test mode is TEST_MODE_SERVER */
31 	void (*run_server)(const struct test_opts *opts);
32 
33 	bool skip;
34 };
35 
36 void init_signals(void);
37 unsigned int parse_cid(const char *str);
38 int vsock_stream_connect(unsigned int cid, unsigned int port);
39 int vsock_stream_accept(unsigned int cid, unsigned int port,
40 			struct sockaddr_vm *clientaddrp);
41 void vsock_wait_remote_close(int fd);
42 void send_byte(int fd, int expected_ret, int flags);
43 void recv_byte(int fd, int expected_ret, int flags);
44 void run_tests(const struct test_case *test_cases,
45 	       const struct test_opts *opts);
46 void list_tests(const struct test_case *test_cases);
47 void skip_test(struct test_case *test_cases, size_t test_cases_len,
48 	       const char *test_id_str);
49 #endif /* UTIL_H */
50