요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
================================
Linux Tracing Technologies Guide
================================
Tracing in the Linux kernel is a powerful mechanism that allows
developers and system administrators to analyze and debug system
behavior. This guide provides documentation on various tracing
frameworks and tools available in the Linux kernel.
Introduction to Tracing
-----------------------
This section provides an overview of Linux tracing mechanisms
and debugging approaches.
.. toctree::
:maxdepth: 1
debugging
tracepoints
tracepoint-analysis
ring-buffer-map
Core Tracing Frameworks
-----------------------
The following are the primary tracing frameworks integrated into
the Linux kernel.
.. toctree::
:maxdepth: 1
ftrace
ftrace-design
ftrace-uses
kprobes
kprobetrace
fprobetrace
eprobetrace
fprobe
ring-buffer-design
Event Tracing and Analysis
--------------------------
A detailed explanation of event tracing mechanisms and their
applications.
.. toctree::
:maxdepth: 1
events
events-kmem
events-power
events-nmi
events-msr
events-pci
boottime-trace
histogram
histogram-design
Hardware and Performance Tracing
--------------------------------
This section covers tracing features that monitor hardware
interactions and system performance.
.. toctree::
:maxdepth: 1
intel_th
stm
sys-t
coresight/index
rv/index
hisi-ptt
mmiotrace
hwlat_detector
osnoise-tracer
timerlat-tracer
User-Space Tracing
------------------
These tools allow tracing user-space applications and
interactions.
.. toctree::
:maxdepth: 1
user_events
uprobetracer
Additional Resources
--------------------
For more details, refer to the respective documentation of each
tracing tool and framework.
.. only:: subproject and html
Indices
=======
* :ref:`genindex`
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Linux tracing guide 소개
1-23Linux kernel tracing은 developer와 system administrator가 system 동작을 분석하고 debug할 수 있게 하는 강력한 mechanism이다. 이 guide는 kernel에서 사용할 수 있는 여러 tracing framework와 tool의 문서를 한곳에 모은다.
첫 절은 Linux tracing mechanism과 debugging 접근법의 개요를 제공하며 `debugging`, `tracepoints`, `tracepoint-analysis`, `ring-buffer-map` 문서로 연결된다.
.. toctree::
:maxdepth: 1
debugging
tracepoints
tracepoint-analysis
ring-buffer-map
================================
Linux Tracing Technologies Guide
================================
Tracing in the Linux kernel is a powerful mechanism that allows
developers and system administrators to analyze and debug system
behavior. This guide provides documentation on various tracing
frameworks and tools available in the Linux kernel.
Introduction to Tracing
-----------------------
This section provides an overview of Linux tracing mechanisms
and debugging approaches.
.. toctree::
:maxdepth: 1
debugging
tracepoints
tracepoint-analysis
ring-buffer-map
Core tracing framework
24-42Kernel에 통합된 주요 tracing framework로 ftrace의 사용·설계 문서, kprobe와 동적 probe event, fprobe·eprobe, ring buffer 설계 문서를 안내한다.
.. toctree::
:maxdepth: 1
ftrace
ftrace-design
ftrace-uses
kprobes
kprobetrace
fprobetrace
eprobetrace
fprobe
ring-buffer-design
Core Tracing Frameworks
-----------------------
The following are the primary tracing frameworks integrated into
the Linux kernel.
.. toctree::
:maxdepth: 1
ftrace
ftrace-design
ftrace-uses
kprobes
kprobetrace
fprobetrace
eprobetrace
fprobe
ring-buffer-design
Event tracing과 분석
43-61Event tracing mechanism과 활용을 설명하는 문서군이다. 일반 event interface, kmem·power·NMI·MSR·PCI event, boot-time tracing, histogram과 그 내부 설계를 포함한다.
.. toctree::
:maxdepth: 1
events
events-kmem
events-power
events-nmi
events-msr
events-pci
boottime-trace
histogram
histogram-design
Event Tracing and Analysis
--------------------------
A detailed explanation of event tracing mechanisms and their
applications.
.. toctree::
:maxdepth: 1
events
events-kmem
events-power
events-nmi
events-msr
events-pci
boottime-trace
histogram
histogram-design
Hardware와 performance tracing
62-81Hardware interaction과 system performance를 관찰하는 Intel Trace Hub, STM/System Trace, CoreSight, Runtime Verification, HiSilicon PTT, MMIO, hardware latency, OS noise와 timer latency tracer 문서를 묶는다.
.. toctree::
:maxdepth: 1
intel_th
stm
sys-t
coresight/index
rv/index
hisi-ptt
mmiotrace
hwlat_detector
osnoise-tracer
timerlat-tracer
문서 index가 tracing 목적에 따라 framework를 분류한다.
Hardware and Performance Tracing
--------------------------------
This section covers tracing features that monitor hardware
interactions and system performance.
.. toctree::
:maxdepth: 1
intel_th
stm
sys-t
coresight/index
rv/index
hisi-ptt
mmiotrace
hwlat_detector
osnoise-tracer
timerlat-tracer
User-space tracing
82-93사용자 공간 application과 kernel 사이의 interaction을 추적하는 `user_events`와 `uprobetracer` 문서를 제공한다.
.. toctree::
:maxdepth: 1
user_events
uprobetracer
User-Space Tracing
------------------
These tools allow tracing user-space applications and
interactions.
.. toctree::
:maxdepth: 1
user_events
uprobetracer
추가 자료와 index
94-105각 tracing tool과 framework의 세부 사항은 해당 문서를 참조한다. HTML subproject build에서는 일반 index도 함께 제공한다.
.. only:: subproject and html
Indices
=======
* :ref:`genindex`Additional Resources
--------------------
For more details, refer to the respective documentation of each
tracing tool and framework.
.. only:: subproject and html
Indices
=======
* :ref:`genindex`
요약·해설
index.rst:1-105Linux tracing 문서를 core framework, event 분석, hardware·performance tracing, user-space tracing 영역으로 나눠 안내합니다.