manual/GNU_gzip/release/man1/gzip.1

   1 .PU
   2 .\"*******************************************************************
   3 .\"
   4 .\" This file was generated with po4a. Translate the source file.
   5 .\"
   6 .\"*******************************************************************
   7 .TH GZIP 1 local
   8 .SH 名前
   9 gzip, gunzip, zcat \- ファイルの圧縮・伸長を行う
  10 .SH 書式
  11 .ll +8
  12 \fBgzip\fP [\fB \-acdfhlLnNrtvV19 \fP] [\fB\-S\ suffix\fP] [ \fIname \&...\fP ]
  13 .ll -8
  14 .br
  15 \fBgunzip\fP [\fB \-acfhlLnNrtvV \fP] [\fB\-S\ suffix\fP] [ \fIname \&...\fP ]
  16 .br
  17 \fBzcat\fP [\fB \-fhLV \fP] [ \fIname \&...\fP ]
  18 .SH 説明
  19 \fIgzip\fP は Lempel\-Ziv コーディング (LZ77) を利用して、 指定されたファイルのサイズを小さくする。
  20 各ファイルは所有権・アクセス時刻・修正時刻を保存したまま、 拡張子 \fB\&.gz\fP をつけたファイルに置き換えられる。
  21 (デフォルトの拡張子は、VMSでは \fB\-gz\fP, MSDOS, OS/2 FAT, Windows NT FAT, Atari では \fBz\fP
  22 である。)  ファイルが指定されない場合、またはファイル名が "\-" の場合、 標準入力を圧縮して標準出力に書き出す。 \fIgzip\fP
  23 は通常のファイルしか圧縮しようとしない。 特に、シンボリックリンクは無視される。
  24 .PP
  25 圧縮されたファイル名が、そのファイルシステム上では長すぎる場合、 \fIgzip\fP はファイル名を切り詰める。 \fIgzip\fP はファイル名のうちの 4
  26 文字以上のパートを切り詰めようとする。 (各パートはドットで区切られている。)  小さなパートだけからファイル名ができている場合、
  27 もっとも長いパートが切り詰められる。 例えば、ファイル名が 14 文字までに制限されている場合、 gzip.msdos.exe は
  28 gzi.msd.exe.gz という名前で圧縮される。 ファイル名の長さに制限がないシステムでは、 ファイル名が切り詰められることはない。
  29 .PP
  30 デフォルトでは、 \fIgzip\fP は圧縮ファイルの中に元ファイルの名前とタイムスタンプを保存する。 これらの情報はファイルを \fB\-N\fP
  31 オプションで伸長するときに使われる。 これは、圧縮されたファイルの名前が切り詰められた場合や、
  32 ファイル転送の後でタイムスタンプが保存されなかった場合に役立つ。
  33 .PP
  34 圧縮されたファイルは \fIgzip \-d\fP, \fIgunzip\fP, \fIzcat\fP を使うと元の形に復元することができる。
  35 圧縮ファイルに保存された元ファイルの名前がファイルシステムに適合しない場合、 そのファイルシステムに適合するように元の名前から新しい名前が作られる。
  36 .PP
  37 \fIgunzip\fP は、ファイル名が .gz, \-gz, .z, \-z, _z, .Z でおわっており、
  38 正しいマジックナンバーで始まっているファイルのリストを コマンドラインから受け取り、 伸長したファイルに置き換える。
  39 このとき圧縮ファイルの拡張子は取り除かれる。 \fIgunzip\fP は \fB\&.tgz\fP と \fB\&.taz\fP という特別な拡張子も認識する。
  40 これらはそれぞれ、 \fB\&.tar.gz\fP と \fB\&.tar.Z\fP の省略形である。 圧縮するときに \fB\&.tar\fP
  41 という拡張子をもつファイルの名前を切り詰める必要があるなら、 \fIgzip\fP はかわりに \fB\&.tgz\fP という拡張子を使う。
  42 .PP
  43 \fIgunzip\fP は \fIgzip, zip, compress, compress \-H, pack\fP で作られたファイルを正しく伸長できる。
  44 入力形式の検知は自動的に行われる。 はじめの 2 つの形式を使った場合、 \fIgunzip\fP は 32 ビットの CRC をチェックする。
  45 \fIpack\fP に対して、gunzip は伸長した長さをチェックする。 標準的な \fIcompress\fP
  46 形式は、整合性チェックをするようには設計されていない。 しかし、 \fIgunzip\fP は壊れた .Z ファイルを検知することができる場合もある。.Z
  47 ファイルを 伸長しているときにエラーが出たときには、 単に標準の \fIuncompress\fP がエラーを出さないという理由で .Z
  48 ファイルが正しいと考えてはならない。 一般的にいうと、標準的な \fIuncompress\fP
  49 は入力をチェックせず、脳天気にゴミを出力してしまうことがある。 SCO の compress \-H 形式 (lzh 圧縮法) は CRC
  50 を含んでいないが、いくつかの整合性チェックができる。
  51 .PP
  52 \fIzip\fP によって作られたファイルは、'deflation' 法で圧縮された元ファイルを 1 つしか含まない場合にだけ、gzip
  53 で伸長することができる。 この特徴は、tar.zip ファイルを tar.gz 形式へ変換する際の 補助となることだけを意図している。
  54 複数の元ファイルを含んでいる zip ファイルを伸長するためには、 \fIgunzip\fP ではなく \fIunzip\fP を使うこと。
  55 .PP
  56 \fIzcat\fP は \fIgunzip\fP \fB\-c\fP と同一である。 (\fIcompress\fP へのオリジナルのリンクを保存するために、 \fIzcat\fP
  57 が \fIgzcat\fP としてインストールされているシステムがあるかもしれない。)  \fIzcat\fP
  58 はコマンドラインで指示されるファイルのリストまたは標準入力を伸長し、 伸長したデータを標準出力に書き出す。 \fIzcat\fP はファイルが
  59 \fB\&.gz\fP という拡張子であるかどうかわらず、 正しいマジックナンバーを持っているファイルであれば伸長しようとする。
  60 .PP
  61 \fIgzip\fP は \fIzip\fP と PKZIP で使われている Lempel\-Ziv アルゴリズムを使う。
  62 得られる圧縮量は、入力のサイズと共通の部分データ列の分布に依存する。 一般に、ソースコードや英文といったテキストでは 60\-70% 小さくなる。
  63 (\fIcompress\fP に使われている) LZW・ (\fIpack\fP に使われている) Huffman コーディング・ (\fIcompact\fP
  64 に使われている) 適応 Huffman コーディング、 これらによる圧縮に比べて、この圧縮率は一般にかなり良い。
  65 .PP
  66 たとえ圧縮されたファイルが元ファイルより少し大きくなるとしても、 圧縮は常に行われる。 最悪の場合、gzip ファイルヘッダのための数バイトと 32K
  67 バイトブロック毎に 5 バイトの増加となり、 大きなファイルでは 0.015% の増加率となる。 ただし実際の使用ディスクブロック数は、
  68 ほとんど絶対に増加しない。 \fIgzip\fP は圧縮・伸長時にファイルのアクセス権・所有者・タイムスタンプを保存する。
  69
  70 .SH オプション
  71 .TP
  72 \fB\-a \-\-ascii\fP
  73 アスキーテキストモード：局所変換を使って行末の変換をする。 このオプションはいくつかの非 Unix システムでサポートされている。 MSDOS
  74 では、圧縮時に CR LF が LF に変換され、 伸長時に LF が CR LF に変換される。
  75 .TP
  76 \fB\-c \-\-stdout \-\-to\-stdout\fP
  77 出力を標準出力に書き出し、元ファイルを変更しない。 入力ファイルが複数ある場合、出力はファイル毎に圧縮されたものとなる。
  78 圧縮率を上げるには、圧縮する前にすべての入力ファイルを (tar などで) まとめること。
  79 .TP
  80 \fB\-d \-\-decompress \-\-uncompress\fP
  81 伸長する。
  82 .TP
  83 \fB\-f \-\-force\fP
  84 ファイルが複数のリンクを張られていたり、 対応するファイルが既に存在していたり、 圧縮されたデータが端末に対して読み書きされてしているような場合でも、
  85 強制的に圧縮・伸長を行う。 入力データが \fIgzip\fP で認識できない形式のときに \-\-stdout オプションが指定されていると、
  86 入力データは変更なしに標準出力にコピーされる。 つまり、 \fIzcat\fP を \fIcat\fP として動作させる。 \fB\-f\fP
  87 が指定されず、かつバックグラウンドで動作していない場合、 \fIgzip\fP は既に存在するファイルを上書きするかを問い合わせるプロンプトを出す。
  88 .TP
  89 \fB\-h \-\-help\fP
  90 ヘルプ画面を表示して終了する。
  91 .TP
  92 \fB\-l \-\-list\fP
  93 圧縮された個々のファイルについて、以下のフィールドを列挙する。
  94
  95     compressed size: 圧縮されたファイルのサイズ
  96     uncompressed size: 伸長されたファイルのサイズ
  97     ratio: 圧縮率 (不明の場合は 0.0%)
  98     uncompressed_name: 伸長されたファイルの名前
  99
 100 compress でつくられた .Z ファイルのように、 gzip 形式でないファイルの伸長時サイズは \-1 にされる。
 101 そのようなファイルについて伸長されたファイルのサイズを求める場合は、
 102
 103     zcat file.Z | wc \-c
 104
 105 を使うこと。\-\-verbose オプションと組み合わせると 以下のフィールドも表示される。
 106
 107     method: 圧縮法
 108     crc: 伸長されたデータの 32 ビット CRC
 109     date & time: 伸長されたファイルのタイムスタンプ
 110
 111 現在サポートされている圧縮法は、deflate, compress, lzh (SCO compress \-H), pack である。 gzip
 112 形式でないファイルについて、crc は ffffffff とされる。
 113
 114 \-\-name が同時に指定されると、(もし記録されているなら)  伸長されたファイルの名前・日付・時刻は 圧縮ファイル内に記録されているものになる。
 115
 116 \-\-verbose が同時に指定されると、どれかのファイルのサイズが不明でない限り、 サイズの合計とその圧縮率も表示される。 \-\-quiet
 117 が同時に指定されると、タイトルと合計の行は表示されない。
 118 .TP
 119 \fB\-L \-\-license\fP
 120 \fIgzip\fP のライセンスを表示して終了する。
 121 .TP
 122 \fB\-n \-\-no\-name\fP
 123 デフォルトでは、圧縮時に元ファイルの名前とタイムスタンプを保存させない。 (元の名前を切り詰める必要がある場合は、元の名前は必ず保存される。)
 124 伸長時に、元のファイル名が存在しても復元せず (圧縮ファイル名から \fIgzip\fP 拡張子を取り除くだけとし)、
 125 元ファイルのタイムスタンプが存在しても復元しない (圧縮ファイルからコピーする)。 このオプションは伸長時のデフォルトである。
 126 .TP
 127 \fB\-N \-\-name\fP
 128 圧縮時に元ファイルの名前とタイムスタンプを保存する。 これがデフォルトである。 伸長時に元ファイルの名前とタイムスタンプが存在するなら復元する。
 129 このオプションは、ファイル名の長さに制限があるシステムや、 ファイル転送の後にタイムスタンプが失われた場合に役立つ。
 130 .TP
 131 \fB\-q \-\-quiet\fP
 132 すべての警告を抑制する。
 133 .TP
 134 \fB\-r \-\-recursive\fP
 135 ディレクトリ構造を再帰的に巡る。 コマンドラインで指定されたファイル名がディレクトリであった場合、 \fIgzip\fP
 136 はディレクトリに降りて、見つかったすべてのファイルを圧縮する (\fIgunzip\fP の場合は、すべてのファイルを伸長する)。
 137 .TP
 138 \fB\-S .suf \-\-suffix .suf\fP
 139 拡張子 .gz のかわりに .suf を使う。 どのような拡張子でも指定することができるが、.z と .gz 以外の拡張子は 使うべきでない。
 140 他のシステムにファイルが転送されたときの混乱を避けるためである。 拡張子なしの場合、以下のように拡張子に関係なく、 すべての指示されたファイルを
 141 gunzip に伸長させることができる。
 142
 143     gunzip \-S "" *       (MSDOS の場合は *.*)
 144
 145 前のバージョンの gzip は拡張子 .z を使った。 これは \fIpack\fP(1)  との衝突を避けるために変更された。
 146 .TP
 147 \fB\-t \-\-test\fP
 148 テストする。圧縮ファイルの整合性をチェックする。
 149 .TP
 150 \fB\-v \-\-verbose\fP
 151 詳細出力。圧縮・伸長される各ファイルについて名前と圧縮率を表示する。
 152 .TP
 153 \fB\-V \-\-version\fP
 154 バージョン。バージョン番号とコンパイルオプションを表示して終了する。
 155 .TP
 156 \fB\-# \-\-fast \-\-best\fP
 157 指定した数字 \fI#\fP を用いて圧縮のスピードを調整する。 \fB\-1\fP と \fB\-\-fast\fP は最も速い圧縮法を示す (圧縮率は低い)。 \fB\-9\fP
 158 と \fB\-\-best\fP は最も遅い圧縮法を示す (圧縮率は最も高い)。 デフォルトの圧縮レベルは \fB\-6\fP である
 159 (つまり、速さを犠牲にして圧縮率の良い方にしてある)。
 160 .SH 高度な使用法
 161 複数の圧縮ファイルを連結することができる。 この場合、 \fIgunzip\fP はすべての圧縮ファイルを一度に伸長する。たとえば、
 162
 163       gzip \-c file1  > foo.gz
 164       gzip \-c file2 >> foo.gz
 165
 166 の後
 167       gunzip \-c foo
 168
 169 とするのは、以下と同じである。
 170
 171       cat file1 file2
 172
 173 \&.gz ファイルのうち 1 つのファイルが壊れても、 (壊れたファイルを削除すれば) 他のファイルはまだ回復できる。
 174 しかし、次のようにすべてのファイルを一度に圧縮すれば、より高い圧縮が得られる。
 175
 176       cat file1 file2 | gzip > foo.gz
 177
 178 これは下の例より高く圧縮できる。
 179
 180       gzip \-c file1 file2 > foo.gz
 181
 182 より高い圧縮を得るために、結合されたファイルをもう一度圧縮するには、 次のようにすること。
 183
 184       gzip \-cd old.gz | gzip > new.gz
 185
 186 圧縮ファイルが複数の元ファイルで構成されている場合、 \-\-list オプションで表示される伸長時のサイズと CRC は、
 187 最後の元ファイルについてのみ適用されたものである。 すべての元ファイルについて伸長時のサイズが必要な場合は、 次のコマンドを使うこと。
 188
 189       gzip \-cd file.gz | wc \-c
 190
 191 複数の元ファイルからなる 1 つの書庫ファイルを作って、 後から元ファイルを別々に伸長できるようにしたいなら、 tar や zip
 192 といったアーカイバーを使うこと。 GNU tar は gzip を透過的に起動するために \-z オプションをサポートしている。 gzip は tar
 193 の代用としてではなく、補助として設計されている。
 194 .SH 環境変数
 195 環境変数
 196 \fBGZIP\fP
 197 に
 198 \fIgzip\fP
 199 のデフォルトのオプションセットを入れることができる。
 200 これらのオプションは最初に解釈されるので、
 201 明示的なコマンドラインパラメータで上書きすることができる。
 202 例を示す。
 203       sh の場合:    GZIP="\-8v \-\-name"; export GZIP
 204       csh の場合:   setenv GZIP "\-8v \-\-name"
 205       MSDOS の場合: set GZIP=\-8v \-\-name
 206
 207 Vax/VMS では、環境変数の名前は GZIP_OPT である。 これは、プログラムを呼び出すためのシンボルセットとの衝突を避けるためである。
 208 .SH 関連項目
 209 znew(1), zcmp(1), zmore(1), zforce(1), gzexe(1), zip(1), unzip(1),
 210 compress(1), pack(1), compact(1)
 211 .SH 返り値
 212 通常、終了状態は 0 である。 エラーが起きた場合、終了状態は 1 である。 警告が起きた場合、終了状態は 2 である。
 213 .PP
 214 Usage: gzip [\-cdfhlLnNrtvV19] [\-S suffix] [file ...]
 215 .in +8
 216 無効なオプションがコマンドラインから指定された。
 217 .in -8
 218 \fIfile\fP: not in gzip format
 219 .in +8
 220 \fIgunzip\fP に指示されたファイルが圧縮されたものではない。
 221 .in -8
 222 \fIfile:\fP Corrupt input. Use zcat to recover some data.
 223 .in +8
 224 圧縮されたファイルが壊れている。 破損した位置までのデータは、次のコマンドを使って修復できる。
 225 .in +8
 226 zcat file > recover
 227 .in -16
 228 \fIfile\fP: compressed with \fIxx\fP bits, can only handle \fIyy\fP bits
 229 .in +8
 230 \fIファイル\fP が、このマシン上での伸長コードより多くの \fIビット\fP を扱うことができるプログラムで (LZW を使って) 圧縮されている。
 231 より高い圧縮ができ、メモリ使用量の少ない、gzip を使って ファイルを再圧縮すること。
 232 .in -8
 233 \fIfile\fP: already has .gz suffix \-\- no change
 234 .in +8
 235 ファイルが既に圧縮されていると考えられる。 ファイル名を変更し、再度試みること。
 236 .in -8
 237 \fIfile\fP already exists; do you wish to overwrite (y or n)?
 238 .in +8
 239 出力ファイルで置き換えたいなら "y" と答えること。 さもなければ、"n" と答えること。
 240 .in -8
 241 gunzip: corrupt input
 242 .in +8
 243 SIGSEGV 違反が検知された。通常は、入力ファイルが壊れていることを意味している。
 244 .in -8
 245 \fIxx.x%\fP
 246 .in +8
 247 圧縮により減った入力のパーセント表示。 (\fB\-v\fP と \fB\-l\fP のみに関連する。)
 248 .in -8
 249 \-\- not a regular file or directory: ignored
 250 .in +8
 251 入力ファイルが通常ファイルでもディレクトリでもない場合 (たとえば、シンボリックリンク・ソケット・FIFO・デバイスファイルの場合)、
 252 変更せずにそのままにされる。
 253 .in -8
 254 \-\- has \fIxx\fP other links: unchanged
 255 .in +8
 256 入力ファイルにリンクが張られているので、変更しない。 詳しい情報は \fIln\fP(1)  を参照すること。
 257 複数にリンクが張られているファイルを強制的に圧縮するには \fB\-f\fP フラグを使うこと。
 258 .in -8
 259 .SH 重要な注意
 260 圧縮されたデータをテープに書き込むときは、
 261 一般的に、出力のブロック境界をゼロで埋める必要がある。
 262 伸長のためにデータを読み込んですべてのブロックを
 263 \fIgunzip\fP
 264 に渡すと、
 265 \fIgunzip\fP
 266 は通常、圧縮されたデータの後ろに余分なゴミが続いていると検知して、
 267 警告を発する。
 268 この警告を抑制するには \-\-quiet オプションを使う必要がある。
 269 このオプションは環境変数
 270 \fBGZIP\fP
 271 に次のようにして設定できる。
 272   sh の場合:  GZIP="\-q"  tar \-xfz \-\-block\-compress /dev/rst0
 273   csh の場合: (setenv GZIP \-q; tar \-xfz \-\-block\-compress /dev/rst0
 274
 275 上の例では、gzip は GNU tar の \-z オプションによって暗に呼び出されている。 テープ上の圧縮されたデータの読み出しと書き込みに
 276 同じブロックサイズ (tar の \-b オプション) が使われていることに注意すること。 (この例は、GNU 版の tar を使うことを仮定している。)
 277 .SH バグ
 278 サイズが 2GB を越える場合、\-\-list オプションによる表示は正しくない。 圧縮ファイルがシーク不可媒体の上に存在する場合、 \-\-list
 279 オプションによる表示は、サイズが \-1、crc が ffffffff となる。
 280
 281 稀に \-\-best オプションによって、デフォルトの圧縮レベル (\-6) より 圧縮が悪くなることがある。 非常に冗長なファイルでは、
 282 \fIcompress\fP による圧縮が \fIgzip\fP より良くなることがある。