Modern Embedded Recipes · 26/152

링커 스크립트 기초 — SECTIONS·MEMORY·entry point

2026년 4월 12일 · Hawk · 3분 읽기

recipes toolchain linker

Twitter LinkedIn

#한 줄 요약

“링커 스크립트는 어떤 코드/데이터를 어떤 메모리 주소에 둘지 정합니다.” MEMORY로 chip의 메모리 영역을 선언하고, SECTIONS로 입력 섹션을 그 위에 매핑합니다.

#어떤 상황에서 쓰나

새 chip을 처음 지원할 때
TCM, CCM 같은 특수 영역을 활용
Bootloader와 app의 영역 분리
Symbol을 특정 주소에 배치(예: vector table)

#핵심 개념

#1) 가장 단순한 linker script

1
ENTRY(Reset_Handler)
2

3
MEMORY
4
{
5
    FLASH (rx) : ORIGIN = 0x08000000, LENGTH = 1024K
6
    RAM   (rw) : ORIGIN = 0x20000000, LENGTH = 128K
7
}
8

9
SECTIONS
10
{
11
    .text :
12
    {
13
        KEEP(*(.vector_table))
14
        *(.text*)
15
        *(.rodata*)
16
    } > FLASH
17

18
    .data :
19
    {
20
        *(.data*)
21
    } > RAM AT > FLASH
22

23
    .bss :
24
    {
25
        *(.bss*)
26
    } > RAM
27
}

이 작은 스크립트만으로 단순 펌웨어가 빌드됩니다.

#2) MEMORY 블록

각 메모리 영역의 속성과 범위를 선언합니다.

1
NAME (속성) : ORIGIN = 시작, LENGTH = 크기
2

3
속성:
4
   r — readable
5
   w — writable
6
   x — executable
7
   ! — invert

1
MEMORY
2
{
3
    BOOT    (rx)  : ORIGIN = 0x08000000, LENGTH = 32K
4
    APP     (rx)  : ORIGIN = 0x08008000, LENGTH = 992K
5
    SRAM    (rwx) : ORIGIN = 0x20000000, LENGTH = 128K
6
    CCM     (rwx) : ORIGIN = 0x10000000, LENGTH = 64K
7
    BACKUP  (rw)  : ORIGIN = 0x40024000, LENGTH = 4K
8
}

#3) SECTIONS — output section 정의

1
.section_name [start_addr] :
2
{
3
    pattern   ← 어떤 입력 섹션을 포함할지
4
    pattern
5
} > MEMORY_REGION

기본 패턴:

패턴	의미
`*(.text)`	모든 `.text` 입력
`(.text)`	`.text`, `.text.foo`, `.text.bar` 등 모두
`file.o(.data*)`	특정 file의 `.data*`
`KEEP(*(.x))`	GC 대상 제외 (`gc-sections`에서 보호)

#4) `>` (VMA)와 `AT >` (LMA)

VMA(Virtual Memory Address)는 runtime 주소, LMA(Load Memory Address)는 처음에 저장된 주소입니다. 보통 같지만 .data는 다릅니다.

1
.data :
2
{
3
    *(.data*)
4
} > RAM AT > FLASH

VMA = RAM (실행 시 위치)
LMA = FLASH (처음 저장 위치)

startup code가 LMA → VMA로 복사합니다. 다음 편에서 자세히 다룹니다.

#5) Symbol 정의 — `_etext`, `_sdata` 등

linker는 script 안에서 symbol을 만들 수 있습니다.

1
.data :
2
{
3
    _sdata = .;
4
    *(.data*)
5
    _edata = .;
6
} > RAM AT > FLASH
7

8
_sidata = LOADADDR(.data);   /* .data의 LMA */
9

10
.bss :
11
{
12
    _sbss = .;
13
    *(.bss*)
14
    *(COMMON)
15
    _ebss = .;
16
} > RAM

startup code가 이 symbol들로 영역 시작/끝을 압니다.

1
extern uint32_t _sdata, _edata, _sidata, _sbss, _ebss;
2

