1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319
|
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.\"
.\" Japanese Version Copyright (c) 1993-2012, 2022
.\" NetBSD jman proj., Yuichi SATO and Akihiro Motoki
.\" all rights reserved.
.\" Translated 1993-10-15, NetBSD jman proj. <jman@spa.is.uec.ac.jp>
.\" Updated 2000-06-09, Yuichi SATO <sato@complex.eng.hokudai.ac.jp>
.\" Updated 2012-04-20, Akihiro Motoki <amotoki@gmail.com>, gzip 1.4
.\" Updated 2022-05-13, Akihiro Motoki <amotoki@gmail.com>, gzip 1.12
.\"
.TH GZIP 1 local
.SH 名前
gzip, gunzip, zcat \- ファイルの圧縮、伸長を行う
.SH 書式
.ll +8
\fBgzip\fP [\fB \-acdfhklLnNrtvV19 \fP] [\fB\-S\ suffix\fP] [ \fIname \&...\fP ]
.ll -8
.br
\fBgunzip\fP [\fB \-acfhklLnNrtvV \fP] [\fB\-S\ suffix\fP] [ \fIname \&...\fP ]
.br
\fBzcat\fP [\fB \-fhLV \fP] [ \fIname \&...\fP ]
.SH 説明
\fIgzip\fP コマンドは Lempel\-Ziv コーディング (LZ77) を利用して、 指定されたファイルのサイズを削減します。 各ファイルは拡張子
\fB\&.gz\fP をつけたファイルに置き換えられ、 所有権、 アクセス時刻、 修正時刻は保持されます (デフォルトの拡張子は、 MSDOS, OS/2
FAT, Windows NT FAT, Atari では \fBz\fP です)。 ファイルが指定されない場合や、 ファイル名が "\-" の場合、
標準入力を圧縮して標準出力に書き出します。 \fBgzip\fP コマンドが圧縮対象とするのは、 通常のファイルだけです。 特に、
シンボリックリンクは無視されます。
.PP
圧縮されたファイル名が、 そのファイルシステム上では長すぎる場合、 \fBgzip\fP はファイル名を切り詰めます。 \fBgzip\fP はファイル名のうちの
4 文字以上のパートを切り詰めようとします (各パートはドットで区切られます)。 小さなパートのみからファイル名ができている場合、
最長のパートが切り詰められます。 たとえば、 ファイル名が 14 文字までに制限されている場合、 gzip.msdos.exe は
gzi.msd.exe.gz という名前で圧縮されます。 ファイル名の長さに制限がないシステムでは、 ファイル名が切り詰められることはありません。
.PP
デフォルトでは、 \fBgzip\fP は圧縮ファイルの中に元ファイルの名前とタイムスタンプを保存します。 これらの情報はファイルを \fB\-N\fP
オプションで伸長するときに使用されます。 これは、 圧縮されたファイルの名前が切り詰められた場合や、
ファイル転送の後でタイムスタンプが保存されなかった場合に役立ちます。
.PP
圧縮されたファイルは \fBgzip \-d\fP, \fBgunzip\fP, \fBzcat\fP を使うと元の形に復元することができます。
圧縮ファイルに保存された元ファイルの名前がファイルシステムに適合しない場合、 そのファイルシステムに適合するように元の名前から新しい名前が作られます。
.PP
\fBgunzip\fP は、 コマンドラインからファイルのリストを受け取り、 ファイル名の末尾が .gz, \-gz, .z, \-z, _z
(大文字小文字は区別しない) でファイルが正しいマジックナンバーで始まっている各ファイルを伸長したファイルに置き換えます。
このとき圧縮ファイルの拡張子は取り除かれます。 \fBgunzip\fP は \fB\&.tgz\fP と \fB\&.taz\fP という特別な拡張子も認識します。
これらはそれぞれ \fB\&.tar.gz\fP と \fB\&.tar.Z\fP の省略形です。 \fBgzip\fP は、 圧縮する際に、 必要であれば、 拡張子が
\fB\&.tar\fP のファイルの名前を切り詰める代わりに \fB\&.tgz\fP という拡張子を使用します。
.PP
現時点では、 \fBgunzip\fP は \fBgzip\fP, \fBzip\fP, \fBcompress\fP, \fBcompress \-H\fP, \fBpack\fP
で作られたファイルを正しく伸長できます。 入力形式の検知は自動的に行われます。 はじめの 2 つの形式を使った場合、 \fBgunzip\fP は 32
ビットの CRC をチェックします。 \fBpack\fP の場合、 \fBgunzip\fP は伸長した長さをチェックします。 標準的な \fBcompress\fP
形式は、 整合性チェックができるようには設計されていません。 しかし \fBgunzip\fP は壊れた .Z ファイルを検知することができる場合もあります。
\&.Z ファイルを伸長しているときにエラーが出たときには、 単に標準の \fBuncompress\fP がエラーを出さないという理由だけで .Z
ファイルが正しいと考えてはいけません。 一般的にいうと、 標準的な \fBuncompress\fP は入力をチェックせず、
脳天気にゴミを出力してしまうことがあります。 SCO の compress \-H 形式 (lzh 圧縮法) は CRC を含んでいないが、
いくつかの整合性チェックが可能です。
.PP
\fBzip\fP によって作られたファイルは、 元ファイルが 1 つだけ含まれ、 かつ、 そのファイルが 'deflation'
法で圧縮されている場合にのみ、 gzip で伸長できます。 この機能は、 tar.zip ファイルを tar.gz
形式へ変換する際の補助となることだけを意図したものです。 元ファイルが 1 つだけの \fBzip\fP ファイルを伸長するには、 \fBgunzip
<foo.zip\fP や \fBgunzip \-S .zip foo.zip\fP といったコマンドを使用します。 複数の元ファイルを含んでいる zip
ファイルを伸長するためには、 \fBgunzip\fP ではなく \fBunzip\fP を使ってください。
.PP
\fBzcat\fP コマンドは \fBgunzip\fP \fB\-c\fP と同一です。 (\fBcompress\fP へのオリジナルのリンクを保存するために、
\fBzcat\fP が \fBgzcat\fP としてインストールされているシステムもあるかもしれません。) \fBzcat\fP
はコマンドラインで指定されたファイルのリストまたは標準入力を伸長し、 伸長したデータを標準出力に書き出します。 \fBzcat\fP は、 ファイルが
\fB\&.gz\fP という拡張子であるかどうかにかかわらず、 正しいマジックナンバーを持っているファイルであれば伸長しようとします。
.PP
\fBgzip\fP コマンドは \fBzip\fP と PKZIP で使われている Lempel\-Ziv アルゴリズムを使用します。 得られる圧縮量は、
入力のサイズと共通の部分データ列の分布に依存します。 一般に、 ソースコードや英文といったテキストでは 60\-70% 小さくなります。
(\fBcompress\fP に使われている) LZW、 (\fBpack\fP に使われている) Huffman コーディング、 (\fBcompact\fP
に使われている) 適応 Huffman コーディング、 による圧縮に比べて、 この圧縮率は一般にかなり良いものです。
.PP
たとえ圧縮されたファイルが元ファイルより少し大きくなるとしても、 圧縮は常に行われます。 最悪の場合、 gzip ファイルヘッダーのための数バイトと
32 K バイトブロックごとに 5 バイトの増加となり、 大きなファイルでは 0.015% の増加率となります。 ただし、
実際の使用ディスクブロック数が増加することは、 ほぼ絶対にありません。
.PP
\fBgzip\fP は、 通常、 圧縮、伸長時にファイルのアクセス権、所有者、タイムスタンプを維持します。 適切な権限を有していれば、
ファイル所有者やグループについても維持されます。
.SH オプション
.TP
\fB\-a \-\-ascii\fP
アスキーテキストモード: 局所変換を使って行末の変換を行います。 このオプションは、 いくつかの非 Unix システムでサポートされています。
MSDOS では、 圧縮時に CR LF が LF に変換され、 伸長時に LF が CR LF に変換されます。
.TP
\fB\-c \-\-stdout \-\-to\-stdout\fP
出力を標準出力に書き出し、 元ファイルを変更しません。 入力ファイルが複数ある場合、 出力はファイル毎に圧縮された内容が連結されたものとなります。
圧縮率を上げるには、 圧縮する前にすべての入力ファイルを (tar などで) まとめてください。
.TP
\fB\-d \-\-decompress \-\-uncompress\fP
伸長します。
.TP
\fB\-f \-\-force\fP
ファイルが複数のリンクを張られていたり、 対応するファイルが既に存在していたり、 圧縮されたデータが端末に対して読み書きされてしているような場合でも、
強制的に圧縮、 伸長を行います。 入力データが \fBgzip\fP で認識できない形式のときに \-\-stdout オプションが指定されていると、
入力データは変更なしに標準出力にコピーされます。 つまり、 \fBzcat\fP を \fBcat\fP として動作させます。 \fB\-f\fP が指定されず、
かつバックグラウンドで動作していない場合、 \fBgzip\fP は既に存在するファイルを上書きするかを問い合わせるプロンプトを出力します。
.TP
\fB\-h \-\-help\fP
ヘルプ画面を表示して終了します。
.TP
\fB\-k \-\-keep\fP
圧縮中または伸長中に、 入力ファイルを保持します (削除しません)。
.TP
\fB\-l \-\-list\fP
圧縮された個々のファイルについて、 以下のフィールドを列挙します。
compressed size: 圧縮されたファイルのサイズ
uncompressed size: 伸長されたファイルのサイズ
ratio: 圧縮率 (不明の場合は 0.0%)
uncompressed_name: 伸長されたファイルの名前
compress でつくられた .Z ファイルのように、 gzip 形式でないファイルの伸長時サイズは \-1 と表示されます。
そのようなファイルについて伸長されたファイルのサイズを求める場合は、 以下のコマンドを使用してください。
zcat file.Z | wc \-c
\-\-verbose オプションと組み合わせると、以下のフィールドも表示されます。
method: 圧縮法
crc: 伸長されたデータの 32 ビット CRC
date & time: 伸長されたファイルのタイムスタンプ
現在サポートされている圧縮法は、 deflate, compress, lzh (SCO compress \-H), pack です。 gzip
形式でないファイルについて、 crc は ffffffff とされます。
\-\-name が同時に指定されると、 (もし記録されているなら) 伸長されたファイルの名前、 日付、 時刻は
圧縮ファイル内に記録されているものになります。
\-\-verbose が同時に指定されると、 どれかのファイルのサイズが不明でない限り、 サイズの合計と全体での圧縮率も表示されます。 \-\-quiet
が同時に指定されると、 タイトルと合計の行は表示されません。
.TP
\fB\-L \-\-license\fP
\fBgzip\fP のライセンスを表示して終了します。
.TP
\fB\-n \-\-no\-name\fP
デフォルトで圧縮時に元ファイルの名前とタイムスタンプを保存しません (元の名前を切り詰める必要がある場合は元の名前は必ず保存されます)。 伸長時に、
元のファイル名が存在しても復元せず (圧縮ファイル名から \fBgzip\fP 拡張子を取り除くだけとし)、
元ファイルのタイムスタンプが存在しても復元しません (圧縮ファイルから他インプスタンプをコピーします)。 このオプションは伸長時のデフォルトです。
.TP
\fB\-N \-\-name\fP
圧縮時には元のファイル名を必ず保存します。 また元のファイルが通常ファイルであって、 そのタイムスタンプが最低でも 1 (1970\-01\-01
00:00:01 UTC)、 さらに 2**32 (2106\-02\-07 06:28:16 UTC, うるう秒を考慮しない場合) 未満である場合に、
元のファイルの修正タイムスタンプの秒部分を保存します。 これがデフォルトの動作です。
伸長時には、ファイル名とタイムスタンプが保存されていれば復元します。 このオプションは、 ファイル名の長さに制限があるシステムや、
ファイル転送の後にタイムスタンプが失われた場合に役立ちます。
.TP
\fB\-q \-\-quiet\fP
すべての警告を抑制します。
.TP
\fB\-r \-\-recursive\fP
ディレクトリ構造を再帰的に辿ります。 コマンドラインで指定されたファイル名がディレクトリであった場合、 \fBgzip\fP は、 ディレクトリ内に入り、
見つかったすべてのファイルを圧縮します (\fBgunzip\fP の場合は、 すべてのファイルを伸長します)。
.TP
\fB\-S .suf \-\-suffix .suf\fP
圧縮時には、 拡張子 .gz のかわりに .suf を使う。 空でない任意の拡張子を指定できますが、 .z と .gz
以外の拡張子は使うべきでありません。 他のシステムにファイルが転送されたときの混乱を避けるためです。
伸長時には、 入力ファイル名から出力ファイル名を抜き出す際に確認する拡張子のリストの先頭に .suf を追加します。
.TP
\fB\-\-synchronous\fP
同期出力を行います。 このオプションを用いると、 システムクラッシュの際にデータを失う可能性が低くなりますが、 処理速度はかなり低下します。
.TP
\fB\-t \-\-test\fP
検査を行います。 圧縮ファイルの整合性をチェックして終了します。
.TP
\fB\-v \-\-verbose\fP
詳細出力。 圧縮、 伸長される各ファイルについて名前と圧縮率を表示します。
.TP
\fB\-V \-\-version\fP
バージョン。 バージョン番号とコンパイルオプションを表示して終了します。
.TP
\fB\-# \-\-fast \-\-best\fP
指定した数字 \fB#\fP を用いて圧縮のスピードを調整します。 \fB\-1\fP と \fB\-\-fast\fP は最も速い圧縮法を表します (圧縮率は低い)。
\fB\-9\fP と \fB\-\-best\fP は最も遅い圧縮法を表します (圧縮率は最も高い)。 デフォルトの圧縮レベルは \fB\-6\fP です (つまり、
速さを犠牲にして圧縮率の良い方にしてあります)。
.TP
\fB\-\-rsyncable\fP
2 つのコンピューター間で圧縮ファイルの同期を行う場合、 このオプションを用いると、 rsync
はアーカイブ全体ではなく変更があったファイルのみを転送できるようになります。 通常、 アーカイブ内のファイルに変更が行われた場合、
圧縮アルゴリズムは新たなバージョンのアーカイブを生成し、 このバージョンは以前のバージョンのアーカイブとは一致しません。 その場合 rsync は、
リモートコンピューターに対して新たなバージョンのアーカイブ全体を転送します。 このオプションを用いると、 rsync は、 変更がかかったファイル、
およびアーカイブ内の変更が行われた領域を更新するために必要な最小限のメタデータのみを転送できます。
.SH 高度な使用法
複数の圧縮ファイルは連結できます。 この場合、 \fBgunzip\fP はすべての圧縮ファイルを一度に伸長します。 たとえば、
gzip \-c file1 > foo.gz
gzip \-c file2 >> foo.gz
の後に
gunzip \-c foo
とするのは、 以下と同じです。
cat file1 file2
\&.gz ファイルのうち 1 つのファイルが壊れても、 (壊れたファイルを削除すれば) 他のファイルはまだ回復できます。 しかし、
次のようにすべてのファイルを一度に圧縮すれば、 より高い圧縮が得られます。
cat file1 file2 | gzip > foo.gz
これは下の例より高く圧縮できます。
gzip \-c file1 file2 > foo.gz
より高い圧縮を得るために、 結合されたファイルをもう一度圧縮するには、 次のようにしてください。
gzip \-cd old.gz | gzip > new.gz
圧縮ファイルが複数の元ファイルで構成されている場合、 \-\-list オプションで表示される伸長時のサイズと CRC は、
最後の元ファイルのもののみとなります。 すべての元ファイルについて伸長時のサイズが必要な場合は、 次のコマンドを使用してください。
gzip \-cd file.gz | wc \-c
複数の元ファイルからなる 1 つの書庫ファイルを作って、 後から元ファイルを別々に伸長できるようにしたいなら、 tar や zip
といったアーカイバーを使ってください。 GNU tar は gzip を透過的に起動するために \-z オプションをサポートしています。 gzip は
tar の代用としてではなく、 tar を補完するものとして設計されています。
.SH 環境変数
あまり使われなくなった機能ですが、 環境変数 \fBGZIP\fP で \fBgzip\fP のデフォルトのオプションセットを指定できます。
これらのオプションは最初に解釈され、 明示的にコマンドラインパラメーターを指定することでこれらを上書きできます。 ただし、
スクリプトを用いる際にはこの機能が問題になる場合があります。 したがって、 この機能は、
あまり支障がないと考えられるオプションに対してのみサポートされており、 仮に使用された場合 \fBgzip\fP は警告を表示します。 この機能は
\fBgzip\fP の将来のバージョンにおいて削除される予定です。
.PP
この代わりとして、 エイリアスやスクリプトを利用できます。 たとえば、 \fBgzip\fP がディレクトリ \fB/usr/bin\fP にある場合、
\fBPATH\fP 変数の先頭に \fB$HOME/bin\fP を追加し、 以下のような内容を含んだ実行スクリプト \fB$HOME/bin/gzip\fP
を作成します。
#! /bin/sh
export PATH=/usr/bin
exec gzip \-9 "$@"
.SH 関連項目
\fBznew\fP(1), \fBzcmp\fP(1), \fBzmore\fP(1), \fBzforce\fP(1), \fBgzexe\fP(1), \fBzip\fP(1),
\fBunzip\fP(1), \fBcompress\fP(1)
.PP
\fBgzip\fP ファイル形式は P. Deutsch, \s-1GZIP\s0 file format specification version
4.3, \fB<https://www.ietf.org/rfc/rfc1952.txt>\fP, Internet RFC 1952
(May 1996) で規定されています。 \fBzip\fP deflation 形式は P. Deutsch, \s-1DEFLATE\s0
Compressed Data Format Specification version 1.3,
\fB<https://www.ietf.org/rfc/rfc1951.txt>\fP, Internet RFC 1951 (May
1996) で規定されています。
.SH 診断メッセージ
通常、 終了ステータスは 0 です。 エラーが起きた場合、 終了ステータスは 1 です。 警告が起きた場合、 終了ステータスは 2 です。
.TP
Usage: gzip [\-cdfhklLnNrtvV19] [\-S suffix] [file ...]
無効なオプションがコマンドラインから指定されました。
.TP
\fIfile\fP\^: not in gzip format
\fBgunzip\fP に指示されたファイルが圧縮されたものではありません。
.TP
\fIfile\fP\^: Corrupt input. Use zcat to recover some data.
圧縮されたファイルが壊れています。 破損した位置までのデータは、 次のコマンドを使って修復できます。
zcat \fIfile\fP > recover
.TP
\fIfile\fP\^: compressed with \fIxx\fP bits, can only handle \fIyy\fP bits
\fBfile\fP が、 このマシン上での伸長コードより多くのビットを扱うことができるプログラムで (LZW を使って) 圧縮されています。
より高い圧縮ができ、 メモリ使用量の少ない、 gzip を使って ファイルを再圧縮してください。
.TP
\fIfile\fP\^: already has .gz suffix \-\- unchanged
ファイルが既に圧縮されていると考えられます。 ファイル名を変更し、 再度試みてください。
.TP
\fIfile\fP already exists; do you wish to overwrite (y or n)?
出力ファイルで置き換えたいなら "y" と答えてください。 そうでなければ、 "n" と答えてください。
.TP
gunzip: corrupt input
SIGSEGV 違反が検知されました。 通常は、 入力ファイルが壊れていることを意味します。
.TP
\fIxx.x%\fP 圧縮により節約された入力のパーセント表示。
(\fB\-v\fP と \fB\-l\fP のみに関連します。)
.TP
\-\- not a regular file or directory: ignored
入力ファイルが通常ファイルでもディレクトリでもない場合 (たとえば、 シンボリックリンク、 ソケット、 FIFO、 デバイスファイルの場合)、
変更せずにそのままにされます。
.TP
\-\- has \fIxx\fP other links: unchanged
入力ファイルにリンクが張られているので、 変更しません。 詳しい情報は \fBln\fP(1) を参照してください。
複数にリンクが張られているファイルを強制的に圧縮するには \fB\-f\fP フラグを使用してください。
.SH 重要な注意
圧縮されたデータをテープに書き込むときは、 一般的に、 出力のブロック境界をゼロで埋める必要があります。
伸長のためにデータを読み込んですべてのブロックを \fBgunzip\fP に渡すと、 \fBgunzip\fP は通常、
圧縮されたデータの後ろに余分なゴミが続いていると検知して、 警告を発します。 この警告を抑制するには \-\-quiet オプションを使用してください。
.SH バグ
まれに \-\-best オプションによって、 デフォルトの圧縮レベル (\-6) より 圧縮が悪くなることがあります。 非常に冗長なファイルでは、
\fBcompress\fP による圧縮が \fBgzip\fP より良くなることがあります。
.SH バグ報告
バグ報告: bug\-gzip@gnu.org
.br
GNU gzip ホームページ: <https://www.gnu.org/software/gzip/>
.br
GNU ソフトウェアを使用する際の一般的なヘルプ: <https://www.gnu.org/gethelp/>
.SH 著作権表示
Copyright \(co 1998\-1999, 2001\-2002, 2012, 2015\-2022 Free Software
Foundation, Inc.
.br
Copyright \(co 1992, 1993 Jean\-loup Gailly
.PP
Permission is granted to make and distribute verbatim copies of this manual
provided the copyright notice and this permission notice are preserved on
all copies.
.ig
Permission is granted to process this file through troff and print the
results, provided the printed document carries copying permission
notice identical to this one except for the removal of this paragraph
(this paragraph not being relevant to the printed manual).
..
.PP
Permission is granted to copy and distribute modified versions of this
manual under the conditions for verbatim copying, provided that the entire
resulting derived work is distributed under the terms of a permission notice
identical to this one.
.PP
Permission is granted to copy and distribute translations of this manual
into another language, under the above conditions for modified versions,
except that this permission notice may be stated in a translation approved
by the Foundation.
|