Assembler Reference

COMMON

ARM Compiler toolchain v5.02 for µVision Assembler Reference

COMMON

The COMMON directive allocates a block of memory, of the defined size, at the specified symbol. You specify how the memory is aligned. If alignment is omitted, the default alignment is 4. If size is omitted, the default size is 0.

You can access this memory as you would any other memory, but no space is allocated in object files.

Syntax

COMMON symbol{,size{,alignment}} {[attr]}

where:

symbol

is the symbol name. The symbol name is case-sensitive.

size

is the number of bytes to reserve.

alignment

is the alignment.

attr

can be any one of:

DYNAMIC: sets the ELF symbol visibility to STV_DEFAULT.
PROTECTED: sets the ELF symbol visibility to STV_PROTECTED.
HIDDEN: sets the ELF symbol visibility to STV_HIDDEN.
INTERNAL: sets the ELF symbol visibility to STV_INTERNAL.

Usage

The linker allocates the required space as zero initialized memory during the link stage. You cannot define, IMPORT or EXTERN a symbol that has already been created by the COMMON directive. In the same way, if a symbol has already been defined or used with the IMPORT or EXTERN directive, you cannot use the same symbol for the COMMON directive.

Example

    LDR       r0, =xyz
    COMMON    xyz,255,4   ; defines 255 bytes of ZI store, word-aligned

Incorrect examples

    COMMON    foo,4,4
    COMMON    bar,4,4
foo DCD       0           ; cannot define label with same name as COMMON
    IMPORT    bar         ; cannot import label with same name as COMMON

Copyright © 2011-2012 ARM. All rights reserved.	ARM DUI 0588B
Non-Confidential	ID062912
PDF version

Home > Directives Reference > COMMON

Assembler Reference

COMMON

COMMON

Syntax

Usage

Example

Incorrect examples

Products

Development Tools

Hardware & Collateral

Downloads

Support

Buy

Important information