summaryrefslogtreecommitdiffstats
path: root/spec/rtems/basedefs/req/define-global-symbol-0.yml
blob: 493d80e9f8a98663b3ded101e8725d0d9f76f641 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
SPDX-License-Identifier: CC-BY-SA-4.0
copyrights:
- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
enabled-by: true
functional-type: function
links:
- role: interface-function
  uid: ../if/define-global-symbol
rationale: |
  See also ${../if/declare-global-symbol:/name}.
  *File scope* excludes for example a placement in a function body.
references: []
requirement-type: functional
text: |
  When the macro ${../if/define-global-symbol:/name} appears at file scope,
  and argument ${../if/define-global-symbol:/params[0]/name} after undergoing
  C pre-processor substitutions results in a valid C identifier name,
  and this identifier name is not yet defined at file scope,
  and argument ${../if/define-global-symbol:/params[1]/name} after undergoing
  C pre-processor substitutions results in a valid assembler integer value,
  the macro ${../if/define-global-symbol:/name} shall apply all possible C
  pre-processor substitutions to its argument values
  before it results in assembler code which defines a global symbol
  with the respective name and value.
type: requirement