3
void copy_data(void) {
4
    uint32_t *src = &_sidata;
5
    uint32_t *dst = &_sdata;
6
    while (dst < &_edata) *dst++ = *src++;
7
}
8

9
void zero_bss(void) {
10
    for (uint32_t *p = &_sbss; p < &_ebss; p++) *p = 0;
11
}

#6) `ALIGN` — 정렬

1
.text :
2
{
3
    *(.text*)
4
    . = ALIGN(4);        /* 4-byte alignment */
5
    *(.rodata*)
6
} > FLASH

.(location counter)을 align 한 후 다음 데이터 배치. ARM은 32-bit access를 위해 4-byte alignment 권장.

#코드 / 실제 사용 예

STM32F4용 실제 linker script:

1
ENTRY(Reset_Handler)
2

3
MEMORY
4
{
5
    FLASH (rx)  : ORIGIN = 0x08000000, LENGTH = 1024K
6
    SRAM  (rwx) : ORIGIN = 0x20000000, LENGTH = 128K
7
}
8

9
_estack = ORIGIN(SRAM) + LENGTH(SRAM);   /* stack top */
10
_Min_Heap_Size  = 0x200;                  /* 512 byte */
11
_Min_Stack_Size = 0x400;                  /* 1 KB */
12

13
SECTIONS
14
{
15
    .isr_vector :
16
    {
17
        . = ALIGN(4);
18
        KEEP(*(.isr_vector))
19
        . = ALIGN(4);
20
    } > FLASH
21

22
    .text :
23
    {
24
        . = ALIGN(4);
25
        *(.text*)
26
        *(.glue_7)
27
        *(.glue_7t)
28
        KEEP (*(.init))
29
        KEEP (*(.fini))
30
        . = ALIGN(4);
31
        _etext = .;
32
    } > FLASH
33

34
    .rodata :
35
    {
36
        . = ALIGN(4);
37
        *(.rodata*)
38
        . = ALIGN(4);
39
    } > FLASH
40

41
    .data :
42
    {
43
        . = ALIGN(4);
44
        _sdata = .;
45
        *(.data*)
46
        . = ALIGN(4);
47
        _edata = .;
48
    } > SRAM AT > FLASH
49

50
    _sidata = LOADADDR(.data);
51

52
    .bss :
53
    {
54
        . = ALIGN(4);
55
        _sbss = .;
56
        *(.bss*)
57
        *(COMMON)
58
        . = ALIGN(4);
59
        _ebss = .;
60
    } > SRAM
61

62
    ._user_heap_stack :
63
    {
64
        . = ALIGN(8);
65
        PROVIDE(end = .);
66
        . = . + _Min_Heap_Size;
67
        . = . + _Min_Stack_Size;
68
        . = ALIGN(8);
69
    } > SRAM
70
}

빌드:

1
arm-none-eabi-gcc \
2
    -mcpu=cortex-m4 -mthumb \
3
    -T linker.ld \
4
    -Wl,-Map=app.map \
5
    main.c startup.s -o app.elf
6

7
arm-none-eabi-size app.elf

#측정 / 비교

일반 명령	효과
`> REGION`	output section을 region에 둠
`AT > REGION`	LMA를 다른 region에 둠
`. = ALIGN(N)`	location counter를 N-byte align
`KEEP(*(.x))`	gc-sections에서 보호
`PROVIDE(sym)`	정의되지 않은 경우만 정의
`LOADADDR(.section)`	section의 LMA 반환

명령 옵션	의미
`-T script.ld`	linker script 지정
`-Wl,-Map=file.map`	map 파일 출력
`-Wl,--gc-sections`	unused section 제거
`-ffunction-sections -fdata-sections`	function/data별 section (gc 위해)

#자주 보는 함정

⚠️ Vector table에 KEEP 빠짐

--gc-sections가 사용 안 보이는 vector table을 제거합니다. KEEP(*(.isr_vector))로 보호 필수.

