Creating a symdefs file

RealView^® Compilation Tools for µVision Linker and Utilities Guide

Version 3.1

Home > Accessing Image Symbols > Accessing symbols in another image > Creating a symdefs file

4.3.1. Creating a symdefs file

Use the armlink option ‑‑symdefs filename to generate a symdefs file.

The linker produces a symdefs file during a successful final link stage. It is not produced for partial linking or for unsuccessful final linking.

Note

If filename does not exist, the file is created containing all the global symbols. If filename exists, the existing contents of filename are used to select the symbols that are output when the linker rewrites the file. If you do not want this behavior, ensure that any existing symdefs file is deleted before the link step.

Outputting a subset of the global symbols

By default, all global symbols are written to the symdefs file.

When filename exists, the linker uses its contents to restrict the output to a subset of the global symbols. To restrict the output symbols:

Specify ‑‑symdefs filename when you are doing a nearly-final link for image1. The linker creates a symdefs file filename.
Open filename in a text editor, remove any symbol entries you do not want in the final list, and save the file.
Specify ‑‑symdefs filename when you are doing a final link for image1.
You can edit filename at any time to add comments and link image1 again, for example, to update the symbol definitions after one or more objects used to create image1 have changed.

Copyright © 2007 ARM Limited. All rights reserved.	ARM DUI 0377A
PDF version

Home > Accessing Image Symbols > Accessing symbols in another image > Creating a symdefs file