Add low level event recording support

Add low level event recording infrastructure for system and user
defined events.  The infrastructure is able to record high frequency
events such as

 * SMP lock acquire/release,
 * interrupt entry/exit,
 * thread switches,
 * UMA zone allocate/free, and
 * Ethernet packet input/output, etc.

It allows post-mortem analysis in fatal error handlers, e.g. the last
events are in the record buffer, the newest event overwrites the oldest
event.  It is possible to detect record buffer overflows for consumers
that expect a continuous stream of events, e.g. to display the system
state in real-time.

The implementation supports high-end SMP machines (more than 1GHz
processor frequency, more than four processors).

Add a new API instead. The implementation uses per-processor data
structures and no atomic read-modify-write operations.  It is uses
per-processor ring buffers to record the events.

The CPU counter is used to get the time of events. It is combined with
periodic uptime events to synchronize it with CLOCK_REALTIME.

The existing capture engine tries to solve this problem also, but its
performance is not good enough for high-end production systems.  The
main issues are the variable-size buffers and the use of SMP locks for
synchronization.  To fix this, the API would change significantly.

Update #3665.

1 files changed, 31 insertions, 0 deletions

diff --git a/cpukit/include/rtems/confdefs.h b/cpukit/include/rtems/confdefs.h
index 45e70313fb..89b47050d6 100644
--- a/cpukit/include/rtems/confdefs.h
+++ b/cpukit/include/rtems/confdefs.h
@@ -2123,6 +2123,10 @@ extern rtems_initialization_tasks_table Initialization_tasks[];
     defined(CONFIGURE_STACK_CHECKER_ENABLED) || \
     (defined(RTEMS_NEWLIB) && !defined(CONFIGURE_DISABLE_NEWLIB_REENTRANCY))
   static const rtems_extensions_table Configuration_Initial_Extensions[] = {
+    #if CONFIGURE_RECORD_PER_PROCESSOR_ITEMS > 0 && \
+      defined(CONFIGURE_RECORD_EXTENSIONS_ENABLED)
+      RECORD_EXTENSION,
+    #endif
     #if !defined(CONFIGURE_DISABLE_NEWLIB_REENTRANCY)
       RTEMS_NEWLIB_EXTENSION,
     #endif
@@ -2965,6 +2969,33 @@ struct _reent *__getreent(void)
       _CONFIGURE_MAXIMUM_PROCESSORS,
     #endif
   };
+
+  #if CONFIGURE_RECORD_PER_PROCESSOR_ITEMS > 0
+    #include <rtems/record.h>
+
+    #if (CONFIGURE_RECORD_PER_PROCESSOR_ITEMS & (CONFIGURE_RECORD_PER_PROCESSOR_ITEMS - 1)) != 0
+      #error "CONFIGURE_RECORD_PER_PROCESSOR_ITEMS must be a power of two"
+    #endif
+
+    #if CONFIGURE_RECORD_PER_PROCESSOR_ITEMS < 16
+      #error "CONFIGURE_RECORD_PER_PROCESSOR_ITEMS must be at least 16"
+    #endif
+
+    const unsigned int _Record_Item_count = CONFIGURE_RECORD_PER_PROCESSOR_ITEMS;
+
+    struct Record_Configured_control {
+      Record_Control    Control;
+      rtems_record_item Items[ CONFIGURE_RECORD_PER_PROCESSOR_ITEMS ];
+    };
+
+    PER_CPU_DATA_ITEM( Record_Configured_control, _Record_Per_CPU );
+
+    RTEMS_SYSINIT_ITEM(
+      _Record_Initialize,
+      RTEMS_SYSINIT_RECORD,
+      RTEMS_SYSINIT_ORDER_MIDDLE
+    );
+  #endif
 #endif
 
 #if defined(RTEMS_SMP)