From f211589db1a7d49b52bbca9b6583cffea3b70cb4 Mon Sep 17 00:00:00 2001 From: Sungho Park Date: Wed, 26 Jul 2023 08:18:29 +0000 Subject: [PATCH] doc/ko: Update uftrace-tui.md in Korean Retranslate the latest uftrace-tui.md and little ammend Signed-off-by: Sungho Park --- doc/ko/uftrace-tui.md | 36 +++++++++++++++++++++++------------- 1 file changed, 23 insertions(+), 13 deletions(-) diff --git a/doc/ko/uftrace-tui.md b/doc/ko/uftrace-tui.md index ef5415c41..29c0b88f9 100644 --- a/doc/ko/uftrace-tui.md +++ b/doc/ko/uftrace-tui.md @@ -46,12 +46,12 @@ TUI 옵션 참고한다. -N *FUNC*, \--notrace=*FUNC* -: 선택된 함수들 (또는 그 아래 함수들)을 출력에서 제외하도록 설정하는 옵션이다. +: 선택된 함수들 (그리고 그 아래 함수들)을 출력에서 제외하도록 설정하는 옵션이다. 이 옵션은 한번 이상 쓰일 수 있다. 필터에 대한 설명은 `uftrace-replay`(1) 를 참고한다. -C *FUNC*, \--caller-filter=*FUNC* -: 선택된 함수의 호출자를 출력하는 필터를 설정한다. 이 옵션은 한번 이상 쓰일 수 있다. +: 선택된 함수의 호출자만 출력하는 필터를 설정한다. 이 옵션은 한번 이상 쓰일 수 있다. 필터에 대한 설명은 `uftrace-replay`(1) 를 참고한다. -T *TRG*, \--trigger=*TRG* @@ -66,13 +66,15 @@ TUI 옵션 : 설정한 시간 이하로 수행된 함수는 표시하지 않게 한다. 만약 어떤 함수가 명시적으로 'trace' 트리거가 적용된 경우, 그 함수는 실행 시간과 상관없이 항상 출력된다. - -Z *SIZE*, \--size-filter=*SIZE* : SIZE 바이트보다 작은 함수들을 표시하지 않게 한다. 만약 어떤 함수가 명시적으로 'trace' 트리거가 적용된 경우, 그 함수는 함수 크기와 상관없이 항상 출력된다. +-L *LOCATION*, \ --loc-filter=*LOCATION* +: 선택된 소스위치를 출력하도록한다. 이옵션은 한번 이상 쓰일 수 있다. *FILTERS*를 참고하라. + \--no-libcall -: 라이브러리 호출은 표시하지 않게 한다. +: 라이브러리 호출은 표시하지 않게 한다. \--no-event : 이벤트들을 표시하지 않게 한다. `--no-sched` 옵션을 내포한다. @@ -85,16 +87,24 @@ TUI 옵션 일반(대기) 스케쥴 이벤트는 그대로 표시한다. \--match=*TYPE* -: 타입(TYPE)으로 일치하는 패턴을 보여준다. 가능한 형태는 `regex`와 `glob`이다. +: *TYPE* 과 일치하는 패턴을 출력한다. 가능한 형태는 `regex`와 `glob`이다. 기본 설정은 `regex`이다. +\--with-syms=*DIR* +: 바이너리 데이터 대신 *DIR*경로 속 .sym파일에서 심볼데이터를 가져온다. +이 기능은 컴파일 후 디버깅정보가 소실된 바이너리 데이터(stripped binary) 처리에 유용할 것이다. +메인 바이너리 데이터는 저장시와 사용시에 파일명이 일치해야한다. + + + + 공통 분석 옵션 ======================= -H *FUNC*, \--hide=*FUNC* : 주어진 FUNC 함수들을 출력 대상에서 제외할 수 있다. 이는 선택된 함수의 자식 함수들에 대해서는 영향을 주지 않으며 단지 주어진 함수들만 숨기는 기능을 하게 - 된다. 이 옵션은 한번 이상 쓰일 수 있다. + 된다. 이 옵션은 한번 이상 쓰일 수 있다.필터에 대한 설명은 `uftrace-replay`(1) 를 참고한다. \--kernel-full : 사용자 함수 밖에서 호출된 모든 커널 함수를 출력한다. @@ -118,19 +128,19 @@ TUI 옵션 -r *RANGE*, \--time-range=*RANGE* : 시간 범위 RANGE 내에 실행된 함수들만 출력한다. RANGE 는 \<시작\>~\<끝\> ("~"로 구분) 이고 \<시작\>과 \<끝\> 중 하나는 생략할 수 있다. \<시작\>과 - \<끝\>은 타임스탬프 또는 '100us'와 같은 \<시간단위\>가 있는 경과시간이다. + \<끝\>은 타임스탬프 또는 '100us'처럼 \<시간단위\>접미사가 붙은 경과시간이다. `uftrace replay`(1) 에서 `-f time` 또는 `-f elapsed` 를 이용해 타임스탬프 또는 경과시간을 확인할 수 있다. OUTLINE ======= -일반적인 경우 전체적으로 하나의 세션만 있다면 그래프 모드로 시작해서 세션의 -전체 함수 호출 그래프를 보여준다. 이후에 사용자 키들을 사용해서 다른 모드로 +전체적으로 하나의 세션만 있는 일반적인 경우 그래프 모드로 시작해서 세션의 +전체 함수 호출 그래프를 보여준다. 이후에 특정한 키들을 눌러 다른 모드로 변경할 수 있으며 'h' 키를 사용해 도움말을 확인해 볼 수 있다. -현재 라인은 '>' 와 함께 반전된 색상으로 보여지며 화살표 키를 사용해 다른 위치로 -이동할 수 있다. +현재 라인은 (아래 그림에서 '>'로 표시된 라인) 반전된 색상으로 보여지며 +화살표 키를 사용해 다른 위치로 이동할 수 있다. TOTAL TIME : FUNCTION > 7.548 us : (1) t-abc @@ -179,10 +189,10 @@ TUI 창에서 다음과 같은 키들을 사용할 수 있음: * `O`: 현재 함수에 대한 편집기 열기 * `c`/`e`: 직접 자식 그래프 노드 축소/확장 * `C`/`E`: 모든 자식들의 그래프 노드 축소/확장 - * `n`/`p`: 같은 높이의 다음/이전 항목으로 이동 (그래프 모드에서) + * `n`/`p`: 같은 계층의 다음/이전 항목으로 이동 (그래프 모드에서) * `u`: 부모 노드로 이동 (그래프 모드에서) * `l`: 가장 긴 실행 시간을 갖는 자식 노드로 이동 (그래프 모드에서) - * `j`/`k`: 커서를 위/아래로 움직임 (vi 기능과 같이) + * `j`/`k`: 커서를 위/아래로 움직임 (vi 에디터의 기능과 같음) * `z`: 현재 위치를 화면 중앙에 정렬 * `/`: 탐색 시작 * `<`/`P`: 이전 일치 검색