요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
.. SPDX-License-Identifier: GPL-2.0
==========================================================
Trace performance monitoring and diagnostics monitor(TPDM)
==========================================================
:Author: Jinlong Mao <quic_jinlmao@quicinc.com>
:Date: January 2023
Hardware Description
--------------------
TPDM - The trace performance monitoring and diagnostics monitor or TPDM in
short serves as data collection component for various dataset types.
The primary use case of the TPDM is to collect data from different data
sources and send it to a TPDA for packetization, timestamping and funneling.
Sysfs files and directories
---------------------------
Root: ``/sys/bus/coresight/devices/tpdm<N>``
----
:File: ``enable_source`` (RW)
:Notes:
- > 0 : enable the datasets of TPDM.
- = 0 : disable the datasets of TPDM.
:Syntax:
``echo 1 > enable_source``
----
:File: ``integration_test`` (wo)
:Notes:
Integration test will generate test data for tpdm.
:Syntax:
``echo value > integration_test``
value - 1 or 2.
----
.. This text is intentionally added to make Sphinx happy.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
여러 dataset을 수집하는 trace source
1-20이 문서는 Jinlong Mao가 2023년 1월에 작성했다. TPDM은 Trace Performance Monitoring and Diagnostics Monitor의 약자이며 여러 dataset type을 위한 data collection component다.
TPDM의 주된 용도는 서로 다른 data source에서 정보를 모아 TPDA로 보내는 것이다. TPDA는 받은 data를 packetization하고 timestamp를 붙이며 funneling한다.
TPDM sysfs root는 `/sys/bus/coresight/devices/tpdm<N>`이다.
monitor가 dataset을 수집하고 aggregator가 transport 형식으로 만든다.
수집과 stream 가공 책임을 분리한다.
.. SPDX-License-Identifier: GPL-2.0
==========================================================
Trace performance monitoring and diagnostics monitor(TPDM)
==========================================================
:Author: Jinlong Mao <quic_jinlmao@quicinc.com>
:Date: January 2023
Hardware Description
--------------------
TPDM - The trace performance monitoring and diagnostics monitor or TPDM in
short serves as data collection component for various dataset types.
The primary use case of the TPDM is to collect data from different data
sources and send it to a TPDA for packetization, timestamping and funneling.
Sysfs files and directories
---------------------------
Root: ``/sys/bus/coresight/devices/tpdm<N>``
enable_source와 integration_test
21-45`enable_source`는 read/write file이다. 0보다 큰 값을 쓰면 TPDM dataset을 enable하고 0을 쓰면 disable한다. enable 구문은 `echo 1 > enable_source`다.
`integration_test`는 write-only file이며 TPDM 검증용 test data를 생성한다. `echo value > integration_test` 형식이고 허용 값은 1 또는 2다.
문서 마지막의 주석은 Sphinx 처리를 만족시키기 위해 의도적으로 추가된 text임을 명시한다.
dataset source 제어와 test pattern 생성을 제공한다.
source enable 후 두 integration value로 test data를 만든다.
----
:File: ``enable_source`` (RW)
:Notes:
- > 0 : enable the datasets of TPDM.
- = 0 : disable the datasets of TPDM.
:Syntax:
``echo 1 > enable_source``
----
:File: ``integration_test`` (wo)
:Notes:
Integration test will generate test data for tpdm.
:Syntax:
``echo value > integration_test``
value - 1 or 2.
----
.. This text is intentionally added to make Sphinx happy.
요약·해설
coresight-tpdm.rst:1-45TPDM이 여러 dataset을 수집해 TPDA로 전달하는 역할과 enable_source·integration_test sysfs 제어를 설명합니다.