← Documents Documentation/tools/rtla/rtla-osnoise.rst GitHub 원문 ↗

Linux 6.18.37 · Kernel Tools

rtla-osnoise: operating-system noise 측정

RTLA osnoise의 periodic-summary top mode와 tracepoint 기반 hist mode를 선택하고 관련 manual로 이동하는 진입 문서입니다.

Source pathDocumentation/tools/rtla/rtla-osnoise.rst
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.

1. 요약·해설

원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.

요약·해설

rtla-osnoise.rst:1-59

RTLA osnoise의 periodic-summary top mode와 tracepoint 기반 hist mode를 선택하고 관련 manual로 이동하는 진입 문서입니다.

2. 영어 원문 전체

번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.

원문 전체 펼치기
1 ===============
2 rtla-osnoise
3 ===============
4 ------------------------------------------------------------------
5 Measure the operating system noise
6 ------------------------------------------------------------------
7
8 :Manual section: 1
9
10 SYNOPSIS
11 ========
12 **rtla osnoise** [*MODE*] ...
13
14 DESCRIPTION
15 ===========
16
17 .. include:: common_osnoise_description.txt
18
19 The *osnoise* tracer outputs information in two ways. It periodically prints
20 a summary of the noise of the operating system, including the counters of
21 the occurrence of the source of interference. It also provides information
22 for each noise via the **osnoise:** tracepoints. The **rtla osnoise top**
23 mode displays information about the periodic summary from the *osnoise* tracer.
24 The **rtla osnoise hist** mode displays information about the noise using
25 the **osnoise:** tracepoints. For further details, please refer to the
26 respective man page.
27
28 MODES
29 =====
30 **top**
31
32 Prints the summary from osnoise tracer.
33
34 **hist**
35
36 Prints a histogram of osnoise samples.
37
38 If no MODE is given, the top mode is called, passing the arguments.
39
40 OPTIONS
41 =======
42
43 **-h**, **--help**
44
45 Display the help text.
46
47 For other options, see the man page for the corresponding mode.
48
49 SEE ALSO
50 ========
51 **rtla-osnoise-top**\(1), **rtla-osnoise-hist**\(1)
52
53 Osnoise tracer documentation: <https://www.kernel.org/doc/html/latest/trace/osnoise-tracer.html>
54
55 AUTHOR
56 ======
57 Written by Daniel Bristot de Oliveira <bristot@kernel.org>
58
59 .. include:: common_appendix.txt
60

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를 참조한다.

osnoise 출력 분기
osnoise tracerPeriodic summaryrtla osnoise top
osnoise tracerosnoise: tracepointsrtla osnoise hist

같은 tracer data를 summary와 histogram으로 본다.

출력 방식
ModeData source용도
topperiodic summaryCPU별 총 noise와 원인 counter
histosnoise tracepointssample latency 분포

분석 목적에 맞는 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에서 확인해야 한다.

osnoise mode
Mode동작
toposnoise periodic summary 출력
histosnoise sample histogram 출력
omittedtop mode에 argument 전달

명시하지 않은 경우의 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를 포함한다.

다음 읽을거리
문서내용
rtla-osnoise-top(1)summary mode
rtla-osnoise-hist(1)histogram mode
osnoise tracer documentationkernel tracer internals

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 <bristot@kernel.org>

.. include:: common_appendix.txt