record.h

/* SPDX-License-Identifier: BSD-2-Clause */
 
/*
 * Copyright (C) 2018, 2024 embedded brains GmbH & Co. KG
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 * POSSIBILITY OF SUCH DAMAGE.
 */
 
#ifndef _RTEMS_RECORD_H
#define _RTEMS_RECORD_H
 
#include "recorddata.h"
 
#include <rtems/rtems/intr.h>
#include <rtems/score/atomic.h>
#include <rtems/score/cpu.h>
#include <rtems/score/interr.h>
#include <rtems/score/percpu.h>
#include <rtems/score/watchdog.h>
#include <rtems/counter.h>
 
#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */
 
typedef struct Record_Control {
  Atomic_Uint       head;
  unsigned int      tail;
  unsigned int      mask;
  Watchdog_Control  Watchdog;
  RTEMS_ALIGNED( CPU_CACHE_LINE_BYTES )
    rtems_record_item Items[ RTEMS_ZERO_LENGTH_ARRAY ];
} Record_Control;
 
typedef struct {
  unsigned int    item_count;
  Record_Control *controls;
} Record_Configuration;
 
typedef struct {
  Record_Control *control;
  unsigned int    head;
  uint32_t        now;
  uint32_t        level;
} rtems_record_context;
 
extern const Record_Configuration _Record_Configuration;
 
void _Record_Initialize( void );
 
void _Record_Interrupt_initialize( void );
 
extern rtems_interrupt_entry *_Record_Interrupt_dispatch_table[];
 
bool _Record_Thread_create(
  struct _Thread_Control *executing,
  struct _Thread_Control *created
);
 
void _Record_Thread_start(
  struct _Thread_Control *executing,
  struct _Thread_Control *started
);
 
void _Record_Thread_restart(
  struct _Thread_Control *executing,
  struct _Thread_Control *restarted
);
 
void _Record_Thread_delete(
  struct _Thread_Control *executing,
  struct _Thread_Control *deleted
);
 
void _Record_Thread_switch(
  struct _Thread_Control *executing,
  struct _Thread_Control *heir
);
 
void _Record_Thread_begin( struct _Thread_Control *executing );
 
void _Record_Thread_exitted( struct _Thread_Control *executing );
 
void _Record_Fatal_dump_base64(
  Internal_errors_Source source,
  bool                   always_set_to_false,
  Internal_errors_t      code
);
 
void _Record_Fatal_dump_base64_zlib(
  Internal_errors_Source source,
  bool                   always_set_to_false,
  Internal_errors_t      code
);
 
void _Record_Thread_terminate(
  struct _Thread_Control *executing
);
 
static inline unsigned int _Record_Index(
  const Record_Control *control,
  unsigned int          index
)
{
  return index & control->mask;
}
 
static inline unsigned int _Record_Head( Record_Control *control )
{
#ifdef RTEMS_SMP
  /*
   * Use a read-modify-write operation to get the last value stored by the
   * record producer.
   */
  return _Atomic_Fetch_add_uint( &control->head, 0, ATOMIC_ORDER_ACQUIRE );
#else
  return _Atomic_Load_uint( &control->head, ATOMIC_ORDER_ACQUIRE );
#endif
}
 
static inline unsigned int _Record_Tail( const Record_Control *control )
{
  return control->tail;
}
 
static inline bool _Record_Is_overflow(
  const Record_Control *control,
  unsigned int          tail,
  unsigned int          head
)
{
  return head - tail >= control->mask + 1U;
}
 
static inline unsigned int _Record_Capacity(
  const Record_Control *control,
  unsigned int          tail,
  unsigned int          head
)
{
  return ( tail - head - 1U ) & control->mask;
}
 
static inline rtems_counter_ticks _Record_Now( void )
{
  return rtems_counter_read();
}
 
typedef struct RTEMS_PACKED {
  uint32_t format;
  uint32_t magic;
  rtems_record_item Version;
  rtems_record_item Processor_maximum;
  rtems_record_item Count;
  rtems_record_item Frequency;
  rtems_record_item Info[64];
} Record_Stream_header;
 
size_t _Record_Stream_header_initialize( Record_Stream_header *header );
 
size_t _Record_String_to_items(
  rtems_record_event  event,
  const char         *str,
  size_t              len,
  rtems_record_item  *items,
  size_t              item_count
);
 
