1 ." Copyright (c) 2004, 2012, Oracle and/or its affiliates. All rights reserved. |
1 '\" t |
2 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
2 .\" Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. |
3 ." |
3 .\" |
4 ." This code is free software; you can redistribute it and/or modify it |
4 .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
5 ." under the terms of the GNU General Public License version 2 only, as |
5 .\" |
6 ." published by the Free Software Foundation. |
6 .\" This code is free software; you can redistribute it and/or modify it |
7 ." |
7 .\" under the terms of the GNU General Public License version 2 only, as |
8 ." This code is distributed in the hope that it will be useful, but WITHOUT |
8 .\" published by the Free Software Foundation. |
9 ." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or |
9 .\" |
10 ." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License |
10 .\" This code is distributed in the hope that it will be useful, but WITHOUT |
11 ." version 2 for more details (a copy is included in the LICENSE file that |
11 .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or |
12 ." accompanied this code). |
12 .\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License |
13 ." |
13 .\" version 2 for more details (a copy is included in the LICENSE file that |
14 ." You should have received a copy of the GNU General Public License version |
14 .\" accompanied this code). |
15 ." 2 along with this work; if not, write to the Free Software Foundation, |
15 .\" |
16 ." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. |
16 .\" You should have received a copy of the GNU General Public License version |
17 ." |
17 .\" 2 along with this work; if not, write to the Free Software Foundation, |
18 ." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA |
18 .\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. |
19 ." or visit www.oracle.com if you need additional information or have any |
19 .\" |
20 ." questions. |
20 .\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA |
21 ." |
21 .\" or visit www.oracle.com if you need additional information or have any |
22 .TH pack200 1 "10 May 2011" |
22 .\" questions. |
23 |
23 .\" |
24 .LP |
24 .\" Arch: generic |
25 .SH "Name" |
25 .\" Software: JDK 8 |
26 pack200 \- JAR Packing tool |
26 .\" Date: 21 November 2013 |
27 .LP |
27 .\" SectDesc: Java Deployment Tools |
28 .SH "SYNOPSIS" |
28 .\" Title: pack200.1 |
29 .LP |
29 .\" |
30 .LP |
30 .if n .pl 99999 |
31 \f4pack200\fP\f2 [ \fP\f2options\fP ] \f2output\-file\fP \f2JAR\-file\fP |
31 .TH pack200 1 "21 November 2013" "JDK 8" "Java Deployment Tools" |
32 .LP |
32 .\" ----------------------------------------------------------------- |
33 .LP |
33 .\" * Define some portability stuff |
34 Options may be in any order. The last option on the command line or in a properties file supersedes all previously specified options. |
34 .\" ----------------------------------------------------------------- |
35 .LP |
35 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
36 .RS 3 |
36 .\" http://bugs.debian.org/507673 |
37 .TP 3 |
37 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html |
38 options |
38 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
39 Command\-line options. |
39 .ie \n(.g .ds Aq \(aq |
40 .TP 3 |
40 .el .ds Aq ' |
41 output\-file |
41 .\" ----------------------------------------------------------------- |
42 Name of the output file. |
42 .\" * set default formatting |
43 .TP 3 |
43 .\" ----------------------------------------------------------------- |
44 JAR\-file |
44 .\" disable hyphenation |
45 Name of the input file. |
45 .nh |
|
46 .\" disable justification (adjust text to left margin only) |
|
47 .ad l |
|
48 .\" ----------------------------------------------------------------- |
|
49 .\" * MAIN CONTENT STARTS HERE * |
|
50 .\" ----------------------------------------------------------------- |
|
51 |
|
52 .SH NAME |
|
53 pack200 \- Packages a JAR file into a compressed pack200 file for web deployment\&. |
|
54 .SH SYNOPSIS |
|
55 .sp |
|
56 .nf |
|
57 |
|
58 \fBpack200\fR [\fIoptions\fR] \fIoutput\-file\fR \fIJAR\-file\fR |
|
59 .fi |
|
60 .sp |
|
61 Options can be in any order\&. The last option on the command line or in a properties file supersedes all previously specified options\&. |
|
62 .TP |
|
63 \fIoptions\fR |
|
64 The command-line options\&. See Options\&. |
|
65 .TP |
|
66 \fIoutput-file\fR |
|
67 Name of the output file\&. |
|
68 .TP |
|
69 \fIJAR-file\fR |
|
70 Name of the input file\&. |
|
71 .SH DESCRIPTION |
|
72 The \f3pack200\fR command is a Java application that transforms a JAR file into a compressed pack200 file with the Java gzip compressor\&. The pack200 files are highly compressed files that can be directly deployed to save bandwidth and reduce download time\&. |
|
73 .PP |
|
74 The \f3pack200\fR command has several options to fine-tune and set the compression engine\&. The typical usage is shown in the following example, where \f3myarchive\&.pack\&.gz\fR is produced with the default \f3pack200\fR command settings: |
|
75 .sp |
|
76 .nf |
|
77 \f3pack200 myarchive\&.pack\&.gz myarchive\&.jar\fP |
|
78 .fi |
|
79 .nf |
|
80 \f3\fP |
|
81 .fi |
|
82 .sp |
|
83 .SH OPTIONS |
|
84 .TP |
|
85 -r, --repack |
|
86 .br |
|
87 Produces a JAR file by packing and unpacking a JAR file\&. The resulting file can be used as an input to the \f3jarsigner\fR(1) tool\&. The following example packs and unpacks the myarchive\&.jar file: |
|
88 .sp |
|
89 .nf |
|
90 \f3pack200 \-\-repack myarchive\-packer\&.jar myarchive\&.jar\fP |
|
91 .fi |
|
92 .nf |
|
93 \f3pack200 \-\-repack myarchive\&.jar\fP |
|
94 .fi |
|
95 .nf |
|
96 \f3\fP |
|
97 .fi |
|
98 .sp |
|
99 |
|
100 |
|
101 The following example preserves the order of files in the input file\&. |
|
102 .TP |
|
103 -g, --no-gzip |
|
104 .br |
|
105 Produces a \f3pack200\fR file\&. With this option, a suitable compressor must be used, and the target system must use a corresponding decompresser\&. |
|
106 .sp |
|
107 .nf |
|
108 \f3pack200 \-\-no\-gzip myarchive\&.pack myarchive\&.jar\fP |
|
109 .fi |
|
110 .nf |
|
111 \f3\fP |
|
112 .fi |
|
113 .sp |
|
114 |
|
115 .TP |
|
116 -G, --strip-debug |
|
117 .br |
|
118 Strips debugging attributes from the output\&. These include \f3SourceFile\fR, \f3LineNumberTable\fR, \f3LocalVariableTable\fR and \f3LocalVariableTypeTable\fR\&. Removing these attributes reduces the size of both downloads and installations, but reduces the usefulness of debuggers\&. |
|
119 .TP |
|
120 --keep-file-order |
|
121 .br |
|
122 Preserve the order of files in the input file\&. This is the default behavior\&. |
|
123 .TP |
|
124 -O, --no-keep-file-order |
|
125 .br |
|
126 The packer reorders and transmits all elements\&. The packer can also remove JAR directory names to reduce the download size\&. However, certain JAR file optimizations, such as indexing, might not work correctly\&. |
|
127 .TP |
|
128 -S\fIvalue\fR , --segment-limit=\fIvalue\fR |
|
129 .br |
|
130 The value is the estimated target size \fIN\fR (in bytes) of each archive segment\&. If a single input file requires more than \fIN\fR bytes, then its own archive segment is provided\&. As a special case, a value of \f3-1\fR produces a single large segment with all input files, while a value of 0 produces one segment for each class\&. Larger archive segments result in less fragmentation and better compression, but processing them requires more memory\&. |
|
131 |
|
132 The size of each segment is estimated by counting the size of each input file to be transmitted in the segment with the size of its name and other transmitted properties\&. |
|
133 |
|
134 The default is -1, which means that the packer creates 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\&. |
|
135 |
|
136 A 10 MB JAR packed without this limit typically packs about 10 percent smaller, but the packer might require a larger Java heap (about 10 times the segment limit)\&. |
|
137 .TP |
|
138 -E\fIvalue\fR , --effort=\fIvalue\fR |
|
139 .br |
|
140 If the value is set to a single decimal digit, then the packer uses the indicated amount of effort in compressing the archive\&. Level 1 might produce somewhat larger size and faster compression speed, while level 9 takes much longer, but can produce better compression\&. The special value 0 instructs the \f3pack200\fR command 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\&. |
|
141 |
|
142 The default is 5, to invest a modest amount of time to produce reasonable compression\&. |
|
143 .TP |
|
144 -H\fIvalue\fR , --deflate-hint=\fIvalue\fR |
|
145 .br |
|
146 Overrides the default, which preserves the input information, but can cause the transmitted archive to be larger\&. The possible values are: \f3true\fR, \f3false\fR, or \f3keep\fR\&. |
|
147 |
|
148 If the \f3value\fR is \f3true\fR or false, then the \f3packer200\fR command sets the deflation hint accordingly in the output archive and does not transmit the individual deflation hints of archive elements\&. |
|
149 |
|
150 The \f3keep\fR value preserves deflation hints observed in the input JAR\&. This is the default\&. |
|
151 .TP |
|
152 -m\fIvalue\fR , --modification-time=\fIvalue\fR |
|
153 .br |
|
154 The possible values are \f3latest\fR and \f3keep\fR\&. |
|
155 |
|
156 If the value is latest, then the packer attempts to determine the latest modification time, among all the available entries in the original archive, or the latest modification time of all the available entries in that segment\&. This single value is transmitted as part of the segment and applied to all the entries in each segment\&. This can marginally decrease the transmitted size of the archive at the expense of setting all installed files to a single date\&. |
|
157 |
|
158 If the value is \f3keep\fR, then modification times observed in the input JAR are preserved\&. This is the default\&. |
|
159 .TP |
|
160 -P\fIfile\fR , --pass-file=\fIfile\fR |
|
161 .br |
|
162 Indicates that a file should be passed through bytewise with no compression\&. By repeating the option, multiple files can be specified\&. There is no pathname transformation, except that the system file separator is replaced by the JAR file separator forward slash (/)\&. The resulting file names must match exactly as strings with their occurrences in the JAR file\&. If \f3file\fR is a directory name, then all files under that directory are passed\&. |
|
163 .TP |
|
164 -U\fIaction\fR , --unknown-attribute=\fIaction\fR |
|
165 .br |
|
166 Overrides the default behavior, which means that the class file that contains the unknown attribute is passed through with the specified \f3action\fR\&. The possible values for actions are \f3error\fR, \f3strip\fR, or \f3pass\fR\&. |
|
167 |
|
168 If the value is \f3error\fR, then the entire \f3pack200\fR command operation fails with a suitable explanation\&. |
|
169 |
|
170 If the value is \f3strip\fR, then the attribute is dropped\&. Removing the required Java Virtual Machine (JVM) attributes can cause class loader failures\&. |
|
171 |
|
172 If the value is \f3pass\fR, then the entire class is transmitted as though it is a resource\&. |
|
173 .TP |
|
174 .nf |
|
175 -C\fIattribute-name\fR=\fIlayout\fR , --class-attribute=\fIattribute-name\fR=\fIaction\fR |
|
176 .br |
|
177 .fi |
|
178 See next option\&. |
|
179 .TP |
|
180 .nf |
|
181 -F\fIattribute-name\fR=\fIlayout\fR , --field-attribute=\fIattribute-name\fR=\fIaction\fR |
|
182 .br |
|
183 .fi |
|
184 See next option\&. |
|
185 .TP |
|
186 .nf |
|
187 -M\fIattribute-name\fR=\fIlayout\fR , --method-attribute=\fIattribute-name\fR=\fIaction\fR |
|
188 .br |
|
189 .fi |
|
190 See next option\&. |
|
191 .TP |
|
192 .nf |
|
193 -D\fIattribute-name\fR=\fIlayout\fR , --code-attribute=\fIattribute-name\fR=\fIaction\fR |
|
194 .br |
|
195 .fi |
|
196 With the previous four options, the attribute layout can be specified for a class entity, such as \f3class-attribute\fR, \f3field-attribute\fR, \f3method-attribute\fR, and \f3code-attribute\fR\&. The \fIattribute-name\fR is the name of the attribute for which the layout or action is being defined\&. The possible values for \fIaction\fR are \f3some-layout-string\fR, \f3error\fR, \f3strip\fR, \f3pass\fR\&. |
|
197 |
|
198 \f3some-layout-string\fR: The layout language is defined in the JSR 200 specification, for example: \f3--class-attribute=SourceFile=RUH\fR\&. |
|
199 |
|
200 If the value is \f3error\fR, then the \f3pack200\fR operation fails with an explanation\&. |
|
201 |
|
202 If the value is \f3strip\fR, then the attribute is removed from the output\&. Removing JVM-required attributes can cause class loader failures\&. For example, \f3--class-attribute=CompilationID=pass\fR causes the class file that contains this attribute to be passed through without further action by the packer\&. |
|
203 |
|
204 If the value is \f3pass\fR, then the entire class is transmitted as though it is a resource\&. |
|
205 .TP |
|
206 -f \fIpack\&.properties\fR , --config-file=\fIpack\&.properties\fR |
|
207 .br |
|
208 A configuration file, containing Java properties to initialize the packer, can be specified on the command line\&. |
|
209 .sp |
|
210 .nf |
|
211 \f3pack200 \-f pack\&.properties myarchive\&.pack\&.gz myarchive\&.jar\fP |
|
212 .fi |
|
213 .nf |
|
214 \f3more pack\&.properties\fP |
|
215 .fi |
|
216 .nf |
|
217 \f3# Generic properties for the packer\&.\fP |
|
218 .fi |
|
219 .nf |
|
220 \f3modification\&.time=latest\fP |
|
221 .fi |
|
222 .nf |
|
223 \f3deflate\&.hint=false\fP |
|
224 .fi |
|
225 .nf |
|
226 \f3keep\&.file\&.order=false\fP |
|
227 .fi |
|
228 .nf |
|
229 \f3# This option will cause the files bearing new attributes to\fP |
|
230 .fi |
|
231 .nf |
|
232 \f3# be reported as an error rather than passed uncompressed\&.\fP |
|
233 .fi |
|
234 .nf |
|
235 \f3unknown\&.attribute=error\fP |
|
236 .fi |
|
237 .nf |
|
238 \f3# Change the segment limit to be unlimited\&.\fP |
|
239 .fi |
|
240 .nf |
|
241 \f3segment\&.limit=\-1\fP |
|
242 .fi |
|
243 .nf |
|
244 \f3\fP |
|
245 .fi |
|
246 .sp |
|
247 |
|
248 .TP |
|
249 -v, --verbose |
|
250 .br |
|
251 Outputs minimal messages\&. Multiple specification of this option will create more verbose messages\&. |
|
252 .TP |
|
253 -q, --quiet |
|
254 .br |
|
255 Specifies quiet operation with no messages\&. |
|
256 .TP |
|
257 -l\fIfilename\fR , --log-file=\fIfilename\fR |
|
258 .br |
|
259 Specifies a log file to output messages\&. |
|
260 .TP |
|
261 -?, -h, --help |
|
262 .br |
|
263 Prints help information about this command\&. |
|
264 .TP |
|
265 -V, --version |
|
266 .br |
|
267 Prints version information about this command\&. |
|
268 .TP |
|
269 -J\fIoption\fR |
|
270 .br |
|
271 Passes the specified option to the Java Virtual Machine\&. For more information, see the reference page for the java(1) command\&. For example, \f3-J-Xms48m\fR sets the startup memory to 48 MB\&. |
|
272 .SH EXIT\ STATUS |
|
273 The following exit values are returned: 0 for successful completion and a number greater than 0 when an error occurs\&. |
|
274 .SH NOTES |
|
275 This command should not be confused with \f3pack\fR(1)\&. The \f3pack\fR and \f3pack200\fR commands are separate products\&. |
|
276 .PP |
|
277 The Java SE API Specification provided with the JDK is the superseding authority, when there are discrepancies\&. |
|
278 .SH SEE\ ALSO |
|
279 .TP 0.2i |
|
280 \(bu |
|
281 unpack200(1) |
|
282 .TP 0.2i |
|
283 \(bu |
|
284 jar(1) |
|
285 .TP 0.2i |
|
286 \(bu |
|
287 jarsigner(1) |
46 .RE |
288 .RE |
47 |
289 .br |
48 .LP |
290 'pl 8.5i |
49 .SH "DESCRIPTION" |
291 'bp |
50 .LP |
|
51 .LP |
|
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. |
|
53 .LP |
|
54 .LP |
|
55 The \f2pack200\fP tool uses several options to fine\-tune and set the compression engine. |
|
56 .LP |
|
57 .SS |
|
58 Typical usage: |
|
59 .LP |
|
60 .LP |
|
61 \f2% pack200 myarchive.pack.gz myarchive.jar\fP |
|
62 .LP |
|
63 .LP |
|
64 In this example, \f2myarchive.pack.gz\fP is produced using the default \f2pack200\fP settings. |
|
65 .LP |
|
66 .SH "OPTIONS" |
|
67 .LP |
|
68 .LP |
|
69 \f4\-r \-\-repack\fP |
|
70 .LP |
|
71 .LP |
|
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. |
|
73 .LP |
|
74 .LP |
|
75 \f2% pack200 \-\-repack myarchive\-packer.jar myarchive.jar\fP |
|
76 .LP |
|
77 .LP |
|
78 \f2% pack200 \-\-repack myarchive.jar\fP |
|
79 .LP |
|
80 .LP |
|
81 \f4\-g \-\-no\-gzip\fP |
|
82 .LP |
|
83 .LP |
|
84 Produces a \f2pack200\fP file. With this option a suitable compressor must be used, and the target system must use a corresponding decompresser. |
|
85 .LP |
|
86 .LP |
|
87 \f2% pack200 \-\-no\-gzip myarchive.pack myarchive.jar\fP |
|
88 .LP |
|
89 .LP |
|
90 \f4\-G \-\-strip\-debug\fP |
|
91 .LP |
|
92 .LP |
|
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. |
|
94 .LP |
|
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 |
|
101 .LP |
|
102 \f4\-O \-\-no\-keep\-file\-order\fP |
|
103 .LP |
|
104 .LP |
|
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. |
|
106 .LP |
|
107 .LP |
|
108 \f4\-Svalue \-\-segment\-limit=\fP\f2value\fP |
|
109 .LP |
|
110 .LP |
|
111 The value is the estimated target size N (in bytes) of each archive segment. If a single input file requires |
|
112 .br |
|
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. |
|
114 .LP |
|
115 .LP |
|
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. |
|
117 .LP |
|
118 .LP |
|
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. |
|
120 .LP |
|
121 .LP |
|
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). |
|
123 .LP |
|
124 .LP |
|
125 \f4\-Evalue \-\-effort=\fP\f2value\fP |
|
126 .LP |
|
127 .LP |
|
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. |
|
129 .LP |
|
130 .LP |
|
131 The default is \f25\fP, investing a modest amount of time to produce reasonable compression. |
|
132 .LP |
|
133 .LP |
|
134 \f4\-Hvalue \-\-deflate\-hint=\fP\f2value\fP |
|
135 .LP |
|
136 .LP |
|
137 Overrides the default, which preserves the input information, but may cause the transmitted archive to be larger. The possible values are: |
|
138 .LP |
|
139 .RS 3 |
|
140 .TP 3 |
|
141 true |
|
142 .TP 3 |
|
143 false |
|
144 In either case, the packer will set the deflation hint accordingly in the output archive, and will not transmit the individual deflation hints of archive elements. |
|
145 .RE |
|
146 |
|
147 .LP |
|
148 .RS 3 |
|
149 .TP 3 |
|
150 keep |
|
151 Preserve deflation hints observed in the input JAR. (This is the default.) |
|
152 .RE |
|
153 |
|
154 .LP |
|
155 .LP |
|
156 \f4\-mvalue \-\-modification\-time=\fP\f2value\fP |
|
157 .LP |
|
158 .LP |
|
159 The possible values are: |
|
160 .LP |
|
161 .RS 3 |
|
162 .TP 3 |
|
163 latest |
|
164 The packer will attempt to determine the latest modification time, among all the available entries in the original archive, or the latest modification time of all the available entries in that segment. This single value will be transmitted as part of the segment and applied to all the entries in each segment. This can marginally decrease the transmitted size of the archive at the expense of setting all installed files to a single date. |
|
165 .TP 3 |
|
166 keep |
|
167 Preserves modification times observed in the input JAR. (This is the default.) |
|
168 .RE |
|
169 |
|
170 .LP |
|
171 .LP |
|
172 \f4\-Pfile \-\-pass\-file=\fP\f2file\fP |
|
173 .LP |
|
174 .LP |
|
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. |
|
176 .LP |
|
177 .LP |
|
178 \f4\-Uaction \-\-unknown\-attribute=\fP\f2action\fP |
|
179 .LP |
|
180 .LP |
|
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: |
|
182 .LP |
|
183 .RS 3 |
|
184 .TP 3 |
|
185 error |
|
186 The \f2pack200\fP operation as a whole will fail with a suitable explanation. |
|
187 .TP 3 |
|
188 strip |
|
189 The attribute will be dropped. Note: Removing the required VM attributes may cause Class Loader failures. |
|
190 .TP 3 |
|
191 pass |
|
192 Upon encountering this attribute, the entire class will be transmitted as though it is a resource. |
|
193 .RE |
|
194 |
|
195 .LP |
|
196 .LP |
|
197 \f4\-Cattribute\-name=\fP\f2layout\fP \f3\-\-class\-attribute=\fP\f2attribute\-name=action\fP |
|
198 .br |
|
199 \f4\-Fattribute\-name=\fP\f2layout\fP \f3\-\-field\-attribute=\fP\f2attribute\-name=action\fP |
|
200 .br |
|
201 \f4\-Mattribute\-name=\fP\f2layout\fP \f3\-\-method\-attribute=\fP\f2attribute\-name=action\fP |
|
202 .br |
|
203 \f4\-Dattribute\-name=\fP\f2layout\fP \f3\-\-code\-attribute=\fP\f2attribute\-name=action\fP |
|
204 .LP |
|
205 .LP |
|
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: |
|
207 .LP |
|
208 .RS 3 |
|
209 .TP 3 |
|
210 some\-layout\-string |
|
211 The layout language is defined in the JSR 200 specification. |
|
212 .LP |
|
213 Example: \f2\-\-class\-attribute=SourceFile=RUH\fP |
|
214 .TP 3 |
|
215 error |
|
216 Upon encountering this attribute, the pack200 operation will fail with a suitable explanation. |
|
217 .TP 3 |
|
218 strip |
|
219 Upon encountering this attribute, the attribute will be removed from the output. Note: removing VM\-required attributes may cause Class Loader failures. |
|
220 .RE |
|
221 |
|
222 .LP |
|
223 .LP |
|
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. |
|
225 .LP |
|
226 .LP |
|
227 \f4\-f\fP\f2 \fP\f2pack.properties\fP \f3\-\-config\-file=\fP\f2pack.properties\fP |
|
228 .LP |
|
229 .LP |
|
230 A configuration file, containing Java properties to initialize the packer, may be specified on the command line. |
|
231 .LP |
|
232 .LP |
|
233 \f2% pack200 \-f pack.properties myarchive.pack.gz myarchive.jar\fP |
|
234 .br |
|
235 \f2% more pack.properties\fP |
|
236 .br |
|
237 \f2# Generic properties for the packer.\fP |
|
238 .br |
|
239 \f2modification.time=latest\fP |
|
240 .br |
|
241 \f2deflate.hint=false\fP |
|
242 .br |
|
243 \f2keep.file.order=false\fP |
|
244 .br |
|
245 \f2# This option will cause the files bearing new attributes to\fP |
|
246 .br |
|
247 \f2# be reported as an error rather than passed uncompressed.\fP |
|
248 .br |
|
249 \f2unknown.attribute=error\fP |
|
250 .br |
|
251 \f2# Change the segment limit to be unlimited.\fP |
|
252 .br |
|
253 \f2segment.limit=\-1\fP |
|
254 .LP |
|
255 .LP |
|
256 \f4\-v \-\-verbose\fP |
|
257 .LP |
|
258 .LP |
|
259 Outputs minimal messages. Multiple specification of this option will output more verbose messages. |
|
260 .LP |
|
261 .LP |
|
262 \f4\-q \-\-quiet\fP |
|
263 .LP |
|
264 .LP |
|
265 Specifies quiet operation with no messages. |
|
266 .LP |
|
267 .LP |
|
268 \f4\-lfilename \-\-log\-file=\fP\f2filename\fP |
|
269 .LP |
|
270 .LP |
|
271 Specifies a log file to output messages. |
|
272 .LP |
|
273 .LP |
|
274 \f4\-? \-h \-\-help\fP |
|
275 .LP |
|
276 .LP |
|
277 Prints help information about this command. |
|
278 .LP |
|
279 .LP |
|
280 \f4\-V \-\-version\fP |
|
281 .LP |
|
282 .LP |
|
283 Prints version information about this command. |
|
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 |
|
291 .SH "EXIT STATUS" |
|
292 .LP |
|
293 .LP |
|
294 The following exit values are returned: |
|
295 .LP |
|
296 .LP |
|
297 \f2\ 0\fP for successful completion; |
|
298 .LP |
|
299 .LP |
|
300 \f2>0\fP if an error occurs. |
|
301 .LP |
|
302 .SH "SEE ALSO" |
|
303 .LP |
|
304 .RS 3 |
|
305 .TP 2 |
|
306 o |
|
307 unpack200(1) |
|
308 .TP 2 |
|
309 o |
|
310 .na |
|
311 \f2Java SE Documentation\fP @ |
|
312 .fi |
|
313 http://download.oracle.com/javase/7/docs/index.html |
|
314 .TP 2 |
|
315 o |
|
316 .na |
|
317 \f2Java Deployment Guide \- Pack200\fP @ |
|
318 .fi |
|
319 http://download.oracle.com/javase/7/docs/technotes/guides/deployment/deployment\-guide/pack200.html |
|
320 .TP 2 |
|
321 o |
|
322 jar(1) \- Java Archive Tool |
|
323 .TP 2 |
|
324 o |
|
325 jarsigner(1) \- JAR Signer tool |
|
326 .TP 2 |
|
327 o |
|
328 \f2attributes(5)\fP man page |
|
329 .RE |
|
330 |
|
331 .LP |
|
332 .SH "NOTES" |
|
333 .LP |
|
334 .LP |
|
335 This command should not be confused with \f2pack(1)\fP. They are distinctly separate products. |
|
336 .LP |
|
337 .LP |
|
338 The Java SE API Specification provided with the JDK is the superseding authority, in case of discrepancies. |
|
339 .LP |
|
340 |
|