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