void _Record_Caller( void *return_address );
 
void _Record_Caller_3(
  void               *return_address,
  rtems_record_event  event,
  rtems_record_data   data
);
 
void _Record_Caller_4(
  void               *return_address,
  rtems_record_event  event_0,
  rtems_record_data   data_0,
  rtems_record_event  event_1,
  rtems_record_data   data_1
);
 
void _Record_Caller_arg( void *return_address, rtems_record_data data );
 
void _Record_Caller_arg_2(
  void              *return_address,
  rtems_record_data  data_0,
  rtems_record_data  data_1
);
 
void _Record_Caller_arg_3(
  void              *return_address,
  rtems_record_data  data_0,
  rtems_record_data  data_1,
  rtems_record_data  data_2
);
 
void _Record_Caller_arg_4(
  void              *return_address,
  rtems_record_data  data_0,
  rtems_record_data  data_1,
  rtems_record_data  data_2,
  rtems_record_data  data_3
);
 
void _Record_Caller_arg_5(
  void              *return_address,
  rtems_record_data  data_0,
  rtems_record_data  data_1,
  rtems_record_data  data_2,
  rtems_record_data  data_3,
  rtems_record_data  data_4
);
 
void _Record_Caller_arg_6(
  void              *return_address,
  rtems_record_data  data_0,
  rtems_record_data  data_1,
  rtems_record_data  data_2,
  rtems_record_data  data_3,
  rtems_record_data  data_4,
  rtems_record_data  data_5
);
 
void _Record_Caller_arg_7(
  void              *return_address,
  rtems_record_data  data_0,
  rtems_record_data  data_1,
  rtems_record_data  data_2,
  rtems_record_data  data_3,
  rtems_record_data  data_4,
  rtems_record_data  data_5,
  rtems_record_data  data_6
);
 
void _Record_Caller_arg_8(
  void              *return_address,
  rtems_record_data  data_0,
  rtems_record_data  data_1,
  rtems_record_data  data_2,
  rtems_record_data  data_3,
  rtems_record_data  data_4,
  rtems_record_data  data_5,
  rtems_record_data  data_6,
  rtems_record_data  data_7
);
 
void _Record_Caller_arg_9(
  void              *return_address,
  rtems_record_data  data_0,
  rtems_record_data  data_1,
  rtems_record_data  data_2,
  rtems_record_data  data_3,
  rtems_record_data  data_4,
  rtems_record_data  data_5,
  rtems_record_data  data_6,
  rtems_record_data  data_7,
  rtems_record_data  data_8
);
 
void _Record_Caller_arg_10(
  void              *return_address,
  rtems_record_data  data_0,
  rtems_record_data  data_1,
  rtems_record_data  data_2,
  rtems_record_data  data_3,
  rtems_record_data  data_4,
  rtems_record_data  data_5,
  rtems_record_data  data_6,
  rtems_record_data  data_7,
  rtems_record_data  data_8,
  rtems_record_data  data_9
);
 
void _Record_Entry_2(
  void               *return_address,
  rtems_record_event  event,
  rtems_record_data   data_0,
  rtems_record_data   data_1
);
 
void _Record_Entry_3(
  void               *return_address,
  rtems_record_event  event,
  rtems_record_data   data_0,
  rtems_record_data   data_1,
  rtems_record_data   data_2
);
 
void _Record_Entry_4(
  void               *return_address,
  rtems_record_event  event,
  rtems_record_data   data_0,
  rtems_record_data   data_1,
  rtems_record_data   data_2,
  rtems_record_data   data_3
);
 
void _Record_Entry_5(
  void               *return_address,
  rtems_record_event  event,
  rtems_record_data   data_0,
  rtems_record_data   data_1,
  rtems_record_data   data_2,
  rtems_record_data   data_3,
  rtems_record_data   data_4
);
 
void _Record_Entry_6(
  void               *return_address,
  rtems_record_event  event,
  rtems_record_data   data_0,
  rtems_record_data   data_1,
  rtems_record_data   data_2,
  rtems_record_data   data_3,
  rtems_record_data   data_4,
  rtems_record_data   data_5
);
 
