mirror of
https://github.com/genodelabs/genode.git
synced 2024-12-25 08:21:08 +00:00
bf62d6b896
Since the timer and timeout handling is part of the base library (the dynamic linker), it belongs to the base repository. Besides moving the timer and its related infrastructure (alarm, timeout libs, tests) to the base repository, this patch also moves the timer from the 'drivers' subdirectory directly to 'src' and disamibuates the timer's build locations for the various kernels. Otherwise the different timer implementations could interfere with each other when using one build directory with multiple kernels. Note that this patch changes the include paths for the former os/timer, os/alarm.h, os/duration.h, and os/timed_semaphore.h to base/. Issue #3101 |
||
|---|---|---|
| .. | ||
| avl_tree.h | ||
| config.xsd | ||
| main.cc | ||
| monitor.cc | ||
| monitor.h | ||
| policy.cc | ||
| policy.h | ||
| README | ||
| target.mk | ||
| trace_buffer.h | ||
| xml_node.cc | ||
| xml_node.h | ||
The 'trace_logger' component can be used to easily gather, process and export different types of tracing data. Which subjects to select is configurable via session label policies and thread names. Which data to collect from the selected subjects can be configured for each subject individually, for groups of subjects, or for all subjects. The gathered data can be exported as log output. Configuration ~~~~~~~~~~~~~ This is an example configuration of the 'trace_logger' component which shows the default value for each attribute except the policy.thread and policy.label: ! <config verbose="no" ! session_ram="10M" ! session_arg_buffer="4K" ! session_parent_levels="0" ! period_sec="5" ! activity="no" ! affinity="no" ! default_policy="null" ! default_buffer="4K"> ! ! <policy label="init -> timer" /> ! <policy label_suffix=" -> ram_fs" /> ! <policy label_prefix="init -> encryption -> " ! thread="worker" ! buffer="4K" ! policy="null" /> ! </config> This is a short description of the tags and attributes: :config.verbose: Optional. Toggles wether the trace_logger shall log debugging information. :config.session_ram: Optional. Amount of RAM donated to the trace session. :config.session_arg_buffer: Optional. Size of the trace sessions argument buffer. :config.session_parent_levels: Optional. Number of parent levels to trace. :config.period_sec: Optional. Length of processing/export interval in seconds. :config.activity: Optional. Wether to export thread-activity information. :config.affinity: Optional. Wether to export thread-affinity information. :config.default_policy: Optional. Name of tracing policy for subjects without individual config. :config.default_policy: Optional. Size of tracing buffer for subjects without individual config. :config.policy: Subject selector. For matching subjects, tracing is enabled and the defined individual configuration is applied. :config.policy.label: :config.policy.label_prefix: :config.policy.label_suffix: Mutually exclusive. Filters subjects according to their session label. :config.policy.thread: Optional. Filters subjects according to their exact thread name. :config.policy.buffer: Optional. Size of tracing buffer used for matching subjects. :config.policy.policy: Optional. Name of tracing policy used for matching subjects. Sessions ~~~~~~~~ This is an overview of the sessions required and provided by the 'trace_logger' component apart from the environment sessions: * Requires ROM sessions to all configured tracing policies. * Requires one TRACE session that provides the desired subjects. * Requires one Timer session. Examples ~~~~~~~~ An Example of how to use the trace_logger component can be found in the test script 'os/run/trace_logger.run'.