From 8fa14da0025828f052b809225ec295fb02688dea Mon Sep 17 00:00:00 2001
From: Sebastian Huber <sebastian.huber@embedded-brains.de>
Date: Thu, 18 Apr 2019 08:38:00 +0200
Subject: score: Move per-processor job data structures

This enables re-use for other purposes, e.g. replacement for
SMP_MESSAGE_TEST.
---
 cpukit/include/rtems/score/percpu.h | 59 +++++++++++++++++++++++++++++++++++--
 1 file changed, 56 insertions(+), 3 deletions(-)

(limited to 'cpukit/include/rtems/score/percpu.h')

diff --git a/cpukit/include/rtems/score/percpu.h b/cpukit/include/rtems/score/percpu.h
index e97f6cdfbd..eff71c4ec1 100644
--- a/cpukit/include/rtems/score/percpu.h
+++ b/cpukit/include/rtems/score/percpu.h
@@ -77,8 +77,6 @@ struct _Thread_Control;
 
 struct Scheduler_Context;
 
-struct Per_CPU_Job;
-
 /**
  *  @defgroup PerCPU RTEMS Per CPU Information
  *
@@ -175,6 +173,61 @@ typedef enum {
   PER_CPU_STATE_SHUTDOWN
 } Per_CPU_State;
 
+typedef void ( *Per_CPU_Job_handler )( void *arg );
+
+/**
+ * @brief Context for per-processor jobs.
+ *
+ * This is separate from Per_CPU_Job to save stack memory in
+ * _SMP_Multicast_action().
+ */
+typedef struct {
+  /**
+   * @brief The job handler.
+   */
+  Per_CPU_Job_handler handler;
+
+  /**
+   * @brief The job handler argument.
+   */
+  void *arg;
+} Per_CPU_Job_context;
+
+/*
+ * Value for the Per_CPU_Job::done member to indicate that a job is done
+ * (handler was called on the target processor).  Must not be a valid pointer
+ * value since it overlaps with the Per_CPU_Job::next member.
+ */
+#define PER_CPU_JOB_DONE 1
+
+/**
+ * @brief A per-processor job.
+ *
+ * This structure must be as small as possible due to stack space constraints
+ * in _SMP_Multicast_action().
+ */
+typedef struct Per_CPU_Job {
+  union {
+    /**
+     * @brief The next job in the corresponding per-processor job list.
+     */
+    struct Per_CPU_Job *next;
+
+    /**
+     * @brief Indication if the job is done.
+     *
+     * A job is done if this member has the value PER_CPU_JOB_DONE.  This
+     * assumes that PER_CPU_JOB_DONE is not a valid pointer value.
+     */
+    Atomic_Ulong done;
+  };
+
+  /**
+   * @brief Pointer to the job context to get the handler and argument.
+   */
+  const Per_CPU_Job_context *context;
+} Per_CPU_Job;
+
 #endif /* defined( RTEMS_SMP ) */
 
 /**
@@ -316,7 +369,7 @@ typedef struct Per_CPU_Control {
   uint32_t isr_nest_level;
 
   /**
-   * @brief Indicetes if an ISR thread dispatch is disabled.
+   * @brief Indicates if an ISR thread dispatch is disabled.
    *
    * This flag is context switched with each thread.  It indicates that this
    * thread has an interrupt stack frame on its stack.  By using this flag, we
-- 
cgit v1.2.3