michaelh/zephyr
1
0
Fork 0
Code Releases Activity
zephyr/include/zephyr/debug/object_tracing.h

32 lines
760 B
C
Raw Permalink Normal View History

debug: kernel's object tracing api Restructure the kernel's object tracing implementation to provide a public API that allows debug tools to use the debug hooks easier and allows kernel developers to extend the kernel's object tracing scope and include new kernel objects easier. The API provides the trace list abstraction to keep track of different types of kernel objects. The API contains a simple single-linked list implementation that allows to save space and simplifies the access to the data for debug tools such as gdb. Change-Id: Ic4d393d584576f67f2c5b706e61bae08869debba Signed-off-by: Juan Manuel Cruz <juan.m.cruz.alcaraz@intel.com>
2016-02-17 21:56:57 +01:00
/*
* Copyright (c) 2016 Intel Corporation
*
license: Replace Apache boilerplate with SPDX tag Replace the existing Apache 2.0 boilerplate header with an SPDX tag throughout the zephyr code tree. This patch was generated via a script run over the master branch. Also updated doc/porting/application.rst that had a dependency on line numbers in a literal include. Manually updated subsys/logging/sys_log.c that had a malformed header in the original file. Also cleanup several cases that already had a SPDX tag and we either got a duplicate or missed updating. Jira: ZEP-1457 Change-Id: I6131a1d4ee0e58f5b938300c2d2fc77d2e69572c Signed-off-by: David B. Kinder <david.b.kinder@intel.com> Signed-off-by: Kumar Gala <kumar.gala@linaro.org>
2017-01-19 02:01:01 +01:00
* SPDX-License-Identifier: Apache-2.0
debug: kernel's object tracing api Restructure the kernel's object tracing implementation to provide a public API that allows debug tools to use the debug hooks easier and allows kernel developers to extend the kernel's object tracing scope and include new kernel objects easier. The API provides the trace list abstraction to keep track of different types of kernel objects. The API contains a simple single-linked list implementation that allows to save space and simplifies the access to the data for debug tools such as gdb. Change-Id: Ic4d393d584576f67f2c5b706e61bae08869debba Signed-off-by: Juan Manuel Cruz <juan.m.cruz.alcaraz@intel.com>
2016-02-17 21:56:57 +01:00
*/
kernel: remove object tracing Remove this intrusive tracing feature in favor of the new object tracing using the main tracing feature in zephyr. See #33603 for the new tracing coverage for all objects. This will allow for support in more tools and less reliance on GDB for tracing objects. Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2021-04-19 05:24:40 +02:00
#ifndef ZEPHYR_INCLUDE_THREAD_MONITOR_H_
#define ZEPHYR_INCLUDE_THREAD_MONITOR_H_
unified: Add object tracing support for kernel objects Defines an object tracing list for each kernel object type that supports object tracing, and ensures that both statically and dynamically defined objects are added to the appropriate list. Ensure that each static kernel object is grouped together with the other static objects of the same type. Revise the initialization function for each kernel type (or create it, if needed) so that each static object is added to the object tracing list for its associated type. Note 1: Threads are handled a bit differently than other kernel object types. A statically-defined thread is added to the thread list when the thread is started, not when the kernel initializes. Also, a thread is removed from the thread list when the thread terminates or aborts, unlike other types of kernel objects which are never removed from an object tracing list. (Such support would require the creation of APIs to "uninitialize" the kernel object.) Note 2: The list head variables for all kernel object types are now explicitly defined. However, the list head variable for the ring buffer type continues to be implicitly defined for the time being, since it isn't considered to be an core kernel object type. Change-Id: Ie24d41023e05b3598dc6b344e6871a9692bba02d Signed-off-by: Allan Stephens <allan.stephens@windriver.com>
2016-10-19 23:10:46 +02:00
include: migrate includes to <zephyr/...> In order to bring consistency in-tree, migrate all includes within include directory to the new prefix <zephyr/...>. Note that the conversion has been scripted, refer to zephyrproject-rtos#45388 for more details. Signed-off-by: Gerard Marull-Paretas <gerard.marull@nordicsemi.no>
2022-05-06 10:30:42 +02:00
#include <zephyr/kernel.h>
#include <zephyr/kernel_structs.h>
debug: expose thread monitor in object tracing header Exposes the CONFIG_THREAD_MONITOR functionality as part of the object tracing header. Change-Id: I2022a580df2cf33e543b980dc9c33b9adca3d3bf Signed-off-by: Juan Manuel Cruz <juan.m.cruz.alcaraz@intel.com>
2016-03-09 22:57:41 +01:00
/**
* @brief Head element of the thread monitor list.
*
* @details Access the head element of the thread monitor list.
*
*/
kernel/arch: consolidate tTCS and TNANO definitions There was a lot of duplication between architectures for the definition of threads and the "nanokernel" guts. These have been consolidated. Now, a common file kernel/unified/include/kernel_structs.h holds the common definitions. Architectures provide two files to complement it: kernel_arch_data.h and kernel_arch_func.h. The first one contains at least the struct _thread_arch and struct _kernel_arch data structures, as well as the struct _callee_saved and struct _caller_saved register layouts. The second file contains anything that needs what is provided by the common stuff in kernel_structs.h. Those two files are only meant to be included in kernel_structs.h in very specific locations. The thread data structure has been separated into three major parts: common struct _thread_base and struct k_thread, and arch-specific struct _thread_arch. The first and third ones are included in the second. The struct s_NANO data structure has been split into two: common struct _kernel and arch-specific struct _kernel_arch. The latter is included in the former. Offsets files have also changed: nano_offsets.h has been renamed kernel_offsets.h and is still included by the arch-specific offsets.c. Also, since the thread and kernel data structures are now made of sub-structures, offsets have to be added to make up the full offset. Some of these additions have been consolidated in shorter symbols, available from kernel/unified/include/offsets_short.h, which includes an arch-specific offsets_arch_short.h. Most of the code include offsets_short.h now instead of offsets.h. Change-Id: I084645cb7e6db8db69aeaaf162963fe157045d5a Signed-off-by: Benjamin Walsh <benjamin.walsh@windriver.com>
2016-11-08 16:36:50 +01:00
#define SYS_THREAD_MONITOR_HEAD ((struct k_thread *)(_kernel.threads))
debug: expose thread monitor in object tracing header Exposes the CONFIG_THREAD_MONITOR functionality as part of the object tracing header. Change-Id: I2022a580df2cf33e543b980dc9c33b9adca3d3bf Signed-off-by: Juan Manuel Cruz <juan.m.cruz.alcaraz@intel.com>
2016-03-09 22:57:41 +01:00
/**
* @brief Gets a thread node's next element.
*
* @details Given a node in a thread monitor list, gets the next
* element in the list.
*
* @param obj Object to get the next element from.
*/
kernel/arch: consolidate tTCS and TNANO definitions There was a lot of duplication between architectures for the definition of threads and the "nanokernel" guts. These have been consolidated. Now, a common file kernel/unified/include/kernel_structs.h holds the common definitions. Architectures provide two files to complement it: kernel_arch_data.h and kernel_arch_func.h. The first one contains at least the struct _thread_arch and struct _kernel_arch data structures, as well as the struct _callee_saved and struct _caller_saved register layouts. The second file contains anything that needs what is provided by the common stuff in kernel_structs.h. Those two files are only meant to be included in kernel_structs.h in very specific locations. The thread data structure has been separated into three major parts: common struct _thread_base and struct k_thread, and arch-specific struct _thread_arch. The first and third ones are included in the second. The struct s_NANO data structure has been split into two: common struct _kernel and arch-specific struct _kernel_arch. The latter is included in the former. Offsets files have also changed: nano_offsets.h has been renamed kernel_offsets.h and is still included by the arch-specific offsets.c. Also, since the thread and kernel data structures are now made of sub-structures, offsets have to be added to make up the full offset. Some of these additions have been consolidated in shorter symbols, available from kernel/unified/include/offsets_short.h, which includes an arch-specific offsets_arch_short.h. Most of the code include offsets_short.h now instead of offsets.h. Change-Id: I084645cb7e6db8db69aeaaf162963fe157045d5a Signed-off-by: Benjamin Walsh <benjamin.walsh@windriver.com>
2016-11-08 16:36:50 +01:00
#define SYS_THREAD_MONITOR_NEXT(obj) (((struct k_thread *)obj)->next_thread)
debug: expose thread monitor in object tracing header Exposes the CONFIG_THREAD_MONITOR functionality as part of the object tracing header. Change-Id: I2022a580df2cf33e543b980dc9c33b9adca3d3bf Signed-off-by: Juan Manuel Cruz <juan.m.cruz.alcaraz@intel.com>
2016-03-09 22:57:41 +01:00
kernel: remove object tracing Remove this intrusive tracing feature in favor of the new object tracing using the main tracing feature in zephyr. See #33603 for the new tracing coverage for all objects. This will allow for support in more tools and less reliance on GDB for tracing objects. Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2021-04-19 05:24:40 +02:00
#endif /* ZEPHYR_INCLUDE_THREAD_MONITOR_H_ */
Copy permalink