diff --git a/doc/ko/uftrace-tui.md b/doc/ko/uftrace-tui.md index 838ae7d53..1dfba6be4 100644 --- a/doc/ko/uftrace-tui.md +++ b/doc/ko/uftrace-tui.md @@ -25,12 +25,13 @@ TUI 옵션 : 출력 필드를 사용자 지정으로 설정한다. 이 옵션은 기본적으로 graph 필드를 나타낸다. 설정 가능한 값은 total, self, addr 이고, 기본 설정값은 `total`이다. 그런데 이 옵션이 --report 옵션과 함께 사용된다면, 이 옵션은 report 필드를 나타낸다. - 설정 가능한 값은 total, total-avg, total-min, total-max, self, self-avg, self-min, + 설정 가능한 값은 total, total-avg, total-min, total-max, total-stdv, self, self-avg, self-min, self-max, call, size 이고, 기본 설정값은 'total,self,call'이다. 쉼표를 사용하여 여러 필드를 설정할 수 있고, 주어진 필드 이름이 "+"로 시작할 경우, 기본 설정값에 추가하는 방식으로 필드를 설정할 수 있다. 'none' 과 같은 특수 필드를 사용하면 모든 필드를 숨길 수 있다. 필드에 대한 설명은 `uftrace-graph`(1) 또는 `uftrace-report`(1)를 참고한다. + "total-stdv"와 "self-stdv"의 "stdv"는 상대표준편차(RSD)를 의미하며, 함수가 여러 번 호출된 경우에만 값을 포함한다. -s *KEYS*[,*KEYS*,...], --sort=*KEYS*[,*KEYS*,...] : 주어진 키를 기반으로 함수들을 정렬한다. @@ -46,12 +47,12 @@ TUI 옵션 참고한다. -N *FUNC*, \--notrace=*FUNC* -: 선택된 함수들 (또는 그 아래 함수들)을 출력에서 제외하도록 설정하는 옵션이다. +: 선택된 함수들 (그리고 그 아래 함수들)을 출력에서 제외하도록 설정하는 옵션이다. 이 옵션은 한번 이상 쓰일 수 있다. 필터에 대한 설명은 `uftrace-replay`(1) 를 참고한다. -C *FUNC*, \--caller-filter=*FUNC* -: 선택된 함수의 호출자를 출력하는 필터를 설정한다. 이 옵션은 한번 이상 쓰일 수 있다. +: 선택된 함수의 호출자만 출력하는 필터를 설정한다. 이 옵션은 한번 이상 쓰일 수 있다. 필터에 대한 설명은 `uftrace-replay`(1) 를 참고한다. -T *TRG*, \--trigger=*TRG* @@ -72,8 +73,7 @@ TUI 옵션 'trace' 트리거가 적용된 경우, 그 함수는 함수 크기와 상관없이 항상 출력된다. -L *LOCATION*, \--loc-filter=*LOCATION* -: 사용할 필터의 경로를 지정한다. - 이 옵션은 1번이상 사용할 수 있다. +: 선택된 소스위치를 출력하도록한다. 이 옵션은 한번 이상 쓰일 수 있다. *FILTERS*를 참고하라. \--no-libcall : 라이브러리 호출은 표시하지 않게 한다. @@ -89,20 +89,20 @@ TUI 옵션 일반(대기) 스케쥴 이벤트는 그대로 표시한다. \--match=*TYPE* -: 타입(TYPE)으로 일치하는 패턴을 보여준다. 가능한 형태는 `regex`와 `glob`이다. +: 패턴을 검사할 때 사용하는 방식을 결정한다. 가능한 형태는 `regex`와 `glob`이다. 기본 설정은 `regex`이다. \--with-syms=*DIR* -: DIR 디렉토리의 .sym 파일에서 심볼(symbol) 데이터를 읽는다. - 이는 심볼(symbol) 데이터가 제거된 바이너리 파일을 다루는데 유용하다. - 바이너리 파일 이름은 저장할 때와 사용할 때 동일해야 한다. +: 실행 파일 대신 *DIR*경로 속 .sym파일에서 심볼데이터를 가져온다. +이 기능은 컴파일 후 디버깅정보가 소실된 실행 파일 처리에 유용할 것이다. +메인 실행 파일은 저장시와 사용시에 파일명이 일치해야한다. 공통 분석 옵션 ======================= -H *FUNC*, \--hide=*FUNC* : 주어진 FUNC 함수들을 출력 대상에서 제외할 수 있다. 이는 선택된 함수의 자식 함수들에 대해서는 영향을 주지 않으며 단지 주어진 함수들만 숨기는 기능을 하게 - 된다. 이 옵션은 한번 이상 쓰일 수 있다. + 된다. 이 옵션은 한번 이상 쓰일 수 있다. 필터에 대한 설명은 `uftrace-replay`(1) 를 참고한다. \--kernel-full : 사용자 함수 밖에서 호출된 모든 커널 함수를 출력한다. @@ -126,19 +126,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 @@ -187,10 +187,10 @@ TUI 창에서 다음과 같은 키들을 사용할 수 있음: * `O`: 현재 함수에 대한 편집기 열기 * `c`/`e`: 직접 자식 그래프 노드 축소/확장 * `C`/`E`: 모든 자식들의 그래프 노드 축소/확장 - * `n`/`p`: 같은 높이의 다음/이전 항목으로 이동 (그래프 모드에서) + * `n`/`p`: 같은 계층의 다음/이전 항목으로 이동 (그래프 모드에서) * `u`: 부모 노드로 이동 (그래프 모드에서) * `l`: 가장 긴 실행 시간을 갖는 자식 노드로 이동 (그래프 모드에서) - * `j`/`k`: 커서를 위/아래로 움직임 (vi 기능과 같이) + * `j`/`k`: 커서를 위/아래로 움직임 (vi 에디터의 기능과 같음) * `z`: 현재 위치를 화면 중앙에 정렬 * `/`: 탐색 시작 * `<`/`P`: 이전 일치 검색