1 ." Copyright (c) 2004, 2011, Oracle and/or its affiliates. All rights reserved. 2 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 3 ." 4 ." This code is free software; you can redistribute it and/or modify it 5 ." under the terms of the GNU General Public License version 2 only, as 6 ." published by the Free Software Foundation. 7 ." 8 ." This code is distributed in the hope that it will be useful, but WITHOUT 9 ." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 10 ." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 11 ." version 2 for more details (a copy is included in the LICENSE file that 12 ." accompanied this code). 13 ." 14 ." You should have received a copy of the GNU General Public License version 15 ." 2 along with this work; if not, write to the Free Software Foundation, 16 ." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 17 ." 18 ." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA 19 ." or visit www.oracle.com if you need additional information or have any 20 ." questions. 21 ." 22 .TH pack200 1 "07 May 2011" 23 24 .LP 25 .SH "名前" 26 pack200 \- JAR パックツール 27 .LP 28 .RS 3 29 .TP 2 30 o 31 形式 32 .TP 2 33 o 34 説明 35 .TP 2 36 o 37 オプション 38 .TP 2 39 o 40 終了ステータス 41 .TP 2 42 o 43 関連項目 44 .TP 2 45 o 46 注意事項 47 .RE 48 49 .LP 50 .SH "形式" 51 .LP 52 .LP 53 \f4pack200\fP\f2 [ \fP\f2options\fP ] \f2output\-file\fP \f2JAR\-file\fP 54 .LP 55 .LP 56 オプションの指定順序に決まりはありません。コマンド行または properties ファイルに指定された最後のオプションが、それ以前に指定されたすべてのオプションより優先されます。 57 .LP 58 .RS 3 59 .TP 3 60 options 61 コマンド行オプション。 62 .TP 3 63 output\-file 64 出力ファイルの名前。 65 .TP 3 66 JAR\-file 67 入力ファイルの名前。 68 .RE 69 70 .LP 71 .SH " 説明" 72 .LP 73 .LP 74 \f2pack200\fP ツールは、Java gzip 圧縮プログラムを使用して JAR ファイルを \f2pack200\fP 圧縮ファイルに変換する \f2Java アプリケーション\fP です。 \f2pack200\fP ファイルは高圧縮のファイルで、帯域幅の節約やダウンロード時間の短縮や直接配備することができます。 75 .LP 76 .LP 77 \f2pack200\fP ツールには、圧縮エンジンの設定や微調整を行うオプションが用意されています。 78 .LP 79 .SS 80 一般的な使用方法: 81 .LP 82 .LP 83 \f2% pack200 myarchive.pack.gz myarchive.jar\fP 84 .LP 85 .LP 86 この例では、 \f2デフォルトの pack200 設定を使用して\fP myarchive.pack.gz \f2が生成されます\fP 。 87 .LP 88 .SH "オプション" 89 .LP 90 .LP 91 \f4\-r \-\-repack\fP 92 .LP 93 .LP 94 ファイル \f2myarchive.jar\fP をパックしたあとアンパックすることで、JAR ファイルを生成します。生成されたファイルは \f2jarsigner(1)\fP ツールの入力ファイルとして使用できます。 95 .LP 96 .LP 97 \f2% pack200 \-\-repack myarchive\-packer.jar myarchive.jar\fP 98 .LP 99 .LP 100 \f2% pack200 \-\-repack myarchive.jar\fP 101 .LP 102 .LP 103 \f4\-g \-\-no\-gzip\fP 104 .LP 105 .LP 106 \f2pack200\fP ファイルを生成します。このオプションを指定するときは、適切な圧縮ツールを使用する必要があります。また、ターゲットシステムでは、対応する圧縮解除ツールを使用する必要があります。 107 .LP 108 .LP 109 \f2% pack200 \-\-no\-gzip myarchive.pack myarchive.jar\fP 110 .LP 111 .LP 112 \f4\-G \-\-strip\-debug\fP 113 .LP 114 .LP 115 出力からデバッグ用の属性を削除します。そうした属性としては、 \f2SourceFile\fP、 \f2LineNumberTable\fP、 \f2LocalVariableTable\fP 、 \f2LocalVariableTypeTable\fP などが挙げられます。これらの属性を削除すれば、ダウンロードとインストールのサイズは小さくなりますが、デバッガの機能は制限されます。 116 .LP 117 .LP 118 \f4\-\-keep\-file\-order\fP 119 .LP 120 .LP 121 入力ファイル内のファイルの順序を維持します。これがデフォルトの動作です。 122 .LP 123 .LP 124 \f4\-O \-\-no\-keep\-file\-order\fP 125 .LP 126 .LP 127 パックツールは、すべての要素を並べ替えて転送します。また、JAR ディレクトリ名を削除します。このため、ダウンロードのサイズは小さくなりますが、インデックスをはじめとする JAR ファイルの最適化機能は正常に動作しなくなることがあります。 128 .LP 129 .LP 130 \f4\-Svalue \-\-segment\-limit=\fP\f2value\fP 131 .LP 132 .LP 133 この値は、各アーカイブセグメントの予想ターゲットサイズ N (バイト単位) です。単一の入力ファイルの必要サイズが 134 .br 135 N バイトを超えると、そのファイルには独立したアーカイブセグメントが割り当てられます。特殊なケースとして、値が \f2\-1\fP の場合は、すべての入力ファイルを含む大きな単一のセグメントが生成され、値が \f20\fP の場合は、クラスごとにセグメントが 1 つずつ生成されます。アーカイブセグメントが大きくなると、断片化が少なくなり圧縮率が高くなりますが、その処理には多くのメモリーが必要です。 136 .LP 137 .LP 138 各セグメントのサイズは、セグメントに変換されるそれぞれの入力ファイルのサイズのほか、その名前とほかの送信されるプロパティーのサイズを計算して推測されます。 139 .LP 140 .LP 141 デフォルトは \-1 です。つまり、パックツールは常に単一のセグメント出力ファイルを作成します。極端に大きな出力ファイルが生成される場合には、入力ファイルをセグメント化 (分割) してより小さな JAR にすることを強くお勧めします。 142 .LP 143 .LP 144 この制限が課されていない 10M バイトの JAR パックファイルは通常、元の 10% 程度のサイズにパックされます。しかし、パックツールでより大きな Java ヒープ (セグメントの制限の約 10 倍) を必要とする場合もあります。 145 .LP 146 .LP 147 \f4\-Evalue \-\-effort=\fP\f2value\fP 148 .LP 149 .LP 150 単一の 10 進数値を指定した場合、パックツールは、指定された圧縮率でアーカイブを圧縮します。レベル \f21\fP の場合は、比較的短い圧縮時間でやや大きめのファイルが生成されますが、レベル \f29\fP の場合は、非常に長い時間がかかるものの、より圧縮率の高いファイルが生成されます。特殊な値 \f20\fP を指定した場合は、元の JAR ファイルを圧縮なしで直接コピーします。JSR 200 標準では、すべての解凍プログラムが、この特別な場合をアーカイブ全体のパススルーと解釈するように規定しています。 151 .LP 152 .LP 153 デフォルトは \f25\fPです。この場合、標準的な時間で適切な圧縮が行われます。 154 .LP 155 .LP 156 \f4\-Hvalue \-\-deflate\-hint=\fP\f2value\fP 157 .LP 158 .LP 159 デフォルト値を上書きし、入力情報を保存します。転送されるアーカイブのサイズは大きくなります。返される値は次のどれかになります。 160 .LP 161 .RS 3 162 .TP 3 163 true 164 .TP 3 165 false 166 どちらの場合でも、パックツールはデフレーションヒントを出力アーカイブに設定します。アーカイブ要素の個々のデフレーションヒントは転送しません。 167 .RE 168 169 .LP 170 .RS 3 171 .TP 3 172 keep 173 入力 JAR.内で見つかったデフレーションヒントを維持します。(これがデフォルトです。) 174 .RE 175 176 .LP 177 .LP 178 \f4\-mvalue \-\-modification\-time=\fP\f2value\fP 179 .LP 180 .LP 181 返される値は次のどれかになります。 182 .LP 183 .RS 3 184 .TP 3 185 latest 186 パックツールは、元のアーカイブの全エントリの最終更新時刻か、そのセグメントのすべてのエントリの最終更新時刻を特定しようとします。この単一の値はセグメントの一部として転送され、各セグメントの全エントリに適用されます。この場合、すべてのインストールファイルに単一の日付が設定されるという問題はありますが、アーカイブの転送サイズを少し小さくすることができます。 187 .TP 3 188 keep 189 入力 JAR. 内で見つかった変更時刻を維持します。(これがデフォルトです。) 190 .RE 191 192 .LP 193 .LP 194 \f4\-Pfile \-\-pass\-file=\fP\f2file\fP 195 .LP 196 .LP 197 ファイルを圧縮せず、バイト単位で転送するように指定します。このオプションを繰り返し使用して、複数のファイルを指定できます。システムファイルセパレータが JAR ファイルセパレータ「\f2/\fP」に置き換えられる点を除き、パス名の変換は行われません。 結果として得られるファイル名は、文字列として正確に JAR ファイルでの出現と一致している必要があります。file にディレクトリ名を指定した場合、そのディレクトリ内のすべてのファイルが転送されます。 198 .LP 199 .LP 200 \f4\-Uaction \-\-unknown\-attribute=\fP\f2action\fP 201 .LP 202 .LP 203 デフォルトの動作を無効にします。たとえば、不明な属性を含むクラスファイルを指定したアクションで転送します。アクションとして指定可能な値: 204 .LP 205 .RS 3 206 .TP 3 207 error 208 \f2pack200\fP の操作に失敗し、適切な解説が表示されます。 209 .TP 3 210 strip 211 属性はドロップされます。注: VM 必須属性を削除するとクラスローダーの障害が発生することがあります。 212 .TP 3 213 pass 214 この属性が検出された場合、クラス全体が 1 つのリソースとして転送されます。 215 .RE 216 217 .LP 218 .LP 219 \f4\-Cattribute\-name=\fP\f2layout\fP \f3\-\-class\-attribute=\fP\f2attribute\-name=action\fP 220 .br 221 \f4\-Fattribute\-name=\fP\f2layout\fP \f3\-\-field\-attribute=\fP\f2attribute\-name=action\fP 222 .br 223 \f4\-Mattribute\-name=\fP\f2layout\fP \f3\-\-method\-attribute=\fP\f2attribute\-name=action\fP 224 .br 225 \f4\-Dattribute\-name=\fP\f2layout\fP \f3\-\-code\-attribute=\fP\f2attribute\-name=action\fP 226 .LP 227 .LP 228 これら 4 つのオプションでは、クラスエンティティーに Class 属性、Field 属性、Method 属性、Code 属性などの属性のレイアウトを指定できます。attribute\-name には、これからレイアウトまたはアクションを定義する属性の名前を指定します。アクションとして指定可能な値: 229 .LP 230 .RS 3 231 .TP 3 232 some\-layout\-string 233 レイアウト言語は、JSR 200 仕様に定義されています。 234 .LP 235 例: \f2\-\-class\-attribute=SourceFile=RUH\fP 236 .TP 3 237 error 238 この属性が検出された場合、pack200 の操作に失敗し、適切な解説が表示されます。 239 .TP 3 240 strip 241 この属性が検出された場合、属性は出力から削除されます。注: VM 必須属性を削除するとクラスローダーの障害が発生することがあります。 242 .RE 243 244 .LP 245 .LP 246 例: \f2\-\-class\-attribute=CompilationID=pass\fP というこの属性を含むクラスファイルを転送します。パックツールは、その他のアクションを行いません。 247 .LP 248 .LP 249 \f4\-f\fP\f2 \fP\f2pack.properties\fP \f3\-\-config\-file=\fP\f2pack.properties\fP 250 .LP 251 .LP 252 コマンド行に、パックツールを初期化するための Java プロパティーが含まれている設定ファイルを指定できます。 253 .LP 254 .LP 255 \f2% pack200 \-f pack.properties myarchive.pack.gz myarchive.jar\fP 256 .br 257 \f2% more pack.properties\fP 258 .br 259 \f2# Generic properties for the packer.\fP 260 .br 261 \f2modification.time=latest\fP 262 .br 263 \f2deflate.hint=false\fP 264 .br 265 \f2keep.file.order=false\fP 266 .br 267 \f2# This option will cause the files bearing new attributes to\fP 268 .br 269 \f2# be reported as an error rather than passed uncompressed.\fP 270 .br 271 \f2unknown.attribute=error\fP 272 .br 273 \f2# Change the segment limit to be unlimited.\fP 274 .br 275 \f2segment.limit=\-1\fP 276 .LP 277 .LP 278 \f4\-v \-\-verbose\fP 279 .LP 280 .LP 281 最小限のメッセージを出力します。このオプションを複数指定すると、より長いメッセージが出力されます。 282 .LP 283 .LP 284 \f4\-q \-\-quiet\fP 285 .LP 286 .LP 287 メッセージを表示せずに動作します。 288 .LP 289 .LP 290 \f4\-lfilename \-\-log\-file=\fP\f2filename\fP 291 .LP 292 .LP 293 出力メッセージのログファイルを指定します。 294 .LP 295 .LP 296 \f4\-? \-h \-\-help\fP 297 .LP 298 .LP 299 このコマンドに関するヘルプ情報を出力します。 300 .LP 301 .LP 302 \f4\-V \-\-version\fP 303 .LP 304 .LP 305 このコマンドに関するバージョン情報を出力します。 306 .LP 307 .LP 308 \f4\-J\fP\f2option\fP 309 .LP 310 .LP 311 \f2option\fP を、 \f2pack200\fP から呼び出された Java 起動ツールに渡します。たとえば、 \f2\-J\-Xms48m\fP と指定すると、スタートアップメモリーが 48M バイトに設定されます。このオプションは \f2\-X\fP で始まっていませんが、 \f2pack200\fP の標準オプションではありません。 \f2\-J\fP を使って、Java で記述されたアプリケーションを実行する背後の VM にオプション渡すことは、よく行われています。 312 .LP 313 .SH "終了ステータス" 314 .LP 315 .LP 316 次の終了値が返されます。 317 .LP 318 .LP 319 \f2\ 0\fP 正常終了した場合 320 .LP 321 .LP 322 \f2>0\fP エラーが発生した場合 323 .LP 324 .SH "関連項目" 325 .LP 326 .RS 3 327 .TP 2 328 o 329 unpack200(1) 330 .TP 2 331 o 332 .na 333 \f2Java SE のドキュメント\fP @ 334 .fi 335 http://java.sun.com/javase/6/docs/index.html 336 .TP 2 337 o 338 .na 339 \f2「Java 配備ガイド \- Pack200」\fP @ 340 .fi 341 http://java.sun.com/javase/6/docs/technotes/guides/deployment/deployment\-guide/pack200.html 342 .TP 2 343 o 344 jar(1) \- Java Archive ツール」 345 .TP 2 346 o 347 jarsigner(1) \- JAR 署名および検証ツール」 348 .TP 2 349 o 350 \f2attributes(5) の\fP マニュアルページ 351 .RE 352 353 .LP 354 .SH "注意事項" 355 .LP 356 .LP 357 このコマンドと \f2pack(1)\fP を混同しないでください。これらは別製品です。 358 .LP 359 .LP 360 SDK に付属する Java SE API 仕様との相違が見つかった場合には、仕様を優先してください。 361 .LP 362