RTEMS 4.7.99.2 On-Line Library

Rate Monotonic Manager RATE_MONOTONIC_GET_STATISTICS - Obtain statistics from a period

RTEMS C User's Guide

19.4.7: RATE_MONOTONIC_GET_STATISTICS - Obtain statistics from a period

CALLING SEQUENCE:

rtems_status_code rtems_rate_monotonic_get_statistics(
  rtems_id                                id,
  rtems_rate_monotonic_period_statistics *statistics
);

DIRECTIVE STATUS CODES:

RTEMS_SUCCESSFUL - period initiated successfully
RTEMS_INVALID_ID - invalid rate monotonic period id
RTEMS_INVALID_ADDRESS - invalid address of statistics

DESCRIPTION:

This directive returns statistics information associated with the rate monotonic period id in the following data structure:

typedef struct {
 uint32_t     count;           /* periods executed */
 uint32_t     missed_count;    /* period deadlines missed */
 uint32_t     min_cpu_time;    /* minimum CPU time used in a period */
 uint32_t     max_cpu_time;    /* maximum CPU time used in a period */
 uint32_t     total_cpu_time;  /* total CPU time consumed */
 uint32_t     min_wall_time;   /* minimum wall time used in a period */
 uint32_t     max_wall_time;   /* maximum wall time used in a period */
 uint32_t     total_wall_time; /* total wall time consumed */
}  rtems_rate_monotonic_period_statistics;

This directive returns the current statistics information for the period instance assocaited with id. The information returned is indicated by the structure above.

NOTES:

This directive will not cause the running task to be preempted.

RTEMS C User's Guide