void _Record_Entry_7(
  void               *return_address,
  rtems_record_event  event,
  rtems_record_data   data_0,
  rtems_record_data   data_1,
  rtems_record_data   data_2,
  rtems_record_data   data_3,
  rtems_record_data   data_4,
  rtems_record_data   data_5,
  rtems_record_data   data_6
);
 
void _Record_Entry_8(
  void               *return_address,
  rtems_record_event  event,
  rtems_record_data   data_0,
  rtems_record_data   data_1,
  rtems_record_data   data_2,
  rtems_record_data   data_3,
  rtems_record_data   data_4,
  rtems_record_data   data_5,
  rtems_record_data   data_6,
  rtems_record_data   data_7
);
 
void _Record_Entry_9(
  void               *return_address,
  rtems_record_event  event,
  rtems_record_data   data_0,
  rtems_record_data   data_1,
  rtems_record_data   data_2,
  rtems_record_data   data_3,
  rtems_record_data   data_4,
  rtems_record_data   data_5,
  rtems_record_data   data_6,
  rtems_record_data   data_7,
  rtems_record_data   data_8
);
 
void _Record_Entry_10(
  void               *return_address,
  rtems_record_event  event,
  rtems_record_data   data_0,
  rtems_record_data   data_1,
  rtems_record_data   data_2,
  rtems_record_data   data_3,
  rtems_record_data   data_4,
  rtems_record_data   data_5,
  rtems_record_data   data_6,
  rtems_record_data   data_7,
  rtems_record_data   data_8,
  rtems_record_data   data_9
);
 
void _Record_Exit_2(
  void               *return_address,
  rtems_record_event  event,
  rtems_record_data   data_0,
  rtems_record_data   data_1
);
 
void _Record_Exit_3(
  void               *return_address,
  rtems_record_event  event,
  rtems_record_data   data_0,
  rtems_record_data   data_1,
  rtems_record_data   data_2
);
 
void _Record_Exit_4(
  void               *return_address,
  rtems_record_event  event,
  rtems_record_data   data_0,
  rtems_record_data   data_1,
  rtems_record_data   data_2,
  rtems_record_data   data_3
);
 
void _Record_Exit_5(
  void               *return_address,
  rtems_record_event  event,
  rtems_record_data   data_0,
  rtems_record_data   data_1,
  rtems_record_data   data_2,
  rtems_record_data   data_3,
  rtems_record_data   data_4
);
 
void _Record_Exit_6(
  void               *return_address,
  rtems_record_event  event,
  rtems_record_data   data_0,
  rtems_record_data   data_1,
  rtems_record_data   data_2,
  rtems_record_data   data_3,
  rtems_record_data   data_4,
  rtems_record_data   data_5
);
 
void _Record_Exit_7(
  void               *return_address,
  rtems_record_event  event,
  rtems_record_data   data_0,
  rtems_record_data   data_1,
  rtems_record_data   data_2,
  rtems_record_data   data_3,
  rtems_record_data   data_4,
  rtems_record_data   data_5,
  rtems_record_data   data_6
);
 
void _Record_Exit_8(
  void               *return_address,
  rtems_record_event  event,
  rtems_record_data   data_0,
  rtems_record_data   data_1,
  rtems_record_data   data_2,
  rtems_record_data   data_3,
  rtems_record_data   data_4,
  rtems_record_data   data_5,
  rtems_record_data   data_6,
  rtems_record_data   data_7
);
 
void _Record_Exit_9(
  void               *return_address,
  rtems_record_event  event,
  rtems_record_data   data_0,
  rtems_record_data   data_1,
  rtems_record_data   data_2,
  rtems_record_data   data_3,
  rtems_record_data   data_4,
  rtems_record_data   data_5,
  rtems_record_data   data_6,
  rtems_record_data   data_7,
  rtems_record_data   data_8
);
 
void _Record_Exit_10(
  void               *return_address,
  rtems_record_event  event,
  rtems_record_data   data_0,
  rtems_record_data   data_1,
  rtems_record_data   data_2,
  rtems_record_data   data_3,
  rtems_record_data   data_4,
  rtems_record_data   data_5,
  rtems_record_data   data_6,
  rtems_record_data   data_7,
  rtems_record_data   data_8,
  rtems_record_data   data_9
);
 
static inline void rtems_record_prepare_critical(
  rtems_record_context  *context,
  const Per_CPU_Control *cpu_self
)
{
  Record_Control *control;
  unsigned int    head;
 
  context->now = RTEMS_RECORD_TIME_EVENT( _Record_Now(), 0 );
  control = cpu_self->record;
  context->control = control;
  head = _Record_Head( control );
  context->head = head;
}
 
static inline void rtems_record_prepare( rtems_record_context *context )
{
  uint32_t               level;
  const Per_CPU_Control *cpu_self;
  Record_Control        *control;
  unsigned int           head;
 
  _CPU_ISR_Disable( level );
  RTEMS_COMPILER_MEMORY_BARRIER();
  context->now = RTEMS_RECORD_TIME_EVENT( _Record_Now(), 0 );
  context->level = level;
  cpu_self = _Per_CPU_Get();
  control = cpu_self->record;
  context->control = control;
  head = _Record_Head( control );
  context->head = head;
}
 
static inline void rtems_record_add(
  rtems_record_context *context,
  rtems_record_event    event,
  rtems_record_data     data
)
{
  Record_Control    *control;
  rtems_record_item *item;
  unsigned int       head;
 
  control = context->control;
  head = context->head;
  item = &control->Items[ _Record_Index( control, head ) ];
  context->head = head + 1;
 
  item->event = context->now | event;
  item->data = data;
}
 
static inline void rtems_record_commit_critical( rtems_record_context *context )
{
  _Atomic_Store_uint(
    &context->control->head,
    context->head,
    ATOMIC_ORDER_RELEASE
  );
}
 
static inline void rtems_record_commit( rtems_record_context *context )
{
  rtems_record_commit_critical( context );
  RTEMS_COMPILER_MEMORY_BARRIER();
  _CPU_ISR_Enable( context->level );
}
 
void rtems_record_produce( rtems_record_event event, rtems_record_data data );
 
void rtems_record_produce_2(
  rtems_record_event event_0,
  rtems_record_data  data_0,
  rtems_record_event event_1,
  rtems_record_data  data_1
);
 
void rtems_record_produce_n(
  const rtems_record_item *items,
  size_t                   n
);
 
void rtems_record_line( void );
 
void rtems_record_line_2(
  rtems_record_event event,
  rtems_record_data  data
);
 
void rtems_record_line_3(
  rtems_record_event event_0,
  rtems_record_data  data_0,
  rtems_record_event event_1,
  rtems_record_data  data_1
);
 
void rtems_record_line_arg( rtems_record_data data );
 
void rtems_record_line_arg_2(
  rtems_record_data data_0,
  rtems_record_data data_1
);
 
void rtems_record_line_arg_3(
  rtems_record_data data_0,
  rtems_record_data data_1,
  rtems_record_data data_2
);
 
void rtems_record_line_arg_4(
  rtems_record_data data_0,
  rtems_record_data data_1,
  rtems_record_data data_2,
  rtems_record_data data_3
);
 
void rtems_record_line_arg_5(
  rtems_record_data data_0,
  rtems_record_data data_1,
  rtems_record_data data_2,
  rtems_record_data data_3,
  rtems_record_data data_4
);
 
void rtems_record_line_arg_6(
  rtems_record_data data_0,
  rtems_record_data data_1,
  rtems_record_data data_2,
  rtems_record_data data_3,
  rtems_record_data data_4,
  rtems_record_data data_5
);
 
void rtems_record_line_arg_7(
  rtems_record_data data_0,
  rtems_record_data data_1,
  rtems_record_data data_2,
  rtems_record_data data_3,
  rtems_record_data data_4,
  rtems_record_data data_5,
  rtems_record_data data_6
);
 
void rtems_record_line_arg_8(
  rtems_record_data data_0,
  rtems_record_data data_1,
  rtems_record_data data_2,
  rtems_record_data data_3,
  rtems_record_data data_4,
  rtems_record_data data_5,
  rtems_record_data data_6,
  rtems_record_data data_7
);
 
void rtems_record_line_arg_9(
  rtems_record_data data_0,
  rtems_record_data data_1,
  rtems_record_data data_2,
  rtems_record_data data_3,
  rtems_record_data data_4,
  rtems_record_data data_5,
  rtems_record_data data_6,
  rtems_record_data data_7,
  rtems_record_data data_8
);
 
