pack200 - JAR パックツール

pack200 [ options ] output-file JAR-file

オプションの指定順序に決まりはありません。コマンド行または properties ファイルに指定された最後のオプションが、それ以前に指定されたすべてのオプションより優先されます。

pack200 ツールは、Java gzip 圧縮プログラムを使用して、JAR ファイルを pack200 圧縮ファイルに変換する Java アプリケーションです。pack200 ファイルは高圧縮のファイルで、帯域幅の節約やダウンロード時間の短縮や直接配備することができます。

pack200 ツールには、圧縮エンジンの設定や微調整を行うオプションが用意されています。

一般的な使用方法:

% pack200 myarchive.pack.gz myarchive.jar

この例では、デフォルトの pack200 設定で、myarchive.pack.gz が作成されます。

-r --repack

myarchive.jar ファイルをパックしたあとにアンパックすることにより、JAR ファイルを生成します。生成されたファイルは、jarsigner(1) ツールの入力ファイルとして使用できます。

% pack200 --repack myarchive-packer.jar myarchive.jar

% pack200 --repack myarchive.jar

-g --no-gzip

pack200 ファイルを生成します。このオプションを指定するときは、適切な圧縮ツールを使用する必要があります。また、ターゲットシステムでは、対応する圧縮解除ツールを使用する必要があります。

% pack200 --no-gzip myarchive.pack myarchive.jar

-G --strip-debug

出力からデバッグ用の属性を削除します。たとえば、SourceFile、LineNumberTable、LocalVariableTable、LocalVariableTypeTable などの属性があります。これらの属性を削除すれば、ダウンロードとインストールのサイズは小さくなりますが、デバッガの機能は制限されます。

--keep-file-order

入力ファイル内のファイルの順序を維持します。これがデフォルトの動作です。

-O --no-keep-file-order

パックツールは、すべての要素を並べ替えて転送します。また、JAR ディレクトリ名を削除します。このため、ダウンロードのサイズは小さくなりますが、インデックスを始めとする JAR ファイルの最適化機能は正常に動作しなくなることがあります。

-Svalue --segment-limit=value

この値は、各アーカイブセグメントの予想ターゲットサイズ N (バイト単位) です。単一の入力ファイルの必要サイズが
N バイトを超えると、そのファイルには独立したアーカイブセグメントが割り当てられます。たとえば、これは特殊な例ですが、値が -1 の場合、すべての入力ファイルを含む単一の巨大なセグメントが生成されます。一方、値が 0 の場合、クラスごとにセグメントが 1 つずつ生成されます。アーカイブセグメントのサイズが大きければ大きいほど断片化は起こりにくく、圧縮率も高くなります。しかし、こうしたセグメントを処理するためには、大量のメモリーが必要になります。

各セグメントのサイズは、セグメント内で転送される入力ファイルのサイズと、このファイルの名前のサイズ、およびその他の転送プロパティーによって予測されます。

デフォルトは -1 ですが、これは、パッカーが常に単一のセグメント出力ファイルを作成することを意味します。非常に大きな出力ファイルが生成される場合には、セグメント化を使用するか、入力ファイルをより小さな JAR に分割することを強くお勧めします。

この制限が課されていない 10M バイトの JAR パックファイルは通常、元の 10% 程度のサイズにパックされます。しかし、パックツールでより大きな Java ヒープ (セグメントの制限の約 10 倍) を必要とする場合もあります。

-Evalue --effort=value

単一の 10 進数値を指定した場合、パックツールは、指定された圧縮率でアーカイブを圧縮します。レベル 1 の場合、圧縮速度は速くても圧縮率はそれほど高くありません。レベル 9 の場合、圧縮速度は遅くても圧縮率は高くなります。特殊な値 0 を指定した場合は、元の JAR ファイルを圧縮なしで直接コピーします。JSR 200 標準では、すべてのアンパックツールはこの特殊な処理をアーカイブ全体のパススルーとして理解する必要があります。

デフォルト値は 5 です。この場合、標準的な時間で、適度な圧縮が行われます。

-Hvalue --deflate-hint=value

デフォルト値を上書きし、入力情報を保持します。転送されるアーカイブのサイズは大きくなります。返される値は次のどれかになります。

true

false

どちらの場合でも、パックツールはデフレーションヒントを出力アーカイブに設定します。アーカイブ要素の個々のデフレーションヒントは転送しません。

