1 /* SPDX-License-Identifier: BSD-3-Clause
2 * Copyright(c) 2010-2014 Intel Corporation
11 * Debug Functions in RTE
13 * This file defines a generic API for debug operations. Part of
14 * the implementation is architecture-specific.
18 #include "rte_branch_prediction.h"
25 * Dump the stack of the calling core to the console.
27 void rte_dump_stack(void);
30 * Dump the registers of the calling core to the console.
32 * Note: Not implemented in a userapp environment; use gdb instead.
34 void rte_dump_registers(void);
37 * Provide notification of a critical non-recoverable error and terminate
38 * execution abnormally.
40 * Display the format string and its expanded arguments (printf-like).
42 * In a linux environment, this function dumps the stack and calls
43 * abort() resulting in a core dump if enabled.
45 * The function never returns.
48 * The format string, followed by the variable list of arguments.
50 #define rte_panic(...) rte_panic_(__func__, __VA_ARGS__, "dummy")
51 #define rte_panic_(func, format, ...) __rte_panic(func, format "%.0s", __VA_ARGS__)
53 #ifdef RTE_ENABLE_ASSERT
54 #define RTE_ASSERT(exp) RTE_VERIFY(exp)
56 #define RTE_ASSERT(exp) do {} while (0)
58 #define RTE_VERIFY(exp) do { \
59 if (unlikely(!(exp))) \
60 rte_panic("line %d\tassert \"%s\" failed\n", __LINE__, #exp); \
64 * Provide notification of a critical non-recoverable error and stop.
66 * This function should not be called directly. Refer to rte_panic() macro
69 void __rte_panic(const char *funcname , const char *format, ...)
71 #if (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ > 2))
75 __attribute__((noreturn))
76 __attribute__((format(printf, 2, 3)));
82 #endif /* _RTE_DEBUG_H_ */