RTEMS
Macros
Event Recording Configuration

Macros

#define CONFIGURE_RECORD_EXTENSIONS_ENABLED
 This configuration option is a boolean feature define. More...
 
#define CONFIGURE_RECORD_FATAL_DUMP_BASE64
 This configuration option is a boolean feature define. More...
 
#define CONFIGURE_RECORD_FATAL_DUMP_BASE64_ZLIB
 This configuration option is a boolean feature define. More...
 
#define CONFIGURE_RECORD_PER_PROCESSOR_ITEMS
 This configuration option is an integer define. More...
 

Detailed Description

This section describes configuration options related to the event recording.

Macro Definition Documentation

◆ CONFIGURE_RECORD_EXTENSIONS_ENABLED

#define CONFIGURE_RECORD_EXTENSIONS_ENABLED

This configuration option is a boolean feature define.

In case

then the event record extensions are enabled.

Default Configuration
If this configuration option is undefined, then the described feature is not enabled.
Notes
The record extensions capture thread create, start, restart, delete, switch, begin, exitted and terminate events.

Definition at line 1754 of file appl-config.h.

◆ CONFIGURE_RECORD_FATAL_DUMP_BASE64

#define CONFIGURE_RECORD_FATAL_DUMP_BASE64

This configuration option is a boolean feature define.

In case

then the event records are dumped in Base64 encoding in a fatal error extension (see Announcing a Fatal Error).

Default Configuration
If this configuration option is undefined, then the described feature is not enabled.
Notes
This extension can be used to produce crash dumps.

Definition at line 1781 of file appl-config.h.

◆ CONFIGURE_RECORD_FATAL_DUMP_BASE64_ZLIB

#define CONFIGURE_RECORD_FATAL_DUMP_BASE64_ZLIB

This configuration option is a boolean feature define.

In case

then the event records are compressed by zlib and dumped in Base64 encoding in a fatal error extension (see Announcing a Fatal Error).

Default Configuration
If this configuration option is undefined, then the described feature is not enabled.
Notes
The zlib compression needs about 512KiB of RAM. This extension can be used to produce crash dumps.

Definition at line 1807 of file appl-config.h.

◆ CONFIGURE_RECORD_PER_PROCESSOR_ITEMS

#define CONFIGURE_RECORD_PER_PROCESSOR_ITEMS

This configuration option is an integer define.

The value of this configuration option defines the event record item count per processor.

Default Value
The default value is 0.
Value Constraints

The value of this configuration option shall satisfy all of the following constraints:

  • It shall be greater than or equal to 16.
  • It shall be less than or equal to SIZE_MAX.
  • It shall be a power of two.
  • It shall be less than or equal to a BSP-specific and application-specific value which depends on the size of the memory available to the application.
Notes
The event record buffers are statically allocated for each configured processor (CONFIGURE_MAXIMUM_PROCESSORS). If the value of this configuration option is zero, then nothing is allocated.

Definition at line 1842 of file appl-config.h.