comparison src/linux/doc/man/pack200.1 @ 10552:2b0c2fc213d6

update combo-tests aurora target to reduce heap size per Sonali Goel
author mduigou
date Fri, 27 Dec 2013 09:51:31 -0800
parents d58354a69011
children
comparison
equal deleted inserted replaced
3:5880763da7de 4:4d9da8c1e7c8
1 ." Copyright (c) 2004, 2010, Oracle and/or its affiliates. All rights reserved. 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. 2 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
3 ." 3 ."
4 ." This code is free software; you can redistribute it and/or modify it 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 5 ." under the terms of the GNU General Public License version 2 only, as
6 ." published by the Free Software Foundation. 6 ." published by the Free Software Foundation.
17 ." 17 ."
18 ." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA 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 19 ." or visit www.oracle.com if you need additional information or have any
20 ." questions. 20 ." questions.
21 ." 21 ."
22 .TH pack200 1 "02 Jun 2010" 22 .TH pack200 1 "10 May 2011"
23 23
24 .LP 24 .LP
25 .SH "Name" 25 .SH "Name"
26 pack200 \- JAR Packing tool 26 pack200 \- JAR Packing tool
27 .LP 27 .LP
28 .SH "SYNOPSIS" 28 .SH "SYNOPSIS"
29 .LP 29 .LP
30
31 .LP
32 .LP 30 .LP
33 \f4pack200\fP\f2 [ \fP\f2options\fP ] \f2output\-file\fP \f2JAR\-file\fP 31 \f4pack200\fP\f2 [ \fP\f2options\fP ] \f2output\-file\fP \f2JAR\-file\fP
34 .LP 32 .LP
35 .LP 33 .LP
36 Options may be in any order. The last option on the command line or in a properties file supersedes all previously specified options. 34 Options may be in any order. The last option on the command line or in a properties file supersedes all previously specified options.
37 .LP
38 .RS 3
39
40 .LP 35 .LP
41 .RS 3 36 .RS 3
42 .TP 3 37 .TP 3
43 options 38 options
44 Command\-line options. 39 Command\-line options.
49 JAR\-file 44 JAR\-file
50 Name of the input file. 45 Name of the input file.
51 .RE 46 .RE
52 47
53 .LP 48 .LP
54 .RE
55 .SH "DESCRIPTION" 49 .SH "DESCRIPTION"
56 .LP
57
58 .LP 50 .LP
59 .LP 51 .LP
60 The \f2pack200\fP tool is a Java application that transforms a JAR file into a compressed \f2pack200\fP file using the Java \f2gzip\fP compressor. The \f2pack200\fP files are highly compressed files that can be directly deployed, saving bandwidth and reducing download time. 52 The \f2pack200\fP tool is a Java application that transforms a JAR file into a compressed \f2pack200\fP file using the Java \f2gzip\fP compressor. The \f2pack200\fP files are highly compressed files that can be directly deployed, saving bandwidth and reducing download time.
61 .LP 53 .LP
62 .LP 54 .LP
63 The \f2pack200\fP tool uses several options to fine\-tune and set the compression engine. 55 The \f2pack200\fP tool uses several options to fine\-tune and set the compression engine.
64 .LP 56 .LP
65 .SS 57 .SS
66 Typical usage: 58 Typical usage:
67 .LP 59 .LP
68 .RS 3
69
70 .LP
71 .LP 60 .LP
72 \f2% pack200 myarchive.pack.gz myarchive.jar\fP 61 \f2% pack200 myarchive.pack.gz myarchive.jar\fP
73 .LP 62 .LP
74 .RE
75 .LP 63 .LP
76 In this example, \f2myarchive.pack.gz\fP is produced using the default \f2pack200\fP settings. 64 In this example, \f2myarchive.pack.gz\fP is produced using the default \f2pack200\fP settings.
77 .LP 65 .LP
78 .SH "OPTIONS" 66 .SH "OPTIONS"
79 .LP 67 .LP
80
81 .LP
82 .LP 68 .LP
83 \f4\-r \-\-repack\fP 69 \f4\-r \-\-repack\fP
84 .LP 70 .LP
85 .RS 3
86
87 .LP
88 .LP 71 .LP
89 Produces a JAR file by packing the file \f2myarchive.jar\fP and unpacking it. The resulting file can be used as an input to the \f2jarsigner(1)\fP tool. 72 Produces a JAR file by packing the file \f2myarchive.jar\fP and unpacking it. The resulting file can be used as an input to the \f2jarsigner(1)\fP tool.
90 .LP 73 .LP
91 .RS 3
92
93 .LP
94 .LP 74 .LP
95 \f2% pack200 \-\-repack myarchive\-packer.jar myarchive.jar\fP 75 \f2% pack200 \-\-repack myarchive\-packer.jar myarchive.jar\fP
96 .LP 76 .LP
97 .LP 77 .LP
98 \f2% pack200 \-\-repack myarchive.jar\fP 78 \f2% pack200 \-\-repack myarchive.jar\fP
99 .LP 79 .LP
100 .RE
101 .RE
102 .LP 80 .LP
103 \f4\-g \-\-no\-gzip\fP 81 \f4\-g \-\-no\-gzip\fP
104 .LP 82 .LP
105 .RS 3
106
107 .LP
108 .LP 83 .LP
109 Produces a \f2pack200\fP file. With this option a suitable compressor must be used, and the target system must use a corresponding decompresser. 84 Produces a \f2pack200\fP file. With this option a suitable compressor must be used, and the target system must use a corresponding decompresser.
110 .LP 85 .LP
111 .RS 3
112
113 .LP
114 .LP 86 .LP
115 \f2% pack200 \-\-no\-gzip myarchive.pack myarchive.jar\fP 87 \f2% pack200 \-\-no\-gzip myarchive.pack myarchive.jar\fP
116 .LP 88 .LP
117 .RE
118 .RE
119 .LP 89 .LP
120 \f4\-G \-\-strip\-debug\fP 90 \f4\-G \-\-strip\-debug\fP
121 .LP 91 .LP
122 .RS 3
123
124 .LP
125 .LP 92 .LP
126 Strips attributes used for debugging from the output. These include \f2SourceFile\fP, \f2LineNumberTable\fP, \f2LocalVariableTable\fP and \f2LocalVariableTypeTable\fP. Removing these attributes reduces the size of both downloads and installations but reduces the usefulness of debuggers. 93 Strips attributes used for debugging from the output. These include \f2SourceFile\fP, \f2LineNumberTable\fP, \f2LocalVariableTable\fP and \f2LocalVariableTypeTable\fP. Removing these attributes reduces the size of both downloads and installations but reduces the usefulness of debuggers.
127 .LP 94 .LP
128 .RE 95 .LP
96 \f4\-\-keep\-file\-order\fP
97 .LP
98 .LP
99 Preserve the order of files in the input file; this is the default behavior.
100 .LP
129 .LP 101 .LP
130 \f4\-O \-\-no\-keep\-file\-order\fP 102 \f4\-O \-\-no\-keep\-file\-order\fP
131 .LP 103 .LP
132 .RS 3
133
134 .LP
135 .LP 104 .LP
136 The packer will reorder and transmit all elements. Additionally, the packer may remove JAR directory names. This will reduce the download size; however, certain JAR file optimizations, such as indexing, may not work correctly. 105 The packer will reorder and transmit all elements. Additionally, the packer may remove JAR directory names. This will reduce the download size; however, certain JAR file optimizations, such as indexing, may not work correctly.
137 .LP 106 .LP
138 .RE
139 .LP 107 .LP
140 \f4\-Svalue \-\-segment\-limit=\fP\f2value\fP 108 \f4\-Svalue \-\-segment\-limit=\fP\f2value\fP
141 .LP 109 .LP
142 .RS 3
143
144 .LP
145 .LP 110 .LP
146 The value is the estimated target size N (in bytes) of each archive segment. If a single input file requires 111 The value is the estimated target size N (in bytes) of each archive segment. If a single input file requires
147 .br 112 .br
148 more than N bytes, it will be given its own archive segment. As a special case, a value of \f2\-1\fP will produce a single large segment with all input files, while a value of \f20\fP will produce one segment for each class. Larger archive segments result in less fragmentation and better compression, but processing them requires more memory. 113 more than N bytes, it will be given its own archive segment. As a special case, a value of \f2\-1\fP will produce a single large segment with all input files, while a value of \f20\fP will produce one segment for each class. Larger archive segments result in less fragmentation and better compression, but processing them requires more memory.
149 .LP 114 .LP
150 .LP 115 .LP
151 The size of each segment is estimated by counting the size of each input file to be transmitted in the segment, along with the size of its name and other transmitted properties. 116 The size of each segment is estimated by counting the size of each input file to be transmitted in the segment, along with the size of its name and other transmitted properties.
152 .LP 117 .LP
153 .LP 118 .LP
154 The default is \f21000000\fP (a million bytes). This allows input JAR files of moderate size to be transmitted in one segment. It also puts a limit on memory requirements for packers and unpackers. 119 The default is \-1, which means the packer will always create a single segment output file. In cases where extremely large output files are generated, users are strongly encouraged to use segmenting or break up the input file into smaller JARs.
155 .LP 120 .LP
156 .LP 121 .LP
157 A 10MB JAR packed without this limit will typically pack about 10% smaller, but the packer may require a larger Java heap (about ten times the segment limit). 122 A 10MB JAR packed without this limit will typically pack about 10% smaller, but the packer may require a larger Java heap (about ten times the segment limit).
158 .LP 123 .LP
159 .RE
160 .LP 124 .LP
161 \f4\-Evalue \-\-effort=\fP\f2value\fP 125 \f4\-Evalue \-\-effort=\fP\f2value\fP
162 .LP 126 .LP
163 .RS 3
164
165 .LP
166 .LP 127 .LP
167 If the value is set to a single decimal digit, the packer will use the indicated amount of effort in compressing the archive. Level \f21\fP may produce somewhat larger size and faster compression speed, while level \f29\fP will take much longer but may produce better compression. The special value \f20\fP instructs the packer to copy through the original JAR file directly with no compression. The JSR 200 standard requires any unpacker to understand this special case as a pass\-through of the entire archive. 128 If the value is set to a single decimal digit, the packer will use the indicated amount of effort in compressing the archive. Level \f21\fP may produce somewhat larger size and faster compression speed, while level \f29\fP will take much longer but may produce better compression. The special value \f20\fP instructs the packer to copy through the original JAR file directly with no compression. The JSR 200 standard requires any unpacker to understand this special case as a pass\-through of the entire archive.
168 .LP 129 .LP
169 .LP 130 .LP
170 The default is \f25\fP, investing a modest amount of time to produce reasonable compression. 131 The default is \f25\fP, investing a modest amount of time to produce reasonable compression.
171 .LP 132 .LP
172 .RE
173 .LP 133 .LP
174 \f4\-Hvalue \-\-deflate\-hint=\fP\f2value\fP 134 \f4\-Hvalue \-\-deflate\-hint=\fP\f2value\fP
175 .LP
176 .RS 3
177
178 .LP 135 .LP
179 .LP 136 .LP
180 Overrides the default, which preserves the input information, but may cause the transmitted archive to be larger. The possible values are: 137 Overrides the default, which preserves the input information, but may cause the transmitted archive to be larger. The possible values are:
181 .LP 138 .LP
182 .RS 3 139 .RS 3
193 keep 150 keep
194 Preserve deflation hints observed in the input JAR. (This is the default.) 151 Preserve deflation hints observed in the input JAR. (This is the default.)
195 .RE 152 .RE
196 153
197 .LP 154 .LP
198 .RE
199 .LP 155 .LP
200 \f4\-mvalue \-\-modification\-time=\fP\f2value\fP 156 \f4\-mvalue \-\-modification\-time=\fP\f2value\fP
201 .LP
202 .RS 3
203
204 .LP 157 .LP
205 .LP 158 .LP
206 The possible values are: 159 The possible values are:
207 .LP 160 .LP
208 .RS 3 161 .RS 3
213 keep 166 keep
214 Preserves modification times observed in the input JAR. (This is the default.) 167 Preserves modification times observed in the input JAR. (This is the default.)
215 .RE 168 .RE
216 169
217 .LP 170 .LP
218 .RE
219 .LP 171 .LP
220 \f4\-Pfile \-\-pass\-file=\fP\f2file\fP 172 \f4\-Pfile \-\-pass\-file=\fP\f2file\fP
221 .LP 173 .LP
222 .RS 3
223
224 .LP
225 .LP 174 .LP
226 Indicates that a file should be passed through bytewise with no compression. By repeating the option, multiple files may be specified. There is no pathname transformation, except that the system file separator is replaced by the JAR file separator "\f2/\fP". The resulting file names must match exactly as strings with their occurrences in the JAR file. If file is a directory name, all files under that directory will be passed. 175 Indicates that a file should be passed through bytewise with no compression. By repeating the option, multiple files may be specified. There is no pathname transformation, except that the system file separator is replaced by the JAR file separator "\f2/\fP". The resulting file names must match exactly as strings with their occurrences in the JAR file. If file is a directory name, all files under that directory will be passed.
227 .LP 176 .LP
228 .RE
229 .LP 177 .LP
230 \f4\-Uaction \-\-unknown\-attribute=\fP\f2action\fP 178 \f4\-Uaction \-\-unknown\-attribute=\fP\f2action\fP
231 .LP
232 .RS 3
233
234 .LP 179 .LP
235 .LP 180 .LP
236 Overrides the default behavior; i.e., the classfile containing the unknown attribute will be passed through with the specified action. The possible values for actions are: 181 Overrides the default behavior; i.e., the classfile containing the unknown attribute will be passed through with the specified action. The possible values for actions are:
237 .LP 182 .LP
238 .RS 3 183 .RS 3
246 pass 191 pass
247 Upon encountering this attribute, the entire class will be transmitted as though it is a resource. 192 Upon encountering this attribute, the entire class will be transmitted as though it is a resource.
248 .RE 193 .RE
249 194
250 .LP 195 .LP
251 .RE
252 .LP 196 .LP
253 \f4\-Cattribute\-name=\fP\f2layout\fP \f3\-\-class\-attribute=\fP\f2attribute\-name=action\fP 197 \f4\-Cattribute\-name=\fP\f2layout\fP \f3\-\-class\-attribute=\fP\f2attribute\-name=action\fP
254 .br 198 .br
255 \f4\-Fattribute\-name=\fP\f2layout\fP \f3\-\-field\-attribute=\fP\f2attribute\-name=action\fP 199 \f4\-Fattribute\-name=\fP\f2layout\fP \f3\-\-field\-attribute=\fP\f2attribute\-name=action\fP
256 .br 200 .br
257 \f4\-Mattribute\-name=\fP\f2layout\fP \f3\-\-method\-attribute=\fP\f2attribute\-name=action\fP 201 \f4\-Mattribute\-name=\fP\f2layout\fP \f3\-\-method\-attribute=\fP\f2attribute\-name=action\fP
258 .br 202 .br
259 \f4\-Dattribute\-name=\fP\f2layout\fP \f3\-\-code\-attribute=\fP\f2attribute\-name=action\fP 203 \f4\-Dattribute\-name=\fP\f2layout\fP \f3\-\-code\-attribute=\fP\f2attribute\-name=action\fP
260 .LP
261 .RS 3
262
263 .LP 204 .LP
264 .LP 205 .LP
265 With the above four options, the attribute layout can be specified for a class entity, such as Class attribute, Field attribute, Method attribute, and Code attribute. The attribute\-name is the name of the attribute for which the layout or action is being defined. The possible values for action are: 206 With the above four options, the attribute layout can be specified for a class entity, such as Class attribute, Field attribute, Method attribute, and Code attribute. The attribute\-name is the name of the attribute for which the layout or action is being defined. The possible values for action are:
266 .LP 207 .LP
267 .RS 3 208 .RS 3
280 221
281 .LP 222 .LP
282 .LP 223 .LP
283 Example: \f2\-\-class\-attribute=CompilationID=pass\fP will cause the class file containing this attribute to be passed through without further action by the packer. 224 Example: \f2\-\-class\-attribute=CompilationID=pass\fP will cause the class file containing this attribute to be passed through without further action by the packer.
284 .LP 225 .LP
285 .RE
286 .LP 226 .LP
287 \f4\-f\fP\f2 \fP\f2pack.properties\fP \f3\-\-config\-file=\fP\f2pack.properties\fP 227 \f4\-f\fP\f2 \fP\f2pack.properties\fP \f3\-\-config\-file=\fP\f2pack.properties\fP
288 .LP 228 .LP
289 .RS 3
290
291 .LP
292 .LP 229 .LP
293 A configuration file, containing Java properties to initialize the packer, may be specified on the command line. 230 A configuration file, containing Java properties to initialize the packer, may be specified on the command line.
294 .LP 231 .LP
295 .RS 3
296
297 .LP
298 .LP 232 .LP
299 \f2% pack200 \-f pack.properties myarchive.pack.gz myarchive.jar\fP 233 \f2% pack200 \-f pack.properties myarchive.pack.gz myarchive.jar\fP
300 .br 234 .br
301 \f2% more pack.properties\fP 235 \f2% more pack.properties\fP
302 .br 236 .br
316 .br 250 .br
317 \f2# Change the segment limit to be unlimited.\fP 251 \f2# Change the segment limit to be unlimited.\fP
318 .br 252 .br
319 \f2segment.limit=\-1\fP 253 \f2segment.limit=\-1\fP
320 .LP 254 .LP
321 .RE
322 .RE
323 .RS 3
324
325 .LP
326 .LP 255 .LP
327 \f4\-v \-\-verbose\fP 256 \f4\-v \-\-verbose\fP
328 .LP 257 .LP
329 .RS 3
330
331 .LP
332 .LP 258 .LP
333 Outputs minimal messages. Multiple specification of this option will output more verbose messages. 259 Outputs minimal messages. Multiple specification of this option will output more verbose messages.
334 .LP 260 .LP
335 .RE
336 .LP 261 .LP
337 \f4\-q \-\-quiet\fP 262 \f4\-q \-\-quiet\fP
338 .LP 263 .LP
339 .RS 3
340
341 .LP
342 .LP 264 .LP
343 Specifies quiet operation with no messages. 265 Specifies quiet operation with no messages.
344 .LP 266 .LP
345 .RE
346 .LP 267 .LP
347 \f4\-lfilename \-\-log\-file=\fP\f2filename\fP 268 \f4\-lfilename \-\-log\-file=\fP\f2filename\fP
348 .LP 269 .LP
349 .RS 3
350
351 .LP
352 .LP 270 .LP
353 Specifies a log file to output messages. 271 Specifies a log file to output messages.
354 .LP 272 .LP
355 .RE 273 .LP
356 .LP 274 \f4\-? \-h \-\-help\fP
357 \f4\-Joption\fP 275 .LP
358 .LP 276 .LP
359 .RS 3 277 Prints help information about this command.
360 278 .LP
361 .LP 279 .LP
362 .LP 280 \f4\-V \-\-version\fP
363 Passes option to the Java launcher called by \f2pack200\fP. For example, \f2\-J\-Xms48m\fP sets the startup memory to 48 megabytes. Although it does not begin with \f2\-X\fP, it is not a standard option of \f2pack200\fP. It is a common convention for \f2\-J\fP to pass options to the underlying VM executing applications written in Java. 281 .LP
364 .LP 282 .LP
365 .RE 283 Prints version information about this command.
366 .RE 284 .LP
285 .LP
286 \f4\-J\fP\f2option\fP
287 .LP
288 .LP
289 Passes \f2option\fP to the Java launcher called by \f2pack200\fP. For example, \f2\-J\-Xms48m\fP sets the startup memory to 48 megabytes. Although it does not begin with \f2\-X\fP, it is not a standard option of \f2pack200\fP. It is a common convention for \f2\-J\fP to pass options to the underlying VM executing applications written in Java.
290 .LP
367 .SH "EXIT STATUS" 291 .SH "EXIT STATUS"
368 .LP 292 .LP
369
370 .LP
371 .LP 293 .LP
372 The following exit values are returned: 294 The following exit values are returned:
373 .LP 295 .LP
374 .RS 3
375
376 .LP
377 .LP 296 .LP
378 \f2\ 0\fP for successful completion; 297 \f2\ 0\fP for successful completion;
379 .LP 298 .LP
380 .LP 299 .LP
381 \f2>0\fP if an error occurs. 300 \f2>0\fP if an error occurs.
382 .LP 301 .LP
383 .RE
384 .SH "SEE ALSO" 302 .SH "SEE ALSO"
385 .LP 303 .LP
386 .RS 3 304 .RS 3
387 .TP 2 305 .TP 2
388 o 306 o
390 .TP 2 308 .TP 2
391 o 309 o
392 .na 310 .na
393 \f2Java SE Documentation\fP @ 311 \f2Java SE Documentation\fP @
394 .fi 312 .fi
395 http://java.sun.com/javase/6/docs/index.html 313 http://download.oracle.com/javase/7/docs/index.html
396 .TP 2 314 .TP 2
397 o 315 o
398 .na 316 .na
399 \f2Java Deployment Guide \- Pack200\fP @ 317 \f2Java Deployment Guide \- Pack200\fP @
400 .fi 318 .fi
401 http://java.sun.com/javase/6/docs/technotes/guides/deployment/deployment\-guide/pack200.html 319 http://download.oracle.com/javase/7/docs/technotes/guides/deployment/deployment\-guide/pack200.html
402 .TP 2 320 .TP 2
403 o 321 o
404 jar(1) \- Java Archive Tool 322 jar(1) \- Java Archive Tool
405 .TP 2 323 .TP 2
406 o 324 o
411 .RE 329 .RE
412 330
413 .LP 331 .LP
414 .SH "NOTES" 332 .SH "NOTES"
415 .LP 333 .LP
416
417 .LP
418 .LP 334 .LP
419 This command should not be confused with \f2pack(1)\fP. They are distinctly separate products. 335 This command should not be confused with \f2pack(1)\fP. They are distinctly separate products.
420 .LP 336 .LP
421 .LP 337 .LP
422 The Java SE API Specification provided with the JDK is the superseding authority, in case of discrepancies. 338 The Java SE API Specification provided with the JDK is the superseding authority, in case of discrepancies.