요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
.. |threshold| replace:: **-a/--auto**, **-s/--stop**, or **-S/--stop-total**
.. |thresharg| replace:: -s
.. |tracer| replace:: osnoise
.. |actionsperf| replace::
Due to implementational limitations, actions might be delayed
up to one second after tracing is stopped.
**-a**, **--auto** *us*
Set the automatic trace mode. This mode sets some commonly used options
while debugging the system. It is equivalent to use **-s** *us* **-T 1 -t**.
**-p**, **--period** *us*
Set the *osnoise* tracer period in microseconds.
**-r**, **--runtime** *us*
Set the *osnoise* tracer runtime in microseconds.
**-s**, **--stop** *us*
Stop the trace if a single sample is higher than the argument in microseconds.
If **-T** is set, it will also save the trace to the output.
**-S**, **--stop-total** *us*
Stop the trace if the total sample is higher than the argument in microseconds.
If **-T** is set, it will also save the trace to the output.
**-T**, **--threshold** *us*
Specify the minimum delta between two time reads to be considered noise.
The default threshold is *5 us*.
**-t**, **--trace** \[*file*]
Save the stopped trace to [*file|osnoise_trace.txt*].
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
공통 문서 placeholder
1-8공통 option 문서에서 `|threshold|`는 `-a/--auto`, `-s/--stop`, `-S/--stop-total`로, `|thresharg|`는 `-s`로, `|tracer|`는 `osnoise`로 치환된다.
구현 제약 때문에 tracing이 멈춘 뒤 action 실행이 최대 1초 늦어질 수 있다는 문구가 `|actionsperf|`에 들어간다.
공통 조각을 osnoise man page에 맞게 확장한다.
.. |threshold| replace:: **-a/--auto**, **-s/--stop**, or **-S/--stop-total**
.. |thresharg| replace:: -s
.. |tracer| replace:: osnoise
.. |actionsperf| replace::
Due to implementational limitations, actions might be delayed
up to one second after tracing is stopped.
Automatic mode, period와 runtime
9-21`-a` 또는 `--auto us`는 system debug에 자주 쓰는 option을 묶은 automatic trace mode를 설정하며 `-s us -T 1 -t`와 같다.
`-p` 또는 `--period us`는 osnoise tracer period를 microsecond 단위로, `-r` 또는 `--runtime us`는 tracer runtime을 microsecond 단위로 설정한다.
period 안에서 runtime을 수행하고 auto mode는 threshold와 trace를 함께 켠다.
**-a**, **--auto** *us*
Set the automatic trace mode. This mode sets some commonly used options
while debugging the system. It is equivalent to use **-s** *us* **-T 1 -t**.
**-p**, **--period** *us*
Set the *osnoise* tracer period in microseconds.
**-r**, **--runtime** *us*
Set the *osnoise* tracer runtime in microseconds.
Stop 조건, noise threshold와 trace 저장
22-39`-s` 또는 `--stop us`는 sample 하나가 지정 microsecond보다 크면 trace를 멈춘다. `-T`가 설정되어 있으면 trace도 output에 저장한다.
`-S` 또는 `--stop-total us`는 전체 sample이 지정 값보다 크면 trace를 멈추며 역시 `-T` 설정 시 trace를 저장한다.
`-T` 또는 `--threshold us`는 두 time read 사이 delta를 noise로 간주할 최소값을 정하며 기본은 5 us다. `-t` 또는 `--trace [file]`은 멈춘 trace를 지정 file에 저장하고 기본 file은 `osnoise_trace.txt`다.
단일 sample, total sample, noise 판정 기준을 구분한다.
**-s**, **--stop** *us*
Stop the trace if a single sample is higher than the argument in microseconds.
If **-T** is set, it will also save the trace to the output.
**-S**, **--stop-total** *us*
Stop the trace if the total sample is higher than the argument in microseconds.
If **-T** is set, it will also save the trace to the output.
**-T**, **--threshold** *us*
Specify the minimum delta between two time reads to be considered noise.
The default threshold is *5 us*.
**-t**, **--trace** \[*file*]
Save the stopped trace to [*file|osnoise_trace.txt*].
요약·해설
common_osnoise_options.txt:1-39osnoise의 automatic mode, period/runtime, single·total stop condition, noise threshold와 trace 저장 option을 설명합니다.