void rtems_record_line_arg_10(
  rtems_record_data data_0,
  rtems_record_data data_1,
  rtems_record_data data_2,
  rtems_record_data data_3,
  rtems_record_data data_4,
  rtems_record_data data_5,
  rtems_record_data data_6,
  rtems_record_data data_7,
  rtems_record_data data_8,
  rtems_record_data data_9
);
 
#define rtems_record_caller() _Record_Caller( RTEMS_RETURN_ADDRESS() )
 
#define rtems_record_caller_3( event, data ) \
  _Record_Caller_3( RTEMS_RETURN_ADDRESS(), event, data )
 
#define rtems_record_caller_4( event_0, data_0, event_1, data_1 ) \
  _Record_Caller_4( \
    RTEMS_RETURN_ADDRESS(), \
    event_0, \
    data_0, \
    event_1, \
    data_1 \
  )
 
#define rtems_record_caller_arg( data ) \
  _Record_Caller_arg( RTEMS_RETURN_ADDRESS(), data )
 
#define rtems_record_caller_arg_2( data_0, data_1 ) \
  _Record_Caller_arg_2( \
    RTEMS_RETURN_ADDRESS(), \
    data_0, \
    data_1 \
  )
 
#define rtems_record_caller_arg_3( data_0, data_1, data_2 ) \
  _Record_Caller_arg_3( \
    RTEMS_RETURN_ADDRESS(), \
    data_0, \
    data_1, \
    data_2 \
  )
 
#define rtems_record_caller_arg_4( data_0, data_1, data_2, data_3 ) \
  _Record_Caller_arg_4( \
    RTEMS_RETURN_ADDRESS(), \
    data_0, \
    data_1, \
    data_2, \
    data_3 \
  )
 
#define rtems_record_caller_arg_5( data_0, data_1, data_2, data_3, data_4 ) \
  _Record_Caller_arg_5( \
    RTEMS_RETURN_ADDRESS(), \
    data_0, \
    data_1, \
    data_2, \
    data_3, \
    data_4 \
  )
 
#define rtems_record_caller_arg_6( \
  data_0, \
  data_1, \
  data_2, \
  data_3, \
  data_4, \
  data_5 \
) \
  _Record_Caller_arg_6( \
    RTEMS_RETURN_ADDRESS(), \
    data_0, \
    data_1, \
    data_2, \
    data_3, \
    data_4, \
    data_5 \
  )
 
#define rtems_record_caller_arg_7( \
  data_0, \
  data_1, \
  data_2, \
  data_3, \
  data_4, \
  data_5, \
  data_6 \
) \
  _Record_Caller_arg_7( \
    RTEMS_RETURN_ADDRESS(), \
    data_0, \
    data_1, \
    data_2, \
    data_3, \
    data_4, \
    data_5, \
    data_6 \
  )
 
#define rtems_record_caller_arg_8( \
  data_0, \
  data_1, \
  data_2, \
  data_3, \
  data_4, \
  data_5, \
  data_6, \
  data_7 \
) \
  _Record_Caller_arg_8( \
    RTEMS_RETURN_ADDRESS(), \
    data_0, \
    data_1, \
    data_2, \
    data_3, \
    data_4, \
    data_5, \
    data_6, \
    data_7 \
  )
 
#define rtems_record_caller_arg_9( \
  data_0, \
  data_1, \
  data_2, \
  data_3, \
  data_4, \
  data_5, \
  data_6, \
  data_7, \
  data_8 \
) \
  _Record_Caller_arg_9( \
    RTEMS_RETURN_ADDRESS(), \
    data_0, \
    data_1, \
    data_2, \
    data_3, \
    data_4, \
    data_5, \
    data_6, \
    data_7, \
    data_8 \
  )
 
#define rtems_record_caller_arg_10( \
  data_0, \
  data_1, \
  data_2, \
  data_3, \
  data_4, \
  data_5, \
  data_6, \
  data_7, \
  data_8, \
  data_9 \
) \
  _Record_Caller_arg_10( \
    RTEMS_RETURN_ADDRESS(), \
    data_0, \
    data_1, \
    data_2, \
    data_3, \
    data_4, \
    data_5, \
    data_6, \
    data_7, \
    data_8, \
    data_9 \
  )
 
