diff options
Diffstat (limited to '')
| -rw-r--r-- | po4a/man/ko/xz.1 | 301 |
1 files changed, 197 insertions, 104 deletions
diff --git a/po4a/man/ko/xz.1 b/po4a/man/ko/xz.1 index d93c199..db07f82 100644 --- a/po4a/man/ko/xz.1 +++ b/po4a/man/ko/xz.1 @@ -1,23 +1,24 @@ '\" t +.\" SPDX-License-Identifier: 0BSD .\" .\" Authors: Lasse Collin .\" Jia Tan .\" -.\" This file has been put into the public domain. -.\" You can do whatever you want with this file. +.\" Korean translation for the xz-man +.\" Seong-ho Cho <darkcircle.0426@gmail.com>, 2023, 2024. .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH XZ 1 2023\-07\-17 Tukaani "XZ 유틸리티" +.TH XZ 1 2024\-04\-08 Tukaani "XZ 유틸리티" . .SH 이름 xz, unxz, xzcat, lzma, unlzma, lzcat \- .xz 파일과 .lzma 파일을 압축 또는 압축 해제합니다 . .SH 요약 -\fBxz\fP [\f\fI옵션\fP...\fP] [\fI<파일>...\fP] +\fBxz\fP [\fI<옵션>...\fP] [\fI<파일>...\fP] . .SH "명령 별칭" \fBunxz\fP 명령은 \fBxz \-\-decompress\fP 명령과 동일합니다. @@ -172,7 +173,7 @@ setgid, 끈적이 비트 세트를 설정한 상태라도 압축하거나 압축 대상 파일이 이미 있으면, 압축 또는 압축 해제 전 삭제합니다. .IP \(bu 3 입력 파일이 일반 파일을 참조하는 심볼릭 링크나 하나 이상의 하드 링크, 내지는 setuid, setgid, 끈적이 비트 세트를 설정한 -상태라도 압축 또는 압축 해제를 진행합니다. setuid, setgid, 끈적이 비트는 대상 파일에 복사하지 않습니다 +상태라도 압축 또는 압축 해제를 진행합니다. setuid, setgid, 끈적이 비트는 대상 파일에 복사하지 않습니다. .IP \(bu 3 \fB\-\-decompress\fP \fB\-\-stdout\fP 옵션을 같이 사용하는 상황에서 \fBxz\fP 명령이 원본 파일의 형식을 알아내지 못할 때, 원본 파일의 사본을 표준 출력으로 보냅니다. 이렇게 하면 \fBxzcat\fP \fB\-\-force\fP 명령을 \fBxz\fP 명령으로 압축하지 않은 @@ -353,12 +354,15 @@ CompCPU는 \fB\-6\fP ... \fB\-9\fP 수준값과 동일한데, 고수준 값은 압축율은 가능한 한 더 좋아집니다. \fB\-\-extreme\fP을 참고하십시오. .IP \(bu 3 CompMem은 단일\-스레드 모드에서 필요한 압축 프로그램의 메모리 점유 용량입니다. \fBxz\fP 버전에 따라 다를 수 있습니다. -앞으로 도입할 다중\-스레드 모드의 메모리 사용량은 단일\-스레드 모드에서의 그것보다는 훨씬 늘어납니다. .IP \(bu 3 DecMem은 압축 해제 프로그램의 메모리 점유용량입니다. 이는 곧, 압축 해제 프로그램에서 필요한 메모리 사용량을 압축 설정에서 결정한다는 의미가 들어있습니다. 정확한 압축 해제 프로그램의 메모리 사용량은 LZMA2 딕셔너리 크기 보다는 조금 많지만 테이블의 값은 MiB 용량으로 완전히 반올림한 값입니다. .RE +.IP "" +다중\-스레드 모드에서 필요한 메모리 용량은 단일\-스레드 모드보단 약간 더 많습니다. \fB\-\-block\-size\fP 기본값에 따라, 각 +스레드에서는 3*3*딕셔녀리_크기 + 압축시_메모리용량 또는 압축_해제시_메모리용량 정도가 필요합니다. 예를 들면, 스레드 넷에 사전 +설정 옵션 \fB\-6\fP을 사용한다면, 660\(en670 MiB 메모리 용량이 필요합니다. .TP \fB\-e\fP, \fB\-\-extreme\fP 기대하는 만큼의 좀 더 나은 압축율을 확보하려 선택한 압축 사전 설정 수준의 느린 변형 옵션을 사용하지만, 재수 없는 와중에 골로 가는 @@ -406,29 +410,50 @@ Preset;DictSize;CompCPU;CompMem;DecMem 다중\-스레드 모드에서 기본 블록 크기를 지정할 때 사용하지만, 단일\-스레드 모드에서도 사용할 수 있습니다. .IP "" 다중\-스레드 모드에서는 약 3배 용량의 \fI<크기>\fP 바이트만큼 각 스레드 별로 입출력 버퍼링용 공간을 할당합니다. 기본 -\fI<크기>\fP는 LZMA2 딕셔너리 크기 또는 1MiB 중 가장 큰 쪽의 세 배입니다. 보통 바람직한 값으로 LZMA2 -딕셔너리 크기나 최소한 1MiB의 2\(en4배입니다. LZMA2 딕셔너리 크기보다 작은 \fI<크기>\fP 는 램의 소모적 -사용 공간으로 할당하는데 LZMA2 딕셔너리 버퍼를 할당한 용량 크기 전체를 다 사용하지 않기 때문입니다. 블록 크기는 블록 헤더에 -저장하며, 블록 헤더는 \fBxz\fP 차기 버전에서 다중\-스레드 압축 해제시 활용할 예정입니다. +\fI<크기>\fP는 LZMA2 딕셔너리 크기 또는 1MiB 중 가장 큰 쪽의 세 배입니다. 보통 적절한 값으로 LZMA2 +딕셔너리 크기 또는 최소한 1MiB 용량의 2\(en4배입니다. LZMA2 딕셔너리 크기보다 작은 \fI<크기>\fP는 램의 +소모적 사용 공간으로 할당하는데 LZMA2 딕셔너리 버퍼를 할당한 용량 크기 전체를 다 사용하지 않기 때문입니다. 다중\-스레드 모드에서 +블록 크기는 블록 헤더에 저장하며, 이 크기 정보는 다중\-스레드 압축 해제시 필요합니다. .IP "" 단일\-스레드 모드에서는 기본적으로 블록 쪼개기를 하지 않습니다. 이 옵션을 설정한다고 해서 메모리 사용에 영향을 주지는 않습니다. 블록 헤더에 크기 정보를 저장하지 않기 때문에 단일\-스레드 모드에서 만든 파일은 다중\-스레드 모드에서 만든 파일과 동일하지 않습니다. -크기 정보의 누락은 또한 \fBxz\fP 차기 버전에서 다중\-스레드 모드에서 압축 해제가 불가능함을 의미하기도 합니다. +크기 정보의 누락은 또한 \fBxz\fP에서 다중\-스레드 모드로 압축 해제를 진행할 수 없음을 의미하기도 합니다. .TP -\fB\-\-block\-list=\fP\fI<크기>\fP -\&\fB.xz\fP 형식으로 압축할 때, 압축하지 않은 데이터에 주어진 처리 시간 간격 이후에 새 블록 처리를 시작합니다. +\fB\-\-block\-list=\fP\fI<항목>\fP +\&\fB.xz\fP 형식으로 압축할 때, 압축하지 않은 데이터로 부터 일정 간격 이후에 새 블록 처리를 시작합니다. +.IP "" +\fI<항목>\fP은 쉼표로 구분한 목록으로 지정합니다. 각 항목은 콜론 (\fB:\fP)으로 구분한 0부터 9까지의 추가 필터 +체인 번호 값으로 이루어져 있으며, 압축하지 않은 데이터의 크기 값이 필요합니다. 항목을 생략하면(둘 이상의 쉼표 연속 표기) 이전 +항목의 크기와 필터를 활용하겠다는 함축 의미를 넣을 수 있습니다. .IP "" -압축하지 않은 블록 \fI<크기>\fP는 쉼표로 구분한 목록으로 지정합니다. 크기 값을 생략(둘 이상의 연속 쉼표)는 이전 -블록 크기를 계속 사용하겠다는 의미입니다. +입력 파일이 \fI<항목>\fP 크기의 합보다 크면, 마지막 항목을 파일의 끝까지 반복합니다. 특별히 \fB0\fP 값을 마지막 +값으로 사용하여 파일 나머지 부분을 단일 블록으로 인코딩해야 한다는 의미를 나타낼 수도 있습니다. .IP "" -입력 파일이 \fI<크기>\fP의 합보다 크면, 마지막 \fI<크기>\fP 값을 파일 마지막까지 반복해서 사용합니다. -특별히 \fB0\fP 값을 마지막 값으로 사용하여 파일 나머지 부분을 단일 블록으로 인코딩해야 한다는 의미를 나타낼 수도 있습니다. +\fB\-\-filters1=\fP\fI<필터>\fP \&...\& \fB\-\-filters9=\fP\fI<필터>\fP 옵션 조합으로 +각 블록별 별도 필터 체인을 지정할 수 있습니다. 이 옵션은 1\(en9번 필터 체인을 지정합니다. 필터 체인 0번은 필터 체인을 +지정하지 않았을 때와 동일한 기본 필터 체인으로 참조할 수 있습니다. 필터 체인 식별 번호는 비 압축 크기 앞에 콜론(\fB:\fP)을 붙여 +사용할 수 있습니다. 예를 들면, \fB\-\-block\-list=1:2MiB,3:2MiB,2:4MiB,,2MiB,0:4MiB\fP 옵션을 +지정했을 경우 다음 규칙대로 블록을 만듭니다: +.RS +.IP \(bu 3 +\fB\-\-filters1\fP 필터 체인에서는 2MiB 입력을 +.IP \(bu 3 +\fB\-\-filters3\fP 필터 체인에서는 2MiB 입력을 +.IP \(bu 3 +\fB\-\-filters2\fP 필터 체인에서는 4MiB 입력을 +.IP \(bu 3 +\fB\-\-filters2\fP 필터 체인에서는 4MiB 입력을 +.IP \(bu 3 +기본 필터 체인에서는 2MiB 입력을 +.IP \(bu 3 +입력이 끝나기 전의 모든 블록에는 기본 필터 체인과 4MiB 입력을 적용합니다. +.RE .IP "" -인코더 블록 크기를 초과하는 \fI<크기>\fP 값을 지정하면(스레드 모드 기본값 또는 -\fB\-\-block\-size=\fP\fI<크기>\fP 옵션으로 지정한 값), 인코더는 \fI<크기>\fP 지정 용량 범위는 -유지하면서 추가 블록을 만듭니다. 예를 들면 \fB\-\-block\-size=10MiB\fP -\fB\-\-block\-list=5MiB,10MiB,8MiB,12MiB,24MiB\fP 옵션을 지정하고 입력 파일을 80MiB 용량으로 전달하면, -각각 5, 10, 8, 10, 2, 10, 10, 4, 10, 10, 1 MiB 용량을 차지하는 블록 11개를 결과물로 내줍니다. +인코더 블록 크기를 초과하는 크기 값을 지정하면(스레드 모드 기본값 또는 \fB\-\-block\-size=\fP\fI<크기>\fP +옵션으로 지정한 값), 인코더는 \fI<크기>\fP 지정 용량 범위는 유지하면서 추가 블록을 만듭니다. 예를 들면 +\fB\-\-block\-size=10MiB\fP \fB\-\-block\-list=5MiB,10MiB,8MiB,12MiB,24MiB\fP 옵션을 지정하고 +입력 파일을 80MiB 용량으로 전달하면, 각각 5, 10, 8, 10, 2, 10, 10, 4, 10, 10, 1 MiB 용량을 +차지하는 블록 11개를 결과물로 내줍니다. .IP "" 다중\-스레드 모드에서 블록 크기는 블록 헤더에 저장합니다. 단일\-스레드 모드에서는 저장하지 않기 때문에 인코딩 처리한 출력은 다중\-스레드 모드의 출력 결과물과는 다릅니다. @@ -549,6 +574,8 @@ Preset;DictSize;CompCPU;CompMem;DecMem 스레드 압축 해제 방식은 여러 블록이 블록 헤더에 넣은 크기 정보와 함께 들어간 파일에만 동작합니다. 다중\-스레드 모드에서 압축한 충분히 큰 모든 파일은 이 조건에 만족하지만, 단일\-스레드 모드에서 압축한 파일은 \fB\-\-block\-size=\fP\fI<크기>\fP 옵션을 지정하더라도 조건에 만족하지 않습니다. +.IP "" +\fI스레드\fP 기본 값은 \fB0\fP입니다. \fBxz\fP 5.4.x 이전의 기본값은 \fB1\fP입니다. . .SS "개별 압축 필터 체인 설정" 개별 필터 체인은 사전 설정에 엮인 설정에 의존하는 대신 압축 설정을 세부적으로 하나하나 설정할 수 있게 합니다. 개별 필터 체인을 @@ -563,15 +590,37 @@ Preset;DictSize;CompCPU;CompMem;DecMem 필터로, 어떤 동작은 체인의 어떤 위치에든 둡니다. 필터에 따라, 이 제한은 필터 설계를 따르거나 보안 문제를 막기 위해 존재하기도 합니다. .PP -개별 필터 체인은 필터 체인에서 원하는 순서대로 하나 이상의 필터 옵션을 사용하여 지정합니다. 이는, 필터 옵션 순서가 중요하다는 -뜻입니다! 원시 스트림을 디코딩할 때(\fB\-\-format=raw\fP), 필터 체인은 압축할 때 지정했던 동일한 순서대로 지정합니다. +개별 필터 체인은 두가지 방식으로 지정할 수 있습니다. \fB\-\-filters=\fP\fI<필터>\fP와 +\fB\-\-filters1=\fP\fI<필터>\fP \&...\& \fB\-\-filters9=\fP\fI<필터>\fP 옵션으로 +liblzma 필터 문자열 문법에 따라 한가지 옵션을 필터 체인 전체를 지정할 수 있습니다. 대신, 하나 이상의 개별 필터 옵션을 +원하는 필터 체인 순서대로 지정할 수도 있습니다. 이 말인 즉슨, 개별 필터 옵션의 순서가 중요하단 뜻입니다! 원시 스트림을 디코딩할 +때(\fB\-\-format=raw\fP), 압축했을 때 지정했던 필터와 같은 순서로 필터 체인을 지정해야 합니다. 전체 체인 +옵션(\fB\-\-filters=\fP\fI<필터>\fP) 보다 우선 지정한 개별 필터 또는 사전 설정 옵션은 까먹을 수도 있습니다. +전체 체인 옵션 다음에 개별 필터를 지정할 경우 필터 체인의 동작을 무효로 합니다. .PP -필터는 쉼표로 구분하는 필터별 \fI<옵션>\fP이 있습니다. \fI<옵션>\fP에 추가로 입력한 쉼표는 무시합니다. -모든 옵션 값에는 기본값이 있어, 값을 바꾸려면 지정해야합니다. +필터는 쉼표로 구분하는 필터별 \fI<옵션>\fP이 있습니다. \fI<옵션>\fP에 추가로 입력한 쉼표는 +무시합니다. 모든 옵션 값에는 기본값이 있어, 값을 바꾸려면 지정해야합니다. .PP 전체 필터 체인과 \fI<옵션>\fP을 보려면 \fBxz \-vv\fP (\fB\-\-verbose\fP 두 번)명령을 사용하십시오. 이 명령은 사전 설정이 사용하는 필터 체인 옵션도 볼 수 있습니다. .TP +\fB\-\-filters=\fP\fI<필터>\fP +전체 필터 체인 또는 사전 설정을 단일 옵션으로 지정합니다. 각 필터는 공백 문자 또는 대시 문자 두번 입력(\fB\-\-\fP)으로 +구분합니다. 셸 명령행에서 \fI필터\fP는 따옴표로 감싸서 단일 옵션으로 해석하도록 해야 합니다. \fI옵션\fP을 표기하려면 \fB:\fP 또는 +\fB=\fP을 활용하십시오. 사전 설정 앞에 \fB\-\fP를 붙일 수 있고 0개 또는 하나 이상의 플래그를 붙일 수 있습니다. 유일하게 +지원하는 플래그는 \fB\-\-extreme\fP과 동일한 \fBe\fP입니다. +.TP +\fB\-\-filters1\fP=\fI<필터>\fP ... \fB\-\-filters9\fP=\fI<필터>\fP +\fB\-\-block\-list\fP와 사용할 수 있는 추가 필터 체인을 최대 9개까지 지정합니다. +.IP "" +예를 들어 텍스트 파일과 실행 파일의 아카이브를 압축할 때 실행 부분에 BCJ 필터 체인을 사용하고 텍스트 부분은 LZMA2 필터를 +사용할 수 있습니다. +.TP +\fB\-\-filters\-help\fP +\fB\-\-filters\fP와 \fB\-\-filters1=\fP\fI<필터>\fP \&...\& +\fB\-\-filters9=\fP\fI<필터>\fP 옵션의 사전 설정 필터와 개별 설정 필터 체인을 지정하는 방법을 설명하는 도움말 +메시지를 출력하고 완전히 빠져나갑니다. +.TP \fB\-\-lzma1\fP[\fB=\fP\fI<옵션>\fP] .PD 0 .TP @@ -745,6 +794,8 @@ LZMA1 또는 LZMA2로 종종 압축하는 파일 형식이라고 하면 고려 \fB\-\-ia64\fP[\fB=\fP\fI<옵션>\fP] .TP \fB\-\-sparc\fP[\fB=\fP\fI<옵션>\fP] +.TP +\fB\-\-riscv\fP[\fB=\fP\fI<옵션>\fP] .PD 브랜치/호출/점프(BCJ) 필터를 필터 체인에 추가합니다. 이 필터는 필터 체인의 비종결 필터로만 사용할 수 있습니다. .IP "" @@ -782,14 +833,28 @@ ARM64;4;4096 바이트 정렬이 가장 좋습니다 PowerPC;4;빅엔디안 전용 IA\-64;16;Itanium SPARC;4; +RISC\-V;2; .TE .RE .RE .IP "" BCJ 필터를 사용한 데이터는 LZMA2로 보통 압축하기 때문에 LZMA2 옵션을 선택한 BCJ 필터의 정렬기준에 맞추도록 설정하면 -압축율을 좀 더 개선할 수 있습니다. 예를 들면, IA\-64 필터에서는 \fBpb=4\fP 또는 LZMA2에 대해 -\fBpb=4,lp=4,lc=0\fP (2^4=16) 값이 바람직합ㄴ디ㅏ. x86 필터는 예외로, x86 실행 파일을 압축할 경우 -LZMA2의 기본 4바이트 정렬을 따르는게 좋습니다. +압축율을 좀 더 개선할 수 있습니다. 예를 들면: +.RS +.IP \(bu 3 +IA\-64 필터는 16\-바이트 정렬 방식으로 동작하기에 LZMA2 필터에 \fBpb=4,lp=4,lc=0\fP 옵션(2^4=16)을 주는게 +좋습니다. +.IP \(bu 3 +RISC\-V 코드에는 16\-비트 압축 명령(C 확장) 적재 여부에 따라 2\-바이트 또는 4\-바이트 정렬 방식을 채택합니다. 16\-비트 +명령을 사용하면, \fBpb=2,lp=1,lc=3\fP 또는 \fBpb=1,lp=1,lc=3\fP 옵션 값 사용이 바람직합니다. 16\-비트 명령이 +없다면, \fBpb=2,lp=2,lc=2\fP 옵션 값을 활용하는게 좋습니다. "RVC"가 "Flags"행에 나타나는지 확인할 때 +\fBreadelf \-h\fP 명령을 사용할 수 있습니다. +.IP \(bu 3 +ARM64는 항상 4\-바이트 정렬 방식을 택하기에 \fBpb=2,lp=2,lc=2\fP 옵션 값을 활용하는게 좋습니다. +.IP \(bu 3 +x86 필터는 예외입니다. x86 실행 파일을 압축할 경우에는 보통 LZMA2 기본 옵션 값(\fBpb=2,lp=0,lc=3\fP)을 그대로 +사용하는게 좋습니다. +.RE .IP "" 모든 BCJ 필터는 동일한 \fI옵션\fP을 지원합니다: .RS @@ -878,58 +943,8 @@ LZMA2의 기본 4바이트 정렬을 따르는게 좋습니다. . .SH "로봇 모드" 로봇 모드는 \fB\-\-robot\fP 옵션으로 동작합니다. \fBxz\fP 출력을 다른 프로그램에서 해석하기 쉽게 해줍니다. 현재로서는 -\fB\-\-robot\fP 옵션은 \fB\-\-version\fP, \fB\-\-info\-memory\fP, \fB\-\-list\fP 옵션하고만 사용할 수 있습니다. -앞으로는 압축 및 압축 해제 동작에 대해서도 지원합니다. -. -.SS 버전 -\fBxz \-\-robot \-\-version\fP 은 \fBxz\fP 와 liblzma의 버전 번호를 다음 형식으로 나타냅니다: -.PP -\fBXZ_VERSION=\fP\fIXYYYZZZS\fP -.br -\fBLIBLZMA_VERSION=\fP\fIXYYYZZZS\fP -.TP -\fIX\fP -주 버전. -.TP -\fIYYY\fP -부 버전. 짝수가 안정 버전입니다. 홀수는 알파 또는 베타 버전입니다. -.TP -\fIZZZ\fP -안정 릴리스의 패치 수준 또는 개발 릴리스의 횟수입니다. -.TP -\fIS\fP -안정도. 0은 알파 버전, 1은 베타 버전을 나타내며, 2는 안정 버전을 나타냅니다. \fIS\fP는 \fIYYY\fP 값이 짝수라 해도 항상 -2여야 합니다. -.PP -\fBxz\fP 명령과 liblzma이 동일한 XZ 유틸리티 릴리스에서 나왔다면 두 행의 \fIXYYYZZZS\fP 값은 같습니다. -.PP -예제: 4.999.9beta는 \fB49990091\fP이며, 5.0.0은 \fB50000002\fP입니다. -. -.SS "메모리 제한 정보" -\fBxz \-\-robot \-\-info\-memory\fP 명령은 탭으로 나뉜 여러 컬럼을 단일 행으로 나타냅니다: -.IP 1. 4 -물리 메모리(RAM)의 바이트 단위 총량. -.IP 2. 4 -압축 진행시 바이트 단위 메모리 사용 한계값 (\fB\-\-memlimit\-compress\fP). 특수 값 \fB0\fP은 단일\-스레드 모드에서 -제한을 두지 않는 기본 설정임을 나타냅니다. -.IP 3. 4 -압축 해제시 바이트 단위 메모리 사용 한계값 (\fB\-\-memlimit\-decompress\fP). 특수 값 \fB0\fP은 단일\-스레드 모드에서 -제한을 두지 않는 기본 설정임을 나타냅니다. -.IP 4. 4 -\fBxz\fP 5.3.4alpha 이후: 다중\-스레드 기반 압축 해제시 바이트 단위 메모리 -사용량(\fB\-\-memlimit\-mt\-decompress\fP). 분명하게 제한을 걸어두지 않았을 경우 5번째 컬럼에 나타난 시스템별 -기본값을 사용하기 때문에 0 값을 지정하면 안됩니다. 또한 \fB\-\-memlimit\-mt\-decompress\fP로 세번째 컬럼 값보다 더 -크게 지정을 한다 할지라도 이 값이 세번째 컬럼 값보다 크면 안됩니다. -.IP 5. 4 -\fBxz\fP 5.3.4alpha 이후: A system\-specific default memory usage limit that is -used to limit the number of threads when compressing with an automatic -number of threads (\fB\-\-threads=0\fP) and no memory usage limit has been -specified (\fB\-\-memlimit\-compress\fP). This is also used as the default value -for \fB\-\-memlimit\-mt\-decompress\fP. -.IP 6. 4 -\fBxz\fP 5.3.4alpha 이후: Number of available processor threads. -.PP -차후, \fBxz \-\-robot \-\-info\-memory\fP 출력에는 더 많은 내용이 들어가지만, 한 줄 이상은 넘어가지 않습니다. +\fB\-\-robot\fP 옵션은 \fB\-\-list\fP, \fB\-\-filters\-help\fP, \fB\-\-info\-memory\fP, \fB\-\-version\fP +옵션하고만 사용할 수 있습니다. 앞으로는 압축 및 압축 해제 동작에 대해서도 지원합니다. . .SS "목록 모드" \fBxz \-\-robot \-\-list\fP 명령은 탭으로 구분한 출력 형태를 활용합니다. 모든 행의 첫번째 컬럼에는 해당 행에서 찾을 수 @@ -1026,7 +1041,7 @@ for \fB\-\-memlimit\-mt\-decompress\fP. .PD .PP \fB\-\-verbose\fP를 두 번 지정하면, 추가 컬럼을 \fB블록\fP 행에 넣습니다. \fB\-\-verbose\fP 단일 지정시에는 이 정보를 볼 -때 탐색을 여러번 수행해야 하기 때문에 실행 과정이 느려질 수 있어서 나타내지 않습니다. +때 탐색을 여러번 수행해야 하기 때문에 실행 과정이 느려질 수 있어서 나타내지 않습니다: .PD 0 .RS .IP 11. 4 @@ -1053,7 +1068,7 @@ for \fB\-\-memlimit\-mt\-decompress\fP. .IP 3. 4 모든 블록 헤더에 압축 크기와 압축 전 원본 크기 정보가 들어갔는지 여부를 나타내는 \fByes\fP 또는 \fBno\fP 값 .PP -\fBxz\fP \fI5.1.2alpha\fP \fI부터\fP: +\fBxz\fP \fI5.1.2alpha\fP \fI부터:\fP .IP 4. 4 파일 압축 해제시 필요한 최소 \fBxz\fP 버전 .RE @@ -1089,7 +1104,7 @@ for \fB\-\-memlimit\-mt\-decompress\fP. .IP 11. 4 모든 블록 헤더에 압축 크기와 압축 전 원본 크기 정보가 들어갔는지 여부를 나타내는 \fByes\fP 또는 \fBno\fP 값 .PP -\fBxz\fP \fI5.1.2alpha\fP \fI부터\fP: +\fBxz\fP \fI5.1.2alpha\fP \fI부터:\fP .IP 12. 4 파일 압축 해제시 필요한 최소 \fBxz\fP 버전 .RE @@ -1098,6 +1113,73 @@ for \fB\-\-memlimit\-mt\-decompress\fP. 차후 버전에서는 새 행 형식을 추가하고 기존 행 형식에 추가할 수 있는 새 컬럼을 넣기 까지는 알 수 있겠지만, 기존 컬럼은 바꾸지 않을 예정입니다. . +.SS "필터 도움말" +\fBxz \-\-robot \-\-filters\-help\fP 는 다음 형식의 지원 필터 목록을 출력합니다: +.PP +\fI<필터>\fP\fB:\fP\fI<옵션>\fP\fB=<\fP\fI값\fP\fB>,\fP\fI<옵션>\fP\fB=<\fP\fI값\fP\fB>\fP... +.TP +\fI<필터>\fP +필터 이름 +.TP +\fI<옵션>\fP +필터별 옵션 이름 +.TP +\fI<값>\fP +숫자 \fI값\fP 범위는 \fB<\fP\fI최소\fP\fB\-\fP\fI최대\fP\fB>\fP입니다. 문자열 \fI값\fP은 \fB< >\fP 범위 +내에서 선택하며 \fB|\fP 문자로 구분합니다. +.PP +각 필터는 한 줄에 하나씩 출력합니다. +. +.SS "메모리 제한 정보" +\fBxz \-\-robot \-\-info\-memory\fP 명령은 탭으로 나뉜 여러 컬럼을 단일 행으로 나타냅니다: +.IP 1. 4 +물리 메모리(RAM)의 바이트 단위 총량. +.IP 2. 4 +압축 진행시 바이트 단위 메모리 사용 한계값 (\fB\-\-memlimit\-compress\fP). 특수 값 \fB0\fP은 단일\-스레드 모드에서 +제한을 두지 않는 기본 설정임을 나타냅니다. +.IP 3. 4 +압축 해제시 바이트 단위 메모리 사용 한계값 (\fB\-\-memlimit\-decompress\fP). 특수 값 \fB0\fP은 단일\-스레드 모드에서 +제한을 두지 않는 기본 설정임을 나타냅니다. +.IP 4. 4 +\fBxz\fP 5.3.4alpha 이후: 다중\-스레드 기반 압축 해제시 바이트 단위 메모리 +사용량(\fB\-\-memlimit\-mt\-decompress\fP). 분명하게 제한을 걸어두지 않았을 경우 5번째 컬럼에 나타난 시스템별 +기본값을 사용하기 때문에 0 값을 지정하면 안됩니다. 또한 \fB\-\-memlimit\-mt\-decompress\fP로 세번째 컬럼 값보다 더 +크게 지정을 한다 할지라도 이 값이 세번째 컬럼 값보다 크면 안됩니다. +.IP 5. 4 +\fBxz\fP 5.3.4alpha 이후: A system\-specific default memory usage limit that is +used to limit the number of threads when compressing with an automatic +number of threads (\fB\-\-threads=0\fP) and no memory usage limit has been +specified (\fB\-\-memlimit\-compress\fP). This is also used as the default value +for \fB\-\-memlimit\-mt\-decompress\fP. +.IP 6. 4 +\fBxz\fP 5.3.4alpha 이후: Number of available processor threads. +.PP +차후, \fBxz \-\-robot \-\-info\-memory\fP 출력에는 더 많은 내용이 들어가지만, 한 줄 이상은 넘어가지 않습니다. +. +.SS 버전 +\fBxz \-\-robot \-\-version\fP 은 \fBxz\fP 와 liblzma의 버전 번호를 다음 형식으로 나타냅니다: +.PP +\fBXZ_VERSION=\fP\fIXYYYZZZS\fP +.br +\fBLIBLZMA_VERSION=\fP\fIXYYYZZZS\fP +.TP +\fIX\fP +주 버전. +.TP +\fIYYY\fP +부 버전. 짝수가 안정 버전입니다. 홀수는 알파 또는 베타 버전입니다. +.TP +\fIZZZ\fP +안정 릴리스의 패치 수준 또는 개발 릴리스의 횟수입니다. +.TP +\fIS\fP +안정도. 0은 알파 버전, 1은 베타 버전을 나타내며, 2는 안정 버전을 나타냅니다. \fIS\fP는 \fIYYY\fP 값이 짝수라 해도 항상 +2여야 합니다. +.PP +\fBxz\fP 명령과 liblzma이 동일한 XZ 유틸리티 릴리스에서 나왔다면 두 행의 \fIXYYYZZZS\fP 값은 같습니다. +.PP +예제: 4.999.9beta는 \fB49990091\fP이며, 5.0.0은 \fB50000002\fP입니다. +. .SH "종료 상태" .TP \fB0\fP @@ -1128,7 +1210,7 @@ for \fB\-\-memlimit\-mt\-decompress\fP. .RS .PP .nf -\f(CWXZ_OPT=\-2v tar caf foo.tar.xz foo\fP +\f(CRXZ_OPT=\-2v tar caf foo.tar.xz foo\fR .fi .RE .RE @@ -1139,7 +1221,8 @@ for \fB\-\-memlimit\-mt\-decompress\fP. .RS .PP .nf -\f(CWXZ_OPT=${XZ_OPT\-"\-7e"} export XZ_OPT\fP +\f(CRXZ_OPT=${XZ_OPT\-"\-7e"} +export XZ_OPT\fR .fi .RE .RE @@ -1260,7 +1343,7 @@ XZ 임베디드는 BCJ 필터를 지원하지만, 기본 시작 오프셋만 지 .RS .PP .nf -\f(CWxz foo\fP +\f(CRxz foo\fR .fi .RE .PP @@ -1268,7 +1351,7 @@ XZ 임베디드는 BCJ 필터를 지원하지만, 기본 시작 오프셋만 지 .RS .PP .nf -\f(CWxz \-dk bar.xz\fP +\f(CRxz \-dk bar.xz\fR .fi .RE .PP @@ -1277,7 +1360,7 @@ XZ 임베디드는 BCJ 필터를 지원하지만, 기본 시작 오프셋만 지 .RS .PP .nf -\f(CWtar cf \- baz | xz \-4e > baz.tar.xz\fP +\f(CRtar cf \- baz | xz \-4e > baz.tar.xz\fR .fi .RE .PP @@ -1285,7 +1368,7 @@ XZ 임베디드는 BCJ 필터를 지원하지만, 기본 시작 오프셋만 지 .RS .PP .nf -\f(CWxz \-dcf a.txt b.txt.xz c.txt d.txt.lzma > abcd.txt\fP +\f(CRxz \-dcf a.txt b.txt.xz c.txt d.txt.lzma > abcd.txt\fR .fi .RE . @@ -1294,7 +1377,8 @@ GNU와 *BSD에서는 \fBfind\fP(1) 명령과 \fBxargs\fP(1) 명령으로 여 .RS .PP .nf -\f(CWfind . \-type f \e! \-name '*.xz' \-print0 \e | xargs \-0r \-P4 \-n16 xz \-T1\fP +\f(CRfind . \-type f \e! \-name '*.xz' \-print0 \e + | xargs \-0r \-P4 \-n16 xz \-T1\fR .fi .RE .PP @@ -1310,7 +1394,7 @@ GNU와 *BSD에서는 \fBfind\fP(1) 명령과 \fBxargs\fP(1) 명령으로 여 .RS .PP .nf -\f(CWxz \-\-robot \-\-list *.xz | awk '/^totals/{print $5\-$4}'\fP +\f(CRxz \-\-robot \-\-list *.xz | awk '/^totals/{print $5\-$4}'\fR .fi .RE .PP @@ -1320,7 +1404,11 @@ GNU와 *BSD에서는 \fBfind\fP(1) 명령과 \fBxargs\fP(1) 명령으로 여 .RS .PP .nf -\f(CWif ! eval "$(xz \-\-robot \-\-version 2> /dev/null)" || [ "$XZ_VERSION" \-lt 50000002 ]; then echo "Your xz is too old." fi unset XZ_VERSION LIBLZMA_VERSION\fP +\f(CRif ! eval "$(xz \-\-robot \-\-version 2> /dev/null)" || + [ "$XZ_VERSION" \-lt 50000002 ]; then + echo "Your xz is too old." +fi +unset XZ_VERSION LIBLZMA_VERSION\fR .fi .RE .PP @@ -1328,7 +1416,12 @@ GNU와 *BSD에서는 \fBfind\fP(1) 명령과 \fBxargs\fP(1) 명령으로 여 .RS .PP .nf -\f(CWNEWLIM=$((123 << 20))\ \ # 123 MiB OLDLIM=$(xz \-\-robot \-\-info\-memory | cut \-f3) if [ $OLDLIM \-eq 0 \-o $OLDLIM \-gt $NEWLIM ]; then XZ_OPT="$XZ_OPT \-\-memlimit\-decompress=$NEWLIM" export XZ_OPT fi\fP +\f(CRNEWLIM=$((123 << 20))\ \ # 123 MiB +OLDLIM=$(xz \-\-robot \-\-info\-memory | cut \-f3) +if [ $OLDLIM \-eq 0 \-o $OLDLIM \-gt $NEWLIM ]; then + XZ_OPT="$XZ_OPT \-\-memlimit\-decompress=$NEWLIM" + export XZ_OPT +fi\fR .fi .RE . @@ -1337,7 +1430,7 @@ GNU와 *BSD에서는 \fBfind\fP(1) 명령과 \fBxargs\fP(1) 명령으로 여 설정 조합만 다루기 때문에 꽤 쓸모가 있을 수도 있습니다. .PP \fB\-0\fP ... \fB\-9\fP 옵션의 설명에서 테이블의 CompCPU 컬럼과 \fB\-\-extreme\fP 옵션은 LZMA2 사전 설정을 -개별적으로 맞췄을 때 쓸만할 수도 있습니다. 여기 관련내용을 테이블 둘로 정리해서 모아보았습니다. +개별적으로 맞췄을 때 쓸만할 수도 있습니다. 여기 관련내용을 테이블 둘로 정리해서 모아보았습니다: .RS .PP .TS @@ -1362,7 +1455,7 @@ Preset;CompCPU .RS .PP .nf -\f(CWxz \-\-lzma2=preset=1,dict=32MiB foo.tar\fP +\f(CRxz \-\-lzma2=preset=1,dict=32MiB foo.tar\fR .fi .RE .PP @@ -1376,7 +1469,7 @@ Preset;CompCPU .RS .PP .nf -\f(CWxz \-vv \-\-lzma2=dict=192MiB big_foo.tar\fP +\f(CRxz \-vv \-\-lzma2=dict=192MiB big_foo.tar\fR .fi .RE .PP @@ -1391,7 +1484,7 @@ Preset;CompCPU .RS .PP .nf -\f(CWxz \-\-check=crc32 \-\-lzma2=preset=6e,dict=64KiB foo\fP +\f(CRxz \-\-check=crc32 \-\-lzma2=preset=6e,dict=64KiB foo\fR .fi .RE .PP @@ -1402,7 +1495,7 @@ Preset;CompCPU .RS .PP .nf -\f(CWxz \-\-lzma2=preset=6e,pb=0,lc=4 source_code.tar\fP +\f(CRxz \-\-lzma2=preset=6e,pb=0,lc=4 source_code.tar\fR .fi .RE .PP @@ -1411,7 +1504,7 @@ LZMA2와 다른 필터를 함께 사용하면 일부 파일 형식에 대해 압 .RS .PP .nf -\f(CWxz \-\-x86 \-\-lzma2 libfoo.so\fP +\f(CRxz \-\-x86 \-\-lzma2 libfoo.so\fR .fi .RE .PP @@ -1423,11 +1516,11 @@ LZMA2와 델타 필터는 비트맵 그림에 최적의 결과를 가져다줄 .PP 예를 들어 이미지를 압축하지 않은 비압축 TIFF로 저장해야 하는 경우가 있습니다. 델타 필터의 거리 매개변수는 그림에서 픽셀당 바이트 수에 일치하도록 설정합니다. 예를 들면, 24비트 RGB 비트맵의 경우 \fBdist=3\fP 거리 매개변수 값을 설정해야 하며, LZMA2 -압축시 3바이트 정렬을 따르도록 \fBpb=0\fP 값을 전달하는 방법도 바람직합니다. +압축시 3바이트 정렬을 따르도록 \fBpb=0\fP 값을 전달하는 방법도 바람직합니다: .RS .PP .nf -\f(CWxz \-\-delta=dist=3 \-\-lzma2=pb=0 foo.tiff\fP +\f(CRxz \-\-delta=dist=3 \-\-lzma2=pb=0 foo.tiff\fR .fi .RE .PP @@ -1438,8 +1531,8 @@ LZMA2와 델타 필터는 비트맵 그림에 최적의 결과를 가져다줄 \fBxzdec\fP(1), \fBxzdiff\fP(1), \fBxzgrep\fP(1), \fBxzless\fP(1), \fBxzmore\fP(1), \fBgzip\fP(1), \fBbzip2\fP(1), \fB7z\fP(1) .PP -XZ 유틸리티: <https://tukaani.org/xz/> +XZ 유틸리티: <https://tukaani.org/xz\-utils/> .br -XZ 임베디드: <https://tukaani.org/xz/embedded.html> +XZ 임베디드: <https://tukaani.org/xz/embedded/> .br LZMA SDK: <https://7\-zip.org/sdk.html> |