RTEMS  5.0.0
Data Fields
rtems_profiling_smp_lock Struct Reference

SMP lock profiling data. More...

#include <profiling.h>

Data Fields

rtems_profiling_header header
 The profiling data header.
 
const char * name
 The lock name.
 
uint32_t max_acquire_time
 The maximum lock acquire time in nanoseconds.
 
uint32_t max_section_time
 The maximum lock section time in nanoseconds.
 
uint64_t usage_count
 The count of lock uses. More...
 
uint64_t total_acquire_time
 Total lock acquire time in nanoseconds. More...
 
uint64_t total_section_time
 Total lock section time in nanoseconds. More...
 
uint64_t contention_counts [RTEMS_PROFILING_SMP_LOCK_CONTENTION_COUNTS]
 The counts of lock acquire operations by contention. More...
 

Detailed Description

SMP lock profiling data.

The lock acquire attempt instant is the point in time right after the interrupt disable action in the lock acquire sequence.

The lock acquire instant is the point in time right after the lock acquisition. This is the begin of the critical section code execution.

The lock acquire time is the time elapsed between the lock acquire attempt instant and the lock acquire instant.

The lock release instant is the point in time right before the interrupt enable action in the lock release sequence.

The lock section time is the time elapsed between the lock acquire instant and the lock release instant.

Field Documentation

◆ contention_counts

uint64_t rtems_profiling_smp_lock::contention_counts[RTEMS_PROFILING_SMP_LOCK_CONTENTION_COUNTS]

The counts of lock acquire operations by contention.

The contention count for index N corresponds to a lock acquire attempt with an initial queue length of N. The last index corresponds to all lock acquire attempts with an initial queue length greater than or equal to RTEMS_PROFILING_SMP_LOCK_CONTENTION_COUNTS minus one.

The values may overflow.

◆ total_acquire_time

uint64_t rtems_profiling_smp_lock::total_acquire_time

Total lock acquire time in nanoseconds.

The average lock acquire time is the total acquire time divided by the lock usage count. The ration of the total section and total acquire times gives a measure for the lock contention.

This value may overflow.

◆ total_section_time

uint64_t rtems_profiling_smp_lock::total_section_time

Total lock section time in nanoseconds.

The average lock section time is the total section time divided by the lock usage count.

This value may overflow.

◆ usage_count

uint64_t rtems_profiling_smp_lock::usage_count

The count of lock uses.

This value may overflow.


The documentation for this struct was generated from the following file: