AN3350 datasheet(77/185 Pages) STMICROELECTRONICS

77 / 185 page

AN3350

Working with the ELF linker

Doc ID 018512 Rev 2

77/185

11.2

Structure of linker command files

Linker command files consist of the following three main segments that should appear in this

order in each file:

●

Mandatory—Memory segment—maps memory segments

●

Mandatory—Sections segment—defines segment contents

●

Optional—Closure blocks—forces functions into closure

11.2.1

Memory segment

The memory segment divides available memory into segments. Section 11.4.6: MEMORY

explains this segment type. Example 12 shows an example MEMORY segment.

Example 12 Example MEMORY segment

MEMORY {

segment_1 (RWX): ORIGIN = 0x800000, LENGTH = 0x190

Linking options

-lcf -script <file>

Use a linker command file (a file with suffix .lcf is also considered as

the LCF file)

-xlcf

Do not warn when using internal lcf (by default, in case no LCF file is

given, the linker issues a warning and uses a trivial LCF template)

-e -m -main <sym>

Set main entry point (this is the address execution will start from)

-L <dir>

Add <dir> to library search path

-l <file>

Link library lib<file>.<ext> or <file>

-open_libs

Consider all libs unconditionally

-d

Perform sections dead stripping

-[no]links_abs

Link all absolute ('.org') sections

-zerobbs

Expand and zero-initialize .bss data section

-T <mem=addr>

Set segment <mem> start address to <addr>

Debug options

-g

Keep debug information

-log <string>

Log link closure to file

-map

Generate link map file

-[no]check

Check objects compatibility (recommended)

-t -trace

Print name of input files upon processes

-y -trace_sym

Show all occurrences of symbol in objects

[no]check_segments

Check segments address overlapping

-mseg

Use segments names for output sections

Table 9.

Linker command line switches (continued)

Options

Switch

Description

AN3350 Datasheet(PDF) 77 Page - STMicroelectronics

AN3350 Datasheet(HTML) 77 Page - STMicroelectronics

Html Pages

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 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 ...More

Datasheet Download

Link URL