summaryrefslogtreecommitdiffstats
path: root/spec/rtems/scheduler/if/get-processor.yml
diff options
context:
space:
mode:
authorSebastian Huber <sebastian.huber@embedded-brains.de>2020-09-16 11:48:29 +0200
committerSebastian Huber <sebastian.huber@embedded-brains.de>2020-09-16 16:33:00 +0200
commit3bdf817950eadd75a2785b62220eb0b04533b9fd (patch)
treeed221c6de813e7a473e2882af6326bf2e5b44bd1 /spec/rtems/scheduler/if/get-processor.yml
parentspec: Specify rtems_task_construct() (diff)
downloadrtems-central-3bdf817950eadd75a2785b62220eb0b04533b9fd.tar.bz2
spec: Group items by component
Diffstat (limited to 'spec/rtems/scheduler/if/get-processor.yml')
-rw-r--r--spec/rtems/scheduler/if/get-processor.yml35
1 files changed, 35 insertions, 0 deletions
diff --git a/spec/rtems/scheduler/if/get-processor.yml b/spec/rtems/scheduler/if/get-processor.yml
new file mode 100644
index 00000000..8c32712b
--- /dev/null
+++ b/spec/rtems/scheduler/if/get-processor.yml
@@ -0,0 +1,35 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+brief: |
+ Returns the index of the current processor.
+copyrights:
+- Copyright (C) 2014, 2020 embedded brains GmbH (http://www.embedded-brains.de)
+definition:
+ default: ${/score/smp/if/get-current-processor:/name}()
+ variants: []
+description: |
+ In uniprocessor configurations, this macro evaluates to a compile time
+ constant of zero.
+
+ In SMP configurations, an architecture-specific method is used to obtain the
+ index of the current processor in the system. The set of processor indices
+ is the range of integers starting with zero up to
+ ${get-processor-maximum:/name} minus one.
+enabled-by: true
+interface-type: macro
+links:
+- role: interface-placement
+ uid: ../../task/if/header
+- role: interface-ingroup
+ uid: ../../task/if/group
+name: rtems_scheduler_get_processor
+notes: |
+ Outside of sections with disabled thread dispatching the current processor
+ index may change after every instruction since the thread may migrate from
+ one processor to another. Sections with disabled interrupts are sections
+ with thread dispatching disabled.
+params: []
+return:
+ return: |
+ The index of the current processor is returned.
+ return-values: []
+type: interface