요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
===============
rtla-osnoise
===============
------------------------------------------------------------------
Measure the operating system noise
------------------------------------------------------------------
:Manual section: 1
SYNOPSIS
========
**rtla osnoise** [*MODE*] ...
DESCRIPTION
===========
.. include:: common_osnoise_description.txt
The *osnoise* tracer outputs information in two ways. It periodically prints
a summary of the noise of the operating system, including the counters of
the occurrence of the source of interference. It also provides information
for each noise via the **osnoise:** tracepoints. The **rtla osnoise top**
mode displays information about the periodic summary from the *osnoise* tracer.
The **rtla osnoise hist** mode displays information about the noise using
the **osnoise:** tracepoints. For further details, please refer to the
respective man page.
MODES
=====
**top**
Prints the summary from osnoise tracer.
**hist**
Prints a histogram of osnoise samples.
If no MODE is given, the top mode is called, passing the arguments.
OPTIONS
=======
**-h**, **--help**
Display the help text.
For other options, see the man page for the corresponding mode.
SEE ALSO
========
**rtla-osnoise-top**\(1), **rtla-osnoise-hist**\(1)
Osnoise tracer documentation: <https://www.kernel.org/doc/html/latest/trace/osnoise-tracer.html>
AUTHOR
======
Written by Daniel Bristot de Oliveira <[email protected]>
.. include:: common_appendix.txt
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Summary와 tracepoint의 두 출력
1-27`rtla osnoise [MODE] ...`는 operating-system noise를 측정하는 manual section 1 command다. 공통 설명에 따라 per-CPU kernel thread가 time-read delta와 interference counter를 기록한다.
`osnoise` tracer는 두 방식으로 정보를 낸다. 첫째, operating-system noise와 interference source 발생 counter를 포함하는 periodic summary를 출력한다. 둘째, 각 noise event 정보를 `osnoise:` tracepoint로 제공한다.
`rtla osnoise top`은 periodic summary를 표시하고 `rtla osnoise hist`는 `osnoise:` tracepoint를 이용해 noise 분포를 표시한다. 세부 option과 출력은 각 mode의 manual page를 참조한다.
같은 tracer data를 summary와 histogram으로 본다.
분석 목적에 맞는 mode를 고른다.
===============
rtla-osnoise
===============
------------------------------------------------------------------
Measure the operating system noise
------------------------------------------------------------------
:Manual section: 1
SYNOPSIS
========
**rtla osnoise** [*MODE*] ...
DESCRIPTION
===========
.. include:: common_osnoise_description.txt
The *osnoise* tracer outputs information in two ways. It periodically prints
a summary of the noise of the operating system, including the counters of
the occurrence of the source of interference. It also provides information
for each noise via the **osnoise:** tracepoints. The **rtla osnoise top**
mode displays information about the periodic summary from the *osnoise* tracer.
The **rtla osnoise hist** mode displays information about the noise using
the **osnoise:** tracepoints. For further details, please refer to the
respective man page.
top·hist mode와 help
28-47`top` mode는 osnoise tracer summary를 출력하고 `hist` mode는 osnoise sample histogram을 출력한다. MODE를 생략하면 argument를 그대로 넘겨 `top` mode를 호출한다.
`-h` 또는 `--help`는 help text를 표시한다. 그 밖의 option은 선택한 mode의 manual page에서 확인해야 한다.
명시하지 않은 경우의 default도 포함한다.
MODES
=====
**top**
Prints the summary from osnoise tracer.
**hist**
Prints a histogram of osnoise samples.
If no MODE is given, the top mode is called, passing the arguments.
OPTIONS
=======
**-h**, **--help**
Display the help text.
For other options, see the man page for the corresponding mode.관련 manual과 작성자
48-59관련 manual page는 `rtla-osnoise-top(1)`과 `rtla-osnoise-hist(1)`이다. kernel osnoise tracer documentation에서 tracer 자체의 상세 동작을 확인할 수 있다.
문서는 Daniel Bristot de Oliveira가 작성했으며 마지막에 RTLA 공통 appendix를 포함한다.
command 개요에서 mode별 세부 문서로 이동한다.
SEE ALSO
========
**rtla-osnoise-top**\(1), **rtla-osnoise-hist**\(1)
Osnoise tracer documentation: <https://www.kernel.org/doc/html/latest/trace/osnoise-tracer.html>
AUTHOR
======
Written by Daniel Bristot de Oliveira <[email protected]>
.. include:: common_appendix.txt
요약·해설
rtla-osnoise.rst:1-59RTLA osnoise의 periodic-summary top mode와 tracepoint 기반 hist mode를 선택하고 관련 manual로 이동하는 진입 문서입니다.