⚠️ .bss를 LOAD 영역에 둠

.bss는 0으로 초기화되므로 flash에 데이터를 가질 필요 없습니다. AT 없이 > RAM만 쓰면 됩니다.

⚠️ Stack 영역 정의 누락

linker script에 stack을 명시 안 하면 heap과 stack이 같은 영역에서 자라 충돌. _estack = ORIGIN(SRAM) + LENGTH(SRAM)로 stack top 명시.

⚠️ Heap이 부족

malloc을 쓰는데 _Min_Heap_Size가 0이면 첫 호출에서 실패. newlib는 _sbrk가 heap을 확장.

⚠️ Section name이 input과 불일치

*(.text)는 정확히 .text만 잡고 .text.foo는 안 잡습니다. *(.text*)로 모든 변형 포함.

#정리

링커 스크립트는 MEMORY로 영역을 선언하고 SECTIONS로 입력을 매핑합니다.
> (VMA)와 AT > (LMA)로 runtime 위치와 저장 위치를 분리할 수 있습니다.
_sdata, _sbss 같은 symbol을 정의해 startup code가 활용합니다.
KEEP, ALIGN, PROVIDE 같은 명령으로 세밀한 제어가 가능합니다.
Vector table KEEP, stack symbol 정의가 기본 체크포인트입니다.

다음 편에서는 링커 스크립트 고급을 다룹니다. LMA vs VMA의 응용, overlay, custom section입니다.

#관련 항목

Modern Embedded Recipes · 27 of 152

링커 스크립트 고급 — Overlay·BSS·init_array·LMA/VMA

LMA vs VMA·KEEP·AT>·overlay·custom section.

2026년 4월 12일·recipes

Map 파일 분석 — Symbol·Section·Size 추적으로 코드 크기 진단

메모리 사용·심볼 위치·dead code 추적.

2026년 4월 12일·recipes

임베디드 컴파일러 최적화 분석 — -O0~-O3·-Os·-LTO 비교

-O0/-O1/-O2/-O3/-Os/-Og — 옵션별 차이와 디버깅 가능성.

2026년 4월 12일·recipes

링커 스크립트 기초 — SECTIONS·MEMORY·entry point

#한 줄 요약

#어떤 상황에서 쓰나

#핵심 개념

#1) 가장 단순한 linker script

#2) MEMORY 블록

#3) SECTIONS — output section 정의

#4) `>` (VMA)와 `AT >` (LMA)

#5) Symbol 정의 — `_etext`, `_sdata` 등

#6) `ALIGN` — 정렬

#코드 / 실제 사용 예

#측정 / 비교

#자주 보는 함정

#정리

#관련 항목

Modern Embedded Recipes · 27 of 152

관련 글

링커 스크립트 고급 — Overlay·BSS·init_array·LMA/VMA

Map 파일 분석 — Symbol·Section·Size 추적으로 코드 크기 진단

임베디드 컴파일러 최적화 분석 — -O0~-O3·-Os·-LTO 비교

이 글을 참조하는 글 (7)

#한 줄 요약

#어떤 상황에서 쓰나

#핵심 개념

#1) 가장 단순한 linker script

#2) MEMORY 블록

#3) SECTIONS — output section 정의

#4) > (VMA)와 AT > (LMA)

#5) Symbol 정의 — _etext, _sdata 등

#6) ALIGN — 정렬

#코드 / 실제 사용 예

#측정 / 비교

#자주 보는 함정

#정리

#관련 항목

Modern Embedded Recipes · 27 of 152

관련 글

링커 스크립트 고급 — Overlay·BSS·init_array·LMA/VMA

Map 파일 분석 — Symbol·Section·Size 추적으로 코드 크기 진단

임베디드 컴파일러 최적화 분석 — -O0~-O3·-Os·-LTO 비교

이 글을 참조하는 글 (7)

#4) `>` (VMA)와 `AT >` (LMA)

#5) Symbol 정의 — `_etext`, `_sdata` 등

#6) `ALIGN` — 정렬