source: rtems/cpukit/include/rtems/score/schedulersmp.h @ 878487b0

5
Last change on this file since 878487b0 was 2afb22b, checked in by Chris Johns <chrisj@…>, on 12/23/17 at 07:18:56

Remove make preinstall

A speciality of the RTEMS build system was the make preinstall step. It
copied header files from arbitrary locations into the build tree. The
header files were included via the -Bsome/build/tree/path GCC command
line option.

This has at least seven problems:

  • The make preinstall step itself needs time and disk space.
  • Errors in header files show up in the build tree copy. This makes it hard for editors to open the right file to fix the error.
  • There is no clear relationship between source and build tree header files. This makes an audit of the build process difficult.
  • The visibility of all header files in the build tree makes it difficult to enforce API barriers. For example it is discouraged to use BSP-specifics in the cpukit.
  • An introduction of a new build system is difficult.
  • Include paths specified by the -B option are system headers. This may suppress warnings.
  • The parallel build had sporadic failures on some hosts.

This patch removes the make preinstall step. All installed header
files are moved to dedicated include directories in the source tree.
Let @RTEMS_CPU@ be the target architecture, e.g. arm, powerpc, sparc,
etc. Let @RTEMS_BSP_FAMILIY@ be a BSP family base directory, e.g.
erc32, imx, qoriq, etc.

The new cpukit include directories are:

  • cpukit/include
  • cpukit/score/cpu/@RTEMS_CPU@/include
  • cpukit/libnetworking

The new BSP include directories are:

  • bsps/include
  • bsps/@RTEMS_CPU@/include
  • bsps/@RTEMS_CPU@/@RTEMS_BSP_FAMILIY@/include

There are build tree include directories for generated files.

The include directory order favours the most general header file, e.g.
it is not possible to override general header files via the include path
order.

The "bootstrap -p" option was removed. The new "bootstrap -H" option
should be used to regenerate the "headers.am" files.

Update #3254.
  • Property mode set to 100644
File size: 2.7 KB
Line 
1/**
2 * @file
3 *
4 * @brief SMP Scheduler API
5 *
6 * @ingroup ScoreSchedulerSMP
7 */
8
9/*
10 * Copyright (c) 2013-2014 embedded brains GmbH.  All rights reserved.
11 *
12 *  embedded brains GmbH
13 *  Dornierstr. 4
14 *  82178 Puchheim
15 *  Germany
16 *  <rtems@embedded-brains.de>
17 *
18 * The license and distribution terms for this file may be
19 * found in the file LICENSE in this distribution or at
20 * http://www.rtems.org/license/LICENSE.
21 */
22
23#ifndef _RTEMS_SCORE_SCHEDULERSMP_H
24#define _RTEMS_SCORE_SCHEDULERSMP_H
25
26#include <rtems/score/chain.h>
27#include <rtems/score/scheduler.h>
28
29#ifdef __cplusplus
30extern "C" {
31#endif /* __cplusplus */
32
33/**
34 * @defgroup ScoreSchedulerSMP SMP Scheduler
35 *
36 * @ingroup ScoreScheduler
37 *
38 * @{
39 */
40
41/**
42 * @brief Scheduler context specialization for SMP schedulers.
43 */
44typedef struct {
45  /**
46   * @brief Basic scheduler context.
47   */
48  Scheduler_Context Base;
49
50  /**
51   * @brief The chain of scheduled nodes.
52   */
53  Chain_Control Scheduled;
54
55  /**
56   * @brief Chain of the available idle threads.
57   *
58   * Idle threads are used for the scheduler helping protocol.  It is crucial
59   * that the idle threads preserve their relative order.  This is the case for
60   * this priority based scheduler.
61   */
62  Chain_Control Idle_threads;
63} Scheduler_SMP_Context;
64
65/**
66 * @brief SMP scheduler node states.
67 */
68typedef enum {
69  /**
70   * @brief This scheduler node is blocked.
71   *
72   * A scheduler node is blocked if the corresponding thread is not ready.
73   */
74  SCHEDULER_SMP_NODE_BLOCKED,
75
76  /**
77   * @brief The scheduler node is scheduled.
78   *
79   * A scheduler node is scheduled if the corresponding thread is ready and the
80   * scheduler allocated a processor for it.  A scheduled node is assigned to
81   * exactly one processor.  The count of scheduled nodes in this scheduler
82   * instance equals the processor count owned by the scheduler instance.
83   */
84  SCHEDULER_SMP_NODE_SCHEDULED,
85
86  /**
87   * @brief This scheduler node is ready.
88   *
89   * A scheduler node is ready if the corresponding thread is ready and the
90   * scheduler did not allocate a processor for it.
91   */
92  SCHEDULER_SMP_NODE_READY
93} Scheduler_SMP_Node_state;
94
95/**
96 * @brief Scheduler node specialization for SMP schedulers.
97 */
98typedef struct {
99  /**
100   * @brief Basic scheduler node.
101   */
102  Scheduler_Node Base;
103
104  /**
105   * @brief The state of this node.
106   */
107  Scheduler_SMP_Node_state state;
108
109  /**
110   * @brief The current priority of thread owning this node.
111   */
112  Priority_Control priority;
113} Scheduler_SMP_Node;
114
115void _Scheduler_SMP_Start_idle(
116  const Scheduler_Control *scheduler,
117  Thread_Control          *idle,
118  struct Per_CPU_Control  *cpu
119);
120
121/** @} */
122
123#ifdef __cplusplus
124}
125#endif /* __cplusplus */
126
127#endif /* _RTEMS_SCORE_SCHEDULERSMP_H */
Note: See TracBrowser for help on using the repository browser.