services/debugging/symtab.html · services/debugging/symtab.rst 공식 원문 ↗

Zephyr 3.7.0 · Debugging

Symbol Table

Function address를 name과 offset으로 바꿔 stack trace를 읽을 수 있게 합니다.

Official pathservices/debugging/symtab.html
Source fileservices/debugging/symtab.rst
Source versionZephyr 3.7.0
TranslationFull · reviewed

본문 기준: Zephyr 3.7.0 LTS3 · 이후 유지보수 패치는 별도입니다.

Part 1

요약·해설

ROM 비용과 symtab_get, symtab_find_symbol_name, CONFIG_SYMTAB을 설명합니다.

Generated

Link stage

Lookup

Name · Offset

Cost

ROM usage

Part 2

접을 수 있는 영어 원문 전체

영어 원문 전체 펼치기
원문 SHA-256 0C7F992795AE432B8FD91FB58C493D4C54889CA8AE388D8F04BE6094F082F933
.. _symtab:

Symbol Table (Symtab)
#####################

The Symtab module, when enabled, will generate full symbol table during the Zephyr linking
stage that keep tracks of the information about the functions' name and address, for advanced application
with a lot of functions, this is expected to consume a sizable amount of ROM.

Currently, this is being used to look up the function names during a stack trace in supported architectures.


Usage
*****

Application can gain access to the symbol table data structure by including the :file:`symtab.h` header
file and call :c:func:`symtab_get`. For now, we only provide :c:func:`symtab_find_symbol_name`
function to look-up the symbol name and offset of an address. More advanced functionalities and be
achieved by directly accessing the members of the data structure.

Configuration
*************

Configure this module using the following options.

* :kconfig:option:`CONFIG_SYMTAB`: enable the generation of the symbol table.

API documentation
*****************

.. doxygengroup:: symtab_apis

Part 3

한국어 전문 번역

Symtab module을 enable하면 Zephyr linking 단계에서 function name과 address를 추적하는 full symbol table을 생성합니다. Function이 많은 고급 application에서는 상당한 ROM을 소비할 수 있습니다.

현재 지원 architecture의 stack trace에서 function name을 찾는 데 사용됩니다.

사용법

Application은 symtab.h header를 include하고 symtab_get을 호출해 symbol table data structure에 접근할 수 있습니다. 현재는 address에 해당하는 symbol name과 offset을 찾는 symtab_find_symbol_name을 제공합니다. 더 고급 기능은 data structure member에 직접 접근해 구현할 수 있습니다.

설정

  • CONFIG_SYMTAB: symbol table 생성을 enable합니다.

API 문서

원문의 Doxygen group symtab_apis에 symbol table API가 수록됩니다.

Source

출처

영어 원문에는 문단, 문서 지시문, 표, 코드, 코드 심벌, 경로를 그대로 보존했습니다.