summaryrefslogtreecommitdiffstats
path: root/spec/rtems/basedefs/if/define-global-symbol.yml
diff options
context:
space:
mode:
Diffstat (limited to 'spec/rtems/basedefs/if/define-global-symbol.yml')
-rw-r--r--spec/rtems/basedefs/if/define-global-symbol.yml44
1 files changed, 44 insertions, 0 deletions
diff --git a/spec/rtems/basedefs/if/define-global-symbol.yml b/spec/rtems/basedefs/if/define-global-symbol.yml
new file mode 100644
index 00000000..ae3116f6
--- /dev/null
+++ b/spec/rtems/basedefs/if/define-global-symbol.yml
@@ -0,0 +1,44 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+brief: |
+ Defines a global symbol with the specified name and value.
+copyrights:
+- Copyright (C) 2018, 2020 embedded brains GmbH (http://www.embedded-brains.de)
+definition:
+ default: ''
+ variants:
+ - definition: |
+ ${/compiler/if/asm:/name}(
+ "\t.globl " ${xstring:/name}( ${symbol-name:/name}( _name ) )
+ "\n\t.set " ${xstring:/name}( ${symbol-name:/name}( _name ) )
+ ", " ${string:/name}( _value ) "\n"
+ )
+ enabled-by:
+ - defined(${/compiler/if/user-label-prefix:/name})
+description: |
+ This macro shall be placed at file scope.
+enabled-by: true
+interface-type: macro
+links:
+- role: interface-placement
+ uid: header
+- role: interface-ingroup
+ uid: group
+name: RTEMS_DEFINE_GLOBAL_SYMBOL
+notes: null
+params:
+- description: |
+ is the user defined name of the symbol. The name shall be a valid
+ designator. On the name a macro expansion is performed and afterwards it
+ is stringified.
+ dir: null
+ name: _name
+- description: |
+ is the value of the symbol. On the value a macro expansion is performed
+ and afterwards it is stringified. It shall expand to an integer expression
+ understood by the assembler.
+ dir: null
+ name: _value
+return:
+ return: null
+ return-values: []
+type: interface