keep

入力 JAR 内のデフレーションヒントを保持します。(これはデフォルトです。)

-mvalue --modification-time=value

返される値は次のどれかになります。

latest

パックツールは、元のアーカイブの全エントリの最終更新時刻か、そのセグメントのすべてのエントリの最終更新時刻を特定しようとします。この単一の値はセグメントの一部として転送され、各セグメントの全エントリに適用されます。この場合、すべてのインストールファイルに単一の日付が設定されるという問題はありますが、アーカイブの転送サイズを少し小さくすることができます。

keep

入力 JAR 内で見つかった変更時刻を維持します。(これはデフォルトです。)

-Pfile --pass-file=file

ファイルを圧縮せず、バイト単位で転送するように指定します。このオプションを繰り返し使用して、複数のファイルを指定できます。システムファイルセパレータが JAR ファイルセパレータ「/」に置き換えられる点を除き、パス名の変換は行われません。ファイル名は、JAR ファイル内の文字列と完全に一致していなければなりません。file にディレクトリ名を指定した場合、そのディレクトリ内のすべてのファイルが転送されます。

-Uaction --unknown-attribute=action

デフォルトの動作をオーバーライドします。つまり、不明な属性を含むクラスファイルを指定したアクションで転送します。アクションとして指定可能な値:

error

pack200 の操作に失敗し、適切な解説が表示されます。

strip

属性はドロップされます。注:VM 必須属性を削除すると、クラスローダーの障害が発生することがあります。

pass

この属性が検出された場合、クラス全体が 1 つのリソースとして転送されます。

-Cattribute-name=layout --class-attribute=attribute-name=action
-Fattribute-name=layout --field-attribute=attribute-name=action
-Mattribute-name=layout --method-attribute=attribute-name=action
-Dattribute-name=layout --code-attribute=attribute-name=action

これら 4 つのオプションでは、クラスエンティティーに Class 属性、Field 属性、Method 属性、Code 属性などの属性のレイアウトを指定できます。attribute-name には、これからレイアウトまたはアクションを定義する属性の名前を指定します。アクションとして指定可能な値:

some-layout-string

レイアウト言語は、JSR 200 仕様に定義されています。

例: --class-attribute=SourceFile=RUH

error

この属性が検出された場合、pack200 の操作に失敗し、適切な解説が表示されます。

strip

この属性が検出された場合、属性は出力から削除されます。注:VM 必須属性を削除すると、クラスローダーの障害が発生することがあります。

pass

この属性が検出された場合、クラス全体が 1 つのリソースとして転送されます。

例:--class-attribute=CompilationID=pass を指定すると、属性 CompilationID を含むクラスファイルがパススルーされます。パックツールは、その他のアクションを行いません。

-f pack.properties --config-file=pack.properties

コマンド行に、パックツールを初期化するための Java プロパティーが含まれている設定ファイルを指定できます。

% pack200 -f pack.properties myarchive.pack.gz myarchive.jar
% more pack.properties
# Generic properties for the packer.
modification.time=latest
deflate.hint=false
keep.file.order=false
# This option will cause the files bearing new attributes to
# be reported as an error rather than passed uncompressed.
unknown.attribute=error
# Change the segment limit to be unlimited.
segment.limit=-1

-v --verbose

最小限のメッセージを出力します。このオプションを複数指定すると、より長いメッセージが出力されます。

-q --quiet

メッセージを表示せずに動作します。

-lfilename --log-file=filename

出力メッセージのログファイルを指定します。

-? -h --help

このコマンドに関するヘルプ情報を出力します。

-V --version

このコマンドに関するバージョン情報を出力します。

-Joption

unpack200 によって呼び出される Java 起動ツールに option を渡します。たとえば、-J-Xms48m と指定すると、スタートアップメモリーは 48M バイトに設定されます。このオプションは -X で始まっていませんが、pack200 の標準オプションではありません。-J を使って、Java で記述されたベースとなる VM 実行アプリケーションにオプションを渡すことは、よく行われています。

次の終了値が返されます。

 0: 正常終了した場合。

>0: エラーが発生した場合。

このコマンドと pack(1) を混同しないでください。これらは別製品です。

SDK に付属する Java SE API 仕様との相違が見つかった場合には、仕様を優先してください。