mkchart
 사용법
mkchart [options] [-H] [-B] -G fn1[:desc][,fn2[:desc][,fn3[:desc]]] [-N fn] [-A fn1[:fn2[:fn3]] ...] [file]
mkchart [options] -O -G fn1[:desc][,fn2[:desc][,fn3[:desc]]]
mkchart [options] -X [-H] [-B] -G fn1,fn2 [-N fn] [file]
Options are as follows:
-? print this help
-, put a comma in graph number
-1 draw first graph bigger than others with -A option
-A fn1[,fn2[,fn3]]] draw additional graphs for the specified fields; (multi-choice option)
-a assume input data are accumulated values
-b draw border line
-bb draw border with 2-dot line
-B horizontal bar graph in box
-C [bg][:c1:c2:c3] colors of the graph, colors must be 6 hex digits:
bg: background color; def: ffffff
c1: foreground color1; def: 0000ff
c2: foreground color2; def: ff0000
c3: foreground color3; def: 00ff00
-c num specify number of columns; def:0
-d delimiter field delimiter; def: whitespace
-D directory output directory; def: .
-f force to calculate unconditionally
-g gap specify border gap; def: 6
-G fn1[:desc][,fn2[:desc][,fn3[:desc]]] draw graphs for the specified fields
-G fn1,fn2 draw graphs for the specified fields with -X option
-h height height of bar graph; def: 100
-H horizontal bar graph
-i number divide input value by number
-k don't skip line automatically which starts with '#'
-L toplabel specify top label
-M do not print value indicator
-m max specify maximum value
-N fn specify field number for name
-n num specify width of maximum value
-o outfile output file, def: chart[.gif]
-O draw only field description
-s gap specify graph gap; def: 6
-S skiplist list starting word to skip (separated by comma)
-T title specify title
-V show version
-v print value on the graph
-w width width of bar graph; def: 8
-X draw min-max graph
file file name to read; if it is omitted, standard input is used
설명
mkchart 명령어는 입력 파일을 읽어서 지정한 컬럼에 있는 값에 대하여 막대 그래프를 그려서
GIF 포멧의 파일을 만들어 준다.
다음과 같은 내용을 가진 data 파일이 있다. 이파일을 가지고 mkchart 명령어를 설명한다.
web1 30 18 35 28
web2 35 24 69 30
web3 25 20 48 30
web4 25 26 39 28
web5 28 30 50 20
web6 22 19 40 18
was1 40 25 70 29
was2 25 22 33 22
dbserv1 10 9 24 15
dbserv2 23 15 55 20
|
# mkchart -N 1 -G 2:user,3:kernel data
|
| |
mkchart 명령어에 -N 옵션을 사용하여 막대 그래프에 대한 이름 부분을 가지고 있는 필드를 지정할 수 있다.
지정된 필드의 내용이 막대 그래프의 아랫쪽에 쓰여진다.
|
# mkchart -b -N1 -G 2:user,3:kernel data
|
|
mkchart 명령어에 -b 옵션을 지정하면, 그림에 외곽선을 그린다.
-bb 또는 -b -b 옵션을 지정하면(즉, -b 옵션을 두번 지정하면) 2 dot 짜리 외곽선을 그린다.
|
# mkchart -T "CPU usage" -b -N1 -G 2:user,3:kernel data
|
| |
mkchart 명령어에 -T 옵션을 사용하여 그림의 상단에 제목을 지정할 수 있다.
|
# mkchart -L "2010/01/05" -T "CPU usage" -b -N1 -G 2:user,3:kernel data
|
| |
mkchart 명령어에 -L 옵션을 사용하여 그림의 상단에 배경색을 회색 바탕으로 문자열을 표시할 수 있다.
|
# mkchart -g 20 -b -N1 -G 2:user,3:kernel data
|
# mkchart -g 0 -b -N1 -G 2:user,3:kernel data
|
|
|
-g 옵션을 이용하여 그래프의 외곽에 여유 공간을 지정할 수 있다. -g 20을 지정하여 그래프의 외부에 20 dot의 공간을
두었고, -g0 옵션을 지정하여 외부의 여유 공간을 0 dot로 지정하였다.
-g 옵션의 디폴트 여유 공간은 6 dot이다.
|
# mkchart -s 20 -b -N1 -G 2:user,3:kernel data
|
# mkchart -s 0 -b -N1 -G 2:user,3:kernel data
|
|
|
-s 옵션을 이용하여 막대 그래프들 간의 여유 공간을 지정할 수 있다. -s 20을 지정하여 20 dot의 공간을
두었고, -s0 옵션을 지정하여 여유 공간을 0 dot로 지정하였다.
-s 옵션의 디폴트 여유 공간은 6 dot이다.
|
# mkchart -w 20 -b -N1 -G 2:user,3:kernel data
|
# mkchart -h 50 -b -N1 -G 2:user,3:kernel data
|
|
|
-w 옵션을 이용하여 하나의 막대 그래프의 가로(폭) 크기를 지정할 수 있다.
-h 옵션을 이용하여 하나의 막대 그래프의 세로(높이) 크기를 지정할 수 있다.
위의 그림에서 왼쪽은 막대 그래프의 폭을 20 dot 크기로 지정하였고, 우측은 높이를 50 dot로 지정하였다.
-w 옵션의 디폴트 값은 8 이고, -h 옵션의 디폴트 값은 100 이다.
|
# mkchart -v -b -N1 -G 2:user,3:kernel data
|
| |
mkchart 명령어에 -v 옵션을 지정하면, 막대 그래프의 상단에 그래프의 각 필드를 합계한 값이 출력된다.
|
# mkchart -B -b -N1 -G 2:user,3:kernel data
|
| |
mkchart 명령어에 -B 옵션을 지정하면, 개별 막대 그래프에 외곽선을 그린다.
|
# mkchart -M -b -N1 -G 2:user,3:kernel data
|
| |
mkchart 명령어에 -M 옵션을 지정하면, 그래프의 왼쪽 부분에 있는 수치 값을 표시하지 않는다.
|
# mkchart -O -b -G 2:user,3:kernel
|
| |
mkchart 명령어에 -O 옵션을 지정하면, -G 옵션에서 지정한 설명부분만 그림으로 만든다.
|
# mkchart -c 5 -b -N1 -G 2:user,3:kernel data
|
|
mkchart 명령어에 -c 옵션을 사용하여 한 줄에 몇 개의 막대 그래프를 그릴지 지정할 수 있다.
위에서는 -c 5를 지정하여 한 줄에 5개의 막대 그래프를 그렸다.
-c 옵션의 디폴트 값은 0 이고, 0 이 의미하는 것은 한 줄에 모든 그래프를 그린다는 것이다.
|
# mkchart -A 4,5 -b -N1 -G 2:user,3:kernel data
|
# mkchart -A 4,5 -1 -b -N1 -G 2:user,3:kernel data
|
|
|
mkchart 명령어에 -A 옵션을 사용하여 추가적인 막대 그래프를 더 만들 수 있다.
위에서 -A 4,5 를 지정하여 4번째와 5번째의 데이타에 대하여 막대 그래프를 더 만들었다.
-1 옵션을 -A 옵션과 함께 사용하면, 추가적으로 그리는 막대 그래프의 폭이 -G 옵션에서 지정한
데이타의 막대 그래프의 폭의 1/2의 크기로 막대 그래프를 만든다.
-A 옵션을 여러 번 지정이 가능하다.
data 파일에 2번째와 3번째에는 하루 동안의 CPU 사용률의 평균값이고, 4번째와 5번째에는 1분간 최대 CPU 사용률이
있다.
이럴 경우, 그날의 평균 CPU 사용률과 1분단 최대 CPU 사용률을 하나의 그림에서
동시에 보고 싶을 때, -A 옵션은 유용한 옵션이다.
|
# mkchart -C ffffcc:0099cc:009900 -b -N1 -G 2:user,3:kernel data
|
|
-C 옵션을 사용하여 그림의 배경색과 선색을 지정할 수 있다.
-C 옵션의 형식은 다음과 같다.
-C bgcolor:color1:color2:color3
-C lbgcolor:fgcolor
-C obgcolor
bgcolor는 배경색이고, color1, color2, color3 은 각각 -G 옵션에서 지정한 필드의 막대 그래프의
색상이다.
디폴트로 배경색은 ffffff(흰색)이고,
color1은 0000ff(파란색) 이고,
color2은 ff0000(빨간색) 이고,
color3은 00ff00(녹색) 이다.
색을 지정하는 형식은 6자리 16진수이다. 각각 2자리씩 red, green, blue을 나타낸다.
bgcolor 앞에 소문자 'l' 또는 대문자 'L'을 지정하면, -L 옵션을 지정했을 때의 레이블 문자영역의
배경색과 글자색을 지정한다.
bgcolor 앞에 소문자 'o' 또는 대문자 'O'을 지정하면, -b 옵션을 지정했을 때의 외곽선의 색을 지정한다.
-C 옵션을 여러 번 지정할 수 있다.
|
# mkchart -H -b -N1 -G 2:user,3:kernel data
|
| |
mkchart 명령어에 -H 옵션을 지정하면, 막대 그래프를 수평으로 그린다.
|
# mkchart -X -b -N1 -G 2,3 data-minmax
|
|
mkchart 명령어에 -X 옵션을 지정하면, 최소값과 최대값이 있는 데이타에 대하여 최소-최대 막대 그래프를 그린다.
-X 옵션을 지정하면, -G 옵션에서 2개의 필드를 지정하여하고, 각각 최소값과
최대값을 가지고 있는 컬럼을 지정하여야 한다.
위의 그래프는 다음과 같은 데이타에 대하여 그래프를 그린 것이다.
web1 10 63
web2 20 99
web3 5 78
web4 22 67
web5 18 70
web6 20 58
was1 35 99
was2 18 55
dbserv1 3 39
dbserv2 8 75
|
위의 데이타에서 2번째 컬럼은 일일 CPU 사용률의 최소값이고 3번째 컬럼은 일일 CPU 사용률의 최대값이다.
|
다음은 mkchart 명령어의 옵션이다.
| 옵션 | 설명 |
|---|
| -, |
-, 옵션을 지정하면 그래프의 Y축 숫자에 3자리 마다 콤마를 추가한다.
|
| -1
|
-1 옵션이 -A 옵션과 함께 사용되면, -A 옵션에 의해 추가적으로 만들어진 막대 그래프의
폭을 -G 옵션에서 만들어진 크기의 1/3로 한다.
|
| -A fn1[,fn2[,fn3]]]
|
-A fn1[,fn2[,fn3]]] 옵션을 사용하여, -G 옵션에 지정한 컬럼과 별도의 컬럼에 대하여 추가적인 막대 그래프를 만든다.
|
| -a
|
mkchart 명령어가 데이타 파일을 읽어서 처리할 때, 각 컬럼은 각각의 값을 가지고 있다.
-a 옵션을 지정하면, 각 컬럼이 누적되는 값을 가지고 있다는 것을 알려준다. 그러면,
mkchart 명령어는 내부적으로 누적된 값은 개별적인 값으로 환산하여 그래프를 만든다.
Parm의 mrepx 명령어로 데이타를 텍스트로 출력하면, CPU 사용률과 같이 2개 이상의 내부 값이 있는 경우에
각각의 값을 누적하여 출력한다. 이러한 데이타의 출력을 입력으로 사용하는 경우에 -a 옵션을 사용할
필요가 있다.
|
| -b
|
-b 옵션을 지정하면, 그림에 외곽선을 그린다.
-bb 또는 -b -b 옵션을 지정하면(즉, -b 옵션을 두번 지정하면) 2 dot 짜리 외곽선을 그린다.
|
| -B
|
-B 옵션을 지정하면, 개별 막대 그래프에 외곽선을 그린다.
|
-C bgcolor:color1:color2:color3
-C lbgcolor:fgcolor
-C obgcolor
|
-C 옵션을 사용하여 그림의 배경색과 선색을 지정할 수 있다.
-C 옵션의 형식은 다음과 같다.
-C bgcolor:color1:color2:color3
-C lbgcolor:fgcolor
-C obgcolor
bgcolor는 배경색이고, color1, color2, color3 은 각각 -G 옵션에서 지정한 필드의 막대 그래프의
색상이다.
디폴트로 배경색은 ffffff(흰색)이고,
color1은 0000ff(파란색) 이고,
color2은 ff0000(빨간색) 이고,
color3은 00ff00(녹색) 이다.
색을 지정하는 형식은 6자리 16진수이다. 각각 2자리씩 red, green, blue을 나타낸다.
bgcolor 앞에 소문자 'l' 또는 대문자 'L'을 지정하면, -L 옵션을 지정했을 때의 레이블 문자영역의
배경색과 글자색을 지정한다.
bgcolor 앞에 소문자 'o' 또는 대문자 'O'을 지정하면, -b 옵션을 지정했을 때의 외곽선의 색을 지정한다.
-C 옵션을 여러 번 지정할 수 있다.
|
| -c num
|
-c num 옵션을 사용하여 한 줄에 몇 개의 막대 그래프를 그릴지 지정할 수 있다.
-c 옵션의 디폴트 값은 0 이고, 0 이 의미하는 것은 한 줄에 모든 그래프를 그린다는 것이다.
|
| -d delimiter
|
-d delimiter 옵션을 사용하여 입력 데이타의 필드 구분자를 지정한다.
디폴트 구분자는 whitespace(공백과 텝)이다. "-d ," 을 지정하면, 필드 구분자가 "," 가 된다.
|
| -D directory
|
-D directory 옵션은 출력될 그래프를 만들 디렉토리명을 지정한다. 디폴트는 "."이다.
지정한 디렉토리가 없으면 새로 만들어 준다. 단 최하단의 디렉토리만 만든다.
|
| -f
|
데이타 파일에서 -G 옵션에서 선택한 필드에 숫자가 아닌 다른 문자가 올 때 오류를 발생하고, 프로그램이
종료된다. -f 옵션을 지정하면, 숫자가 아닌 값이 입력이 있을 경우 0으로 간주하고 계속 처리한다.
|
| -g gap
|
-g gap 옵션을 사용하면, 그림의 외곽에 gap 만큼의 여유 공간을 둔다. 디폴트는 6 이다.
만일 여유 공간을 x축과 y축으로 각각 따로 지정하고 싶으면, 숫자 앞에 'x' 또는 'y'라고 지정할 수 있다.
-g x10 -g y20
|
-G fn1[:desc][,fn2[:desc][,fn3[:desc]]]
-G fn1,fn2
|
-G fn1[:desc][,fn2[:desc][,fn3[:desc]]]
-G fn1,fn2 ; with -X option
-G 옵션에 지정한 컬럼에 대하여 막대 그래프를 그린다.
-G 옵션에 콤마로 구분하여 최대 3개의 필드를 지정할 수 있다.
입력파일에서 필드의 구분은 디폴트로 공백으로 구분된다.
필드번호는 숫자로 지정하며, 첫번째 있는 컬럼은 필드번호 1 이 된다.
필드 번호에 콜론(:)를 붙인 다음에 그 필드에 대한 설명을 붙일 수 있다. 설명을 붙이면, 그 내용이 그림상에 표시된다.
|
| -h
|
-h height 옵션을 사용하여, 하나의 막대 그래프의 세로 크기를 지정한다.
|
| -H
|
mkchart 명령어는 디폴트로 막대 그래프를 수직으로 그린다. -H 옵션을 지정하면, 막대 그래프를 수평으로 그린다.
막대 그래프는 수직 막대 그래프를 기본으로 한다. -w 옵션과 -h 옵션으로 막대 그래프의 크기를 변경할 수 있는데,
-H 옵션을 사용하더라도 -w와 -h 옵션은 수직 막대 그래프를 기준으로 가로, 세로의 크기를 결정한다.
|
| -i number
|
-i 옵션을 지정하면, 입력되는 값을 지정한 숫자로 나누어 처리한다.
입력데이타가 kilobyte 단위인데, 이것을 그래프상에서 megabyte 단위로 표시하려면,
"-i 1024" 라고 옵션을 지정하면 된다.
|
| -k
|
입력 파일에서 '#' 문자로 시작하는 라인은 디폴트로 스킵하는데, -k 옵션을 지정하면 스킵하지 않고 데이타로 사용한다.
|
| -L toplabel
|
-L toplabel 옵션을 사용하여, 그림의 상단에 배경색을 회색으로 하는 글자를 표시할 수 있다.
Parm V10.2 부터는 toplabel에 EUC 한글 문자도 표시된다.
|
| -M
|
-M 옵션을 지정하면, 그래프의 왼쪽에 수치 값을 표시하지 않는다.
|
| -m max
|
-m max 옵션을 사용하여 그래프의 왼쪽에 최대값을 지정할 수 있다.
|
| -N fn
|
-N fn 옵션을 사용하여 입력파일에서 데이타에 대한 정보를 가지고 있는 컬럼을 지정할 수 있다.
여기에 지정된 필드의 정보가 각 막대 그래프에 표시된다.
|
| -n num
|
-n num 옵션을 사용하여 그래프의 왼쪽에 최대값을 출력할 문자열의 공간을 명시적으로 지정할 수 있다.
|
| -o outfile
|
-o outfile 옵션을 사용하여, 출력될 그림 파일명을 지정할 수 있다. 디폴트는 "chart" 이다.
-o 옵션에 지정한 파일명에 ".gif"는 자동으로 추가 된다.
outfile에 '-' 마이너스 기호를 지정하면, 만들어진 GIF 그림파일을 표준출력으로 출력한다.
이때 "Content-type: image/gif" 라는 HTTP 프로토콜에서 사용되는 Content-type을 먼저 출력하고
나중에 그림 파일의 내용을 출력한다. 이것을 사용하여 CGI 프로그램을 만들어 그림을 웹에서 바로 볼 수 있게 해준다.
|
| -O
|
-O 옵션을 지정하면, -G 옵션에서 지정한 설명부분(desc)만 그림으로 표시한다.
|
| -s gap
|
-s gap 옵션을 사용하여, 막대 그래프간의 여유공간을 지정할 수 있다. 디폴트는 6 이다.
|
| -S skiplist
|
-S skiplist 옵션을 사용하여 입력 데이타 파일에서 스킵하고 싶은 문자열을 지정할 수 있다.
데이타 파일에 있는 내용 중에 데이타가 아닌 라인이 있을 경우, -S 옵션을
사용하여, 그 라인에서 시작하는 문자열을 지정하여 스킵할 수 있다.
스킵하고 싶은 문자열이 여러 개가 있을 경우에 콤마(,)로 구분한다.
지정한 문자열과 입력 데이타 라인과 비교하여, 일치하면 그 라인을 스킵한다.
입력 라인에서 시작 부분의 whitespace (공백 또는 탭)는 비교되지 않는다.
|
| -T title
|
-T title 옵션을 사용하여, 그래프의 상단 중앙에 제목을 표시한다.
|
| -V
|
-V 옵션을 지정하면, 명령어의 버전 정보를 보여준다.
|
| -v
|
-v 옵션을 지정하면, 막대 그래프의 값을 표시한다.
|
| -w width
|
-w width 옵션을 사용하여, 하나의 막대 그래프의 가로 크기를 지정한다.
|
| -X
|
mkchart 명령어에 -X 옵션을 지정하면, 최소값과 최대값이 있는 데이타에 대하여 최소-최대 막대 그래프를 그린다.
-X 옵션을 지정하면, -G 옵션에서 2개의 필드를 지정하여하고, 각각 최소값과
최대값을 가지고 있는 컬럼을 지정하여야 한다.
|
|
