xref: /dpdk/app/test/test_debug.c (revision 10b71caecbe1cddcbb65c050ca775fba575e88db)
1 /* SPDX-License-Identifier: BSD-3-Clause
2  * Copyright(c) 2010-2014 Intel Corporation
3  */
4 
5 #include <stdio.h>
6 #include <stdint.h>
7 #include <sys/wait.h>
8 #include <unistd.h>
9 
10 #include <rte_debug.h>
11 #include <rte_common.h>
12 #include <rte_eal.h>
13 #include <rte_service_component.h>
14 
15 #include "test.h"
16 
17 /*
18  * Debug test
19  * ==========
20  */
21 
22 /* use fork() to test rte_panic() */
23 static int
24 test_panic(void)
25 {
26 	int pid;
27 	int status;
28 
29 	pid = fork();
30 
31 	if (pid == 0)
32 		rte_panic("Test Debug\n");
33 	else if (pid < 0){
34 		printf("Fork Failed\n");
35 		return -1;
36 	}
37 	wait(&status);
38 	if(status == 0){
39 		printf("Child process terminated normally!\n");
40 		return -1;
41 	} else
42 		printf("Child process terminated as expected - Test passed!\n");
43 
44 	return 0;
45 }
46 
47 /* use fork() to test rte_exit() */
48 static int
49 test_exit_val(int exit_val)
50 {
51 	int pid;
52 	int status;
53 
54 	/* manually cleanup EAL memory, as the fork() below would otherwise
55 	 * cause the same hugepages to be free()-ed multiple times.
56 	 */
57 	rte_service_finalize();
58 
59 	pid = fork();
60 
61 	if (pid == 0)
62 		rte_exit(exit_val, __func__);
63 	else if (pid < 0){
64 		printf("Fork Failed\n");
65 		return -1;
66 	}
67 	wait(&status);
68 	printf("Child process status: %d\n", status);
69 #ifndef RTE_EAL_ALWAYS_PANIC_ON_ERROR
70 	if(!WIFEXITED(status) || WEXITSTATUS(status) != (uint8_t)exit_val){
71 		printf("Child process terminated with incorrect status (expected = %d)!\n",
72 				exit_val);
73 		return -1;
74 	}
75 #endif
76 	return 0;
77 }
78 
79 static int
80 test_exit(void)
81 {
82 	int test_vals[] = { 0, 1, 2, 255, -1 };
83 	unsigned i;
84 	for (i = 0; i < RTE_DIM(test_vals); i++) {
85 		if (test_exit_val(test_vals[i]) < 0)
86 			return -1;
87 	}
88 	printf("%s Passed\n", __func__);
89 	return 0;
90 }
91 
92 static void
93 dummy_app_usage(const char *progname)
94 {
95 	RTE_SET_USED(progname);
96 }
97 
98 static int
99 test_usage(void)
100 {
101 	if (rte_set_application_usage_hook(dummy_app_usage) != NULL) {
102 		printf("Non-NULL value returned for initial usage hook\n");
103 		return -1;
104 	}
105 	if (rte_set_application_usage_hook(NULL) != dummy_app_usage) {
106 		printf("Incorrect value returned for application usage hook\n");
107 		return -1;
108 	}
109 	return 0;
110 }
111 
112 static int
113 test_debug(void)
114 {
115 	rte_dump_stack();
116 	rte_dump_registers();
117 	if (test_panic() < 0)
118 		return -1;
119 	if (test_exit() < 0)
120 		return -1;
121 	if (test_usage() < 0)
122 		return -1;
123 	return 0;
124 }
125 
126 REGISTER_TEST_COMMAND(debug_autotest, test_debug);
127