rtla-timerlat: 운영체제 타이머 지연 측정

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

1. 요약·해설

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

요약·해설

rtla-timerlat.rst:1-54

RTLA timerlat의 top·hist 모드와 기본 top 선택 동작을 설명하는 명령 진입 문서입니다.

2. 영어 원문 전체

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

원문 전체 펼치기

1 ================

2 rtla-timerlat

3 ================

4 -------------------------------------------

5 Measures the operating system timer latency

6 -------------------------------------------

8 :Manual section: 1

10 SYNOPSIS

11 ========

12 **rtla timerlat** [*MODE*] ...

14 DESCRIPTION

15 ===========

17 .. include:: common_timerlat_description.txt

19 The **rtla timerlat top** mode displays a summary of the periodic output

20 from the *timerlat* tracer. The **rtla timerlat hist** mode displays

21 a histogram of each tracer event occurrence. For further details, please

22 refer to the respective man page.

24 MODES

25 =====

26 **top**

28 Prints the summary from *timerlat* tracer.

30 **hist**

32 Prints a histogram of timerlat samples.

34 If no *MODE* is given, the top mode is called, passing the arguments.

36 OPTIONS

37 =======

38 **-h**, **--help**

40 Display the help text.

42 For other options, see the man page for the corresponding mode.

44 SEE ALSO

45 ========

46 **rtla-timerlat-top**\(1), **rtla-timerlat-hist**\(1)

48 *timerlat* tracer documentation: <https://www.kernel.org/doc/html/latest/trace/timerlat-tracer.html>

50 AUTHOR

51 ======

52 Written by Daniel Bristot de Oliveira <bristot@kernel.org>

54 .. include:: common_appendix.txt

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.

timerlat 명령과 두 출력 모드

1-23

`rtla timerlat [MODE] ...`는 운영체제 타이머 지연을 측정하는 매뉴얼 섹션 1 명령이다. 공통 설명은 `common_timerlat_description.txt`에서 제공한다.

`top` 모드는 timerlat 추적기의 주기 출력을 CPU별 요약으로 표시하고, `hist` 모드는 각 추적 이벤트의 발생 횟수를 지연 히스토그램으로 표시한다. 세부 옵션과 출력 해석은 각 모드의 매뉴얼을 참조한다.

timerlat 모드 선택

rtla timerlattopPeriodic CPU summary

rtla timerlathistIRQ / thread histogram

같은 timerlat 표본을 현재 요약 또는 분포로 본다.

모드별 관점

Mode출력주요 용도

top현재·최소·평균·최대 지연임계값 초과와 자동 원인 분석

histCPU별 IRQ·스레드 지연 분포일반 구간과 꼬리 지연 비교

분석 목적에 따라 출력 형식을 고른다.

================
rtla-timerlat
================
-------------------------------------------
Measures the operating system timer latency
-------------------------------------------

:Manual section: 1

SYNOPSIS
========
**rtla timerlat** [*MODE*] ...

DESCRIPTION
===========

.. include:: common_timerlat_description.txt

The **rtla timerlat top** mode displays a summary of the periodic output
from the *timerlat* tracer. The **rtla timerlat hist** mode displays
a histogram of each tracer event occurrence. For further details, please
refer to the respective man page.

top·hist와 기본 동작

24-42

`top`은 timerlat 추적기의 요약을 출력하고 `hist`는 timerlat 표본의 히스토그램을 출력한다. `MODE`를 생략하면 입력 인수를 그대로 전달하여 `top` 모드를 호출한다.

`-h` 또는 `--help`는 도움말을 표시한다. 그 밖의 옵션은 선택한 모드의 매뉴얼 페이지에서 확인해야 한다.

timerlat 명령 선택

입력동작

toptimerlat 주기 요약 출력

histtimerlat 표본 히스토그램 출력

MODE 생략인수를 전달하여 top 실행

-h / --help도움말 표시

명시하지 않은 경우의 기본값까지 포함한다.

MODES
=====
**top**

        Prints the summary from *timerlat* tracer.

**hist**

        Prints a histogram of timerlat 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.

1. 요약·해설

요약·해설

2. 영어 원문 전체

3. 한국어 전문 번역

timerlat 명령과 두 출력 모드

top·hist와 기본 동작

관련 매뉴얼과 작성 정보