요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
.. |tool| replace:: osnoise top
===================
rtla-osnoise-top
===================
-----------------------------------------------
Display a summary of the operating system noise
-----------------------------------------------
:Manual section: 1
SYNOPSIS
========
**rtla osnoise top** [*OPTIONS*]
DESCRIPTION
===========
.. include:: common_osnoise_description.txt
**rtla osnoise top** collects the periodic summary from the *osnoise* tracer,
including the counters of the occurrence of the interference source,
displaying the results in a user-friendly format.
The tool also allows many configurations of the *osnoise* tracer and the
collection of the tracer output.
OPTIONS
=======
.. include:: common_osnoise_options.txt
.. include:: common_top_options.txt
.. include:: common_options.txt
EXAMPLE
=======
In the example below, the **rtla osnoise top** tool is set to run with a
real-time priority *FIFO:1*, on CPUs *0-3*, for *900ms* at each period
(*1s* by default). The reason for reducing the runtime is to avoid starving
the rtla tool. The tool is also set to run for *one minute* and to display
a summary of the report at the end of the session::
[root@f34 ~]# rtla osnoise top -P F:1 -c 0-3 -r 900000 -d 1M -q
Operating System Noise
duration: 0 00:01:00 | time is in us
CPU Period Runtime Noise % CPU Aval Max Noise Max Single HW NMI IRQ Softirq Thread
0 #59 53100000 304896 99.42580 6978 56 549 0 53111 1590 13
1 #59 53100000 338339 99.36282 8092 24 399 0 53130 1448 31
2 #59 53100000 290842 99.45227 6582 39 855 0 53110 1406 12
3 #59 53100000 204935 99.61405 6251 33 290 0 53156 1460 12
SEE ALSO
========
**rtla-osnoise**\(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 <bristot@kernel.org>
.. include:: common_appendix.txt
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Periodic summary와 interference counter
1-34`rtla osnoise top [OPTIONS]`는 `osnoise` tracer의 periodic summary와 interference source 발생 counter를 수집해 읽기 쉬운 형식으로 표시한다.
tool은 tracer 설정과 tracer output 수집도 지원한다. per-CPU sampling 설명, osnoise 전용 option, quiet top option, RTLA 공통 option 문서를 포함한다.
summary view에 포함되는 공통 정의다.
period마다 noise 총량과 원인 counter를 집계한다.
.. |tool| replace:: osnoise top
===================
rtla-osnoise-top
===================
-----------------------------------------------
Display a summary of the operating system noise
-----------------------------------------------
:Manual section: 1
SYNOPSIS
========
**rtla osnoise top** [*OPTIONS*]
DESCRIPTION
===========
.. include:: common_osnoise_description.txt
**rtla osnoise top** collects the periodic summary from the *osnoise* tracer,
including the counters of the occurrence of the interference source,
displaying the results in a user-friendly format.
The tool also allows many configurations of the *osnoise* tracer and the
collection of the tracer output.
OPTIONS
=======
.. include:: common_osnoise_options.txt
.. include:: common_top_options.txt
.. include:: common_options.txt
FIFO:1, CPU 0-3의 1분 summary
35-51예제는 CPU 0-3에서 osnoise thread를 realtime priority FIFO:1로 실행한다. 기본 1초 period마다 runtime을 900 ms로 줄여 RTLA tool starvation을 피하고, 1분 동안 측정한 뒤 마지막 summary만 출력한다.
command는 `rtla osnoise top -P F:1 -c 0-3 -r 900000 -d 1M -q`다. 각 CPU는 59 period와 53,100,000 us runtime을 기록하며 noise 합은 204,935-338,339 us, CPU availability는 99.36-99.61%다.
`Max Noise`는 period 하나의 noise 최대 합, `Max Single`은 단일 event의 최대값이다. `HW`, `NMI`, `IRQ`, `Softirq`, `Thread`는 각 interference source의 발생 횟수다. 예제에서는 일반 IRQ가 약 53,100회로 지배적이고 Softirq, hardware event, thread interference가 뒤따르며 NMI는 0이다.
시간 합계와 원인별 횟수를 함께 보여 준다.
EXAMPLE
=======
In the example below, the **rtla osnoise top** tool is set to run with a
real-time priority *FIFO:1*, on CPUs *0-3*, for *900ms* at each period
(*1s* by default). The reason for reducing the runtime is to avoid starving
the rtla tool. The tool is also set to run for *one minute* and to display
a summary of the report at the end of the session::
[root@f34 ~]# rtla osnoise top -P F:1 -c 0-3 -r 900000 -d 1M -q
Operating System Noise
duration: 0 00:01:00 | time is in us
CPU Period Runtime Noise % CPU Aval Max Noise Max Single HW NMI IRQ Softirq Thread
0 #59 53100000 304896 99.42580 6978 56 549 0 53111 1590 13
1 #59 53100000 338339 99.36282 8092 24 399 0 53130 1448 31
2 #59 53100000 290842 99.45227 6582 39 855 0 53110 1406 12
3 #59 53100000 204935 99.61405 6251 33 290 0 53156 1460 12
관련 mode와 작성자
52-63관련 manual page는 `rtla-osnoise(1)`과 `rtla-osnoise-hist(1)`이며 tracer 세부 사항은 kernel osnoise tracer documentation에 있다.
문서는 Daniel Bristot de Oliveira가 작성했고 마지막에 RTLA 공통 appendix를 포함한다.
같은 tracer의 두 표현 방식이다.
SEE ALSO
========
**rtla-osnoise**\(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 <bristot@kernel.org>
.. include:: common_appendix.txt
요약·해설
rtla-osnoise-top.rst:1-63osnoise periodic summary에서 noise 시간, CPU availability와 HW·NMI·IRQ·Softirq·Thread interference counter를 읽는 방법을 설명합니다.