#define rtems_record_entry( event ) \
  rtems_record_produce( event, (rtems_record_data) RTEMS_RETURN_ADDRESS() )
 
#define rtems_record_entry_1( event, data ) \
  rtems_record_produce_2( \
    event, \
    (rtems_record_data) RTEMS_RETURN_ADDRESS(), \
    RTEMS_RECORD_ARG_0, \
    data \
  )
 
#define rtems_record_entry_2( event, data_0, data_1 ) \
  _Record_Entry_2( RTEMS_RETURN_ADDRESS(), event, data_0, data_1 )
 
#define rtems_record_entry_3( event, data_0, data_1, data_2 ) \
  _Record_Entry_3( \
    RTEMS_RETURN_ADDRESS(), \
    event, \
    data_0, \
    data_1, \
    data_2 \
  )
 
#define rtems_record_entry_4( event, data_0, data_1, data_2, data_3 ) \
  _Record_Entry_4( \
    RTEMS_RETURN_ADDRESS(), \
    event, \
    data_0, \
    data_1, \
    data_2, \
    data_3 \
  )
 
#define rtems_record_entry_5( \
  event, \
  data_0, \
  data_1, \
  data_2, \
  data_3, \
  data_4 \
) \
  _Record_Entry_5( \
    RTEMS_RETURN_ADDRESS(), \
    event, \
    data_0, \
    data_1, \
    data_2, \
    data_3, \
    data_4 \
  )
 
#define rtems_record_entry_6( \
  event, \
  data_0, \
  data_1, \
  data_2, \
  data_3, \
  data_4, \
  data_5 \
) \
  _Record_Entry_6( \
    RTEMS_RETURN_ADDRESS(), \
    event, \
    data_0, \
    data_1, \
    data_2, \
    data_3, \
    data_4, \
    data_5 \
  )
 
#define rtems_record_entry_7( \
  event, \
  data_0, \
  data_1, \
  data_2, \
  data_3, \
  data_4, \
  data_5, \
  data_6 \
) \
  _Record_Entry_7( \
    RTEMS_RETURN_ADDRESS(), \
    event, \
    data_0, \
    data_1, \
    data_2, \
    data_3, \
    data_4, \
    data_5, \
    data_6 \
  )
 
#define rtems_record_entry_8( \
  event, \
  data_0, \
  data_1, \
  data_2, \
  data_3, \
  data_4, \
  data_5, \
  data_6, \
  data_7 \
) \
  _Record_Entry_8( \
    RTEMS_RETURN_ADDRESS(), \
    event, \
    data_0, \
    data_1, \
    data_2, \
    data_3, \
    data_4, \
    data_5, \
    data_6, \
    data_7 \
  )
 
#define rtems_record_entry_9( \
  event, \
  data_0, \
  data_1, \
  data_2, \
  data_3, \
  data_4, \
  data_5, \
  data_6, \
  data_7, \
  data_8 \
) \
  _Record_Entry_9( \
    RTEMS_RETURN_ADDRESS(), \
    event, \
    data_0, \
    data_1, \
    data_2, \
    data_3, \
    data_4, \
    data_5, \
    data_6, \
    data_7, \
    data_8 \
  )
 
#define rtems_record_entry_10( \
  event, \
  data_0, \
  data_1, \
  data_2, \
  data_3, \
  data_4, \
  data_5, \
  data_6, \
  data_7, \
  data_8, \
  data_9 \
) \
  _Record_Entry_10( \
    RTEMS_RETURN_ADDRESS(), \
    event, \
    data_0, \
    data_1, \
    data_2, \
    data_3, \
    data_4, \
    data_5, \
    data_6, \
    data_7, \
    data_8, \
    data_9 \
  )
 
#define rtems_record_exit( event ) \
  rtems_record_produce( event, (rtems_record_data) RTEMS_RETURN_ADDRESS() )
 
#define rtems_record_exit_1( event, data ) \
  rtems_record_produce_2( \
    event, \
    (rtems_record_data) RTEMS_RETURN_ADDRESS(), \
    RTEMS_RECORD_RETURN_0, \
    data \
  )
 
#define rtems_record_exit_2( event, data_0, data_1 ) \
  _Record_Entry_2( RTEMS_RETURN_ADDRESS(), event, data_0, data_1 )
 
#define rtems_record_exit_3( event, data_0, data_1, data_2 ) \
  _Record_Exit_3( \
    RTEMS_RETURN_ADDRESS(), \
    event, \
    data_0, \
    data_1, \
    data_2 \
  )
 
#define rtems_record_exit_4( event, data_0, data_1, data_2, data_3 ) \
  _Record_Exit_4( \
    RTEMS_RETURN_ADDRESS(), \
    event, \
    data_0, \
    data_1, \
    data_2, \
    data_3 \
  )
 
#define rtems_record_exit_5( \
  event, \
  data_0, \
  data_1, \
  data_2, \
  data_3, \
  data_4 \
) \
  _Record_Exit_5( \
    RTEMS_RETURN_ADDRESS(), \
    event, \
    data_0, \
    data_1, \
    data_2, \
    data_3, \
    data_4 \
  )
 
#define rtems_record_exit_6( \
  event, \
  data_0, \
  data_1, \
  data_2, \
  data_3, \
  data_4, \
  data_5 \
) \
  _Record_Exit_6( \
    RTEMS_RETURN_ADDRESS(), \
    event, \
    data_0, \
    data_1, \
    data_2, \
    data_3, \
    data_4, \
    data_5 \
  )
 
#define rtems_record_exit_7( \
  event, \
  data_0, \
  data_1, \
  data_2, \
  data_3, \
  data_4, \
  data_5, \
  data_6 \
) \
  _Record_Exit_7( \
    RTEMS_RETURN_ADDRESS(), \
    event, \
    data_0, \
    data_1, \
    data_2, \
    data_3, \
    data_4, \
    data_5, \
    data_6 \
  )
 
#define rtems_record_exit_8( \
  event, \
  data_0, \
  data_1, \
  data_2, \
  data_3, \
  data_4, \
  data_5, \
  data_6, \
  data_7 \
) \
  _Record_Exit_8( \
    RTEMS_RETURN_ADDRESS(), \
    event, \
    data_0, \
    data_1, \
    data_2, \
    data_3, \
    data_4, \
    data_5, \
    data_6, \
    data_7 \
  )
 
#define rtems_record_exit_9( \
  event, \
  data_0, \
  data_1, \
  data_2, \
  data_3, \
  data_4, \
  data_5, \
  data_6, \
  data_7, \
  data_8 \
) \
  _Record_Exit_9( \
    RTEMS_RETURN_ADDRESS(), \
    event, \
    data_0, \
    data_1, \
    data_2, \
    data_3, \
    data_4, \
    data_5, \
    data_6, \
    data_7, \
    data_8 \
  )
 
#define rtems_record_exit_10( \
  event, \
  data_0, \
  data_1, \
  data_2, \
  data_3, \
  data_4, \
  data_5, \
  data_6, \
  data_7, \
  data_8, \
  data_9 \
) \
  _Record_Exit_10( \
    RTEMS_RETURN_ADDRESS(), \
    event, \
    data_0, \
    data_1, \
    data_2, \
    data_3, \
    data_4, \
    data_5, \
    data_6, \
    data_7, \
    data_8, \
    data_9 \
  )
 
uint32_t rtems_record_interrupt_disable( void );
 
void rtems_record_interrupt_enable( uint32_t level );
 
typedef struct {
  rtems_record_item *fetched_items;
 
  size_t fetched_count;
 
  struct {
#ifdef RTEMS_SMP
    uint32_t cpu_index;
#endif
 
    size_t cpu_todo;
 
    rtems_record_item *storage_items;
 
    size_t storage_item_count;
  } internal;
} rtems_record_fetch_control;
 
typedef enum {
  RTEMS_RECORD_FETCH_DONE,
 
  RTEMS_RECORD_FETCH_CONTINUE,
 
  RTEMS_RECORD_FETCH_INVALID_ITEM_COUNT
} rtems_record_fetch_status;
 
size_t rtems_record_get_item_count_for_fetch( void );
 
void rtems_record_fetch_initialize(
  rtems_record_fetch_control *control,
  rtems_record_item          *items,
  size_t                      count
);
 
rtems_record_fetch_status rtems_record_fetch(
  rtems_record_fetch_control *control
);
 
#ifdef __cplusplus
}
#endif /* __cplusplus */
 
#endif /* _RTEMS_RECORD_H */