Mercurial Mercurial > jdk-sandbox / comparison
summary | shortlog | changelog | graph | tags | bookmarks | branches | files | changeset | file | latest | revisions | annotate | diff | comparison | raw | help
Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
jdk/src/solaris/doc/sun/man/man1/pack200.1
changeset 2692 345bc8d65b19
parent 2 90ce3da70b43
child 5506 202f599c92aa
equal deleted inserted replaced
2691:bad7bbf42755 2692:345bc8d65b19 
     1 .'" t
 
     1 ." Copyright 2004-2006 Sun Microsystems, Inc.  All Rights Reserved.
 
     2 ." Copyright 2006 Sun Microsystems, Inc.  All Rights Reserved.
 
       
     3 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
 
     2 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
 
     4 ."
 
     3 ."
 
     5 ." 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
 
     6 ." 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
 
     7 ." published by the Free Software Foundation.
 
     6 ." published by the Free Software Foundation.
 
    17 ." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
 
    16 ." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
 
    18 ."
 
    17 ."
 
    19 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
 
    18 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
 
    20 ." CA 95054 USA or visit www.sun.com if you need additional information or
 
    19 ." CA 95054 USA or visit www.sun.com if you need additional information or
 
    21 ." have any questions.
 
    20 ." have any questions.
 
    22 ." ` 
    21 ."
 
    23 .TH pack200 1 "05 Aug 2006"
 
    22 .TH pack200 1 "04 May 2009"
 
    24 ." Generated by html2roff
 
    23 ." Generated from HTML by html2man (author: Eric Armstrong)
 
    25 
    24 
    26 .LP
 
    25 .LP
 
    27 .SH NAME
 
    26 .SH "Name"
 
    28 pack200 \- JAR Packing tool
 
    27 pack200 \- JAR Packing tool
 
    29 .LP
 
    28 .LP
 
    30 .SH "SYNOPSIS"
 
    29 .SH "SYNOPSIS"
 
    31 .LP
 
    30 .LP
 
    32 
    31 
    38 Options may be in any order. The last option on the command line or in a properties file supersedes all previously specified options.
 
    37 Options may be in any order. The last option on the command line or in a properties file supersedes all previously specified options.
 
    39 .LP
 
    38 .LP
 
    40 .RS 3
 
    39 .RS 3
 
    41 
    40 
    42 .LP
 
    41 .LP
 
       
    42 .RS 3
 
    43 .TP 3
 
    43 .TP 3
 
    44 options 
    44 options 
    45 Command\-line options. 
    45 Command\-line options. 
    46 .TP 3
 
    46 .TP 3
 
    47 output\-file 
    47 output\-file 
    48 Name of the output file. 
    48 Name of the output file. 
    49 .TP 3
 
    49 .TP 3
 
    50 JAR\-file 
    50 JAR\-file 
    51 Name of the input file. 
    51 Name of the input file. 
       
    52 .RE
 
       
    53 
    52 .LP
 
    54 .LP
 
    53 .RE
 
    55 .RE
 
    54 .SH "DESCRIPTION"
 
    56 .SH "DESCRIPTION"
 
    55 .LP
 
    57 .LP
 
    56 
    58 
    62 The \f2pack200\fP tool uses several options to fine\-tune and set the compression engine.
 
    64 The \f2pack200\fP tool uses several options to fine\-tune and set the compression engine.
 
    63 .LP
 
    65 .LP
 
    64 .SS 
    66 .SS 
    65 Typical usage:
 
    67 Typical usage:
 
    66 .LP
 
    68 .LP
 
       
    69 .RS 3
 
    67 
    70 
    68 .LP
 
    71 .LP
 
    69 .LP
 
    72 .LP
 
    70 \f2% pack200 myarchive.pack.gz myarchive.jar\fP
 
    73 \f2% pack200 myarchive.pack.gz myarchive.jar\fP
 
    71 .LP
 
    74 .LP
 
       
    75 .RE
 
    72 .LP
 
    76 .LP
 
    73 In this example, \f2myarchive.pack.gz\fP is produced using the default \f2pack200\fP settings.
 
    77 In this example, \f2myarchive.pack.gz\fP is produced using the default \f2pack200\fP settings.
 
    74 .LP
 
    78 .LP
 
    75 .SH "OPTIONS"
 
    79 .SH "OPTIONS"
 
    76 .LP
 
    80 .LP
 
   174 
   178 
   175 .LP
 
   179 .LP
 
   176 .LP
 
   180 .LP
 
   177 Overrides the default, which preserves the input information, but may cause the transmitted archive to be larger. The possible values are:
 
   181 Overrides the default, which preserves the input information, but may cause the transmitted archive to be larger. The possible values are:
 
   178 .LP
 
   182 .LP
 
       
   183 .RS 3
 
   179 .TP 3
 
   184 .TP 3
 
   180 true 
   185 true 
   181 .TP 3
 
   186 .TP 3
 
   182 false 
   187 false 
   183 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. 
   188 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. 
   184 .LP
 
   189 .RE
 
       
   190 
       
   191 .LP
 
       
   192 .RS 3
 
   185 .TP 3
 
   193 .TP 3
 
   186 keep 
   194 keep 
   187 Preserve deflation hints observed in the input JAR. (This is the default.) 
   195 Preserve deflation hints observed in the input JAR. (This is the default.) 
       
   196 .RE
 
       
   197 
   188 .LP
 
   198 .LP
 
   189 .RE
 
   199 .RE
 
   190 .LP
 
   200 .LP
 
   191 \f4\-mvalue \-\-modification\-time=\fP\f2value\fP
 
   201 \f4\-mvalue \-\-modification\-time=\fP\f2value\fP
 
   192 .LP
 
   202 .LP
 
   194 
   204 
   195 .LP
 
   205 .LP
 
   196 .LP
 
   206 .LP
 
   197 The possible values are:
 
   207 The possible values are:
 
   198 .LP
 
   208 .LP
 
       
   209 .RS 3
 
   199 .TP 3
 
   210 .TP 3
 
   200 latest 
   211 latest 
   201 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. 
   212 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. 
   202 .TP 3
 
   213 .TP 3
 
   203 keep 
   214 keep 
   204 Preserves modification times observed in the input JAR. (This is the default.) 
   215 Preserves modification times observed in the input JAR. (This is the default.) 
       
   216 .RE
 
       
   217 
   205 .LP
 
   218 .LP
 
   206 .RE
 
   219 .RE
 
   207 .LP
 
   220 .LP
 
   208 \f4\-Pfile \-\-pass\-file=\fP\f2file\fP
 
   221 \f4\-Pfile \-\-pass\-file=\fP\f2file\fP
 
   209 .LP
 
   222 .LP
 
   221 
   234 
   222 .LP
 
   235 .LP
 
   223 .LP
 
   236 .LP
 
   224 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 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:
 
   225 .LP
 
   238 .LP
 
       
   239 .RS 3
 
   226 .TP 3
 
   240 .TP 3
 
   227 error 
   241 error 
   228 The \f2pack200\fP operation as a whole will fail with a suitable explanation. 
   242 The \f2pack200\fP operation as a whole will fail with a suitable explanation. 
   229 .TP 3
 
   243 .TP 3
 
   230 strip 
   244 strip 
   231 The attribute will be dropped. Note: Removing the required VM attributes may cause Class Loader failures. 
   245 The attribute will be dropped. Note: Removing the required VM attributes may cause Class Loader failures. 
   232 .TP 3
 
   246 .TP 3
 
   233 pass 
   247 pass 
   234 Upon encountering this attribute, the entire class will be transmitted as though it is a resource. 
   248 Upon encountering this attribute, the entire class will be transmitted as though it is a resource. 
       
   249 .RE
 
       
   250 
   235 .LP
 
   251 .LP
 
   236 .RE
 
   252 .RE
 
   237 .LP
 
   253 .LP
 
   238 \f4\-Cattribute\-name=\fP\f2layout\fP \f3\-\-class\-attribute=\fP\f2attribute\-name=action\fP
 
   254 \f4\-Cattribute\-name=\fP\f2layout\fP \f3\-\-class\-attribute=\fP\f2attribute\-name=action\fP
 
   239 .br
 
   255 .br
 
   240  \f4\-Fattribute\-name=\fP\f2layout\fP \f3\-\-field\-attribute=\fP\f2attribute\-name=action\fP
 
   256 \f4\-Fattribute\-name=\fP\f2layout\fP \f3\-\-field\-attribute=\fP\f2attribute\-name=action\fP
 
   241 .br
 
   257 .br
 
   242  \f4\-Mattribute\-name=\fP\f2layout\fP \f3\-\-method\-attribute=\fP\f2attribute\-name=action\fP
 
   258 \f4\-Mattribute\-name=\fP\f2layout\fP \f3\-\-method\-attribute=\fP\f2attribute\-name=action\fP
 
   243 .br
 
   259 .br
 
   244  \f4\-Dattribute\-name=\fP\f2layout\fP \f3\-\-code\-attribute=\fP\f2attribute\-name=action\fP
 
   260 \f4\-Dattribute\-name=\fP\f2layout\fP \f3\-\-code\-attribute=\fP\f2attribute\-name=action\fP
 
   245 .LP
 
   261 .LP
 
   246 .RS 3
 
   262 .RS 3
 
   247 
   263 
   248 .LP
 
   264 .LP
 
   249 .LP
 
   265 .LP
 
   250 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 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:
 
   251 .LP
 
   267 .LP
 
       
   268 .RS 3
 
   252 .TP 3
 
   269 .TP 3
 
   253 some\-layout\-string 
   270 some\-layout\-string 
   254 The layout language is defined in the JSR 200 specification. 
   271 The layout language is defined in the JSR 200 specification. 
   255 .LP
 
   272 .LP
 
   256 Example: \f2\-\-class\-attribute=SourceFile=RUH\fP  
   273 Example: \f2\-\-class\-attribute=SourceFile=RUH\fP  
   258 error 
   275 error 
   259 Upon encountering this attribute, the pack200 operation will fail with a suitable explanation. 
   276 Upon encountering this attribute, the pack200 operation will fail with a suitable explanation. 
   260 .TP 3
 
   277 .TP 3
 
   261 strip 
   278 strip 
   262 Upon encountering this attribute, the attribute will be removed from the output. Note: removing VM\-required attributes may cause Class Loader failures. 
   279 Upon encountering this attribute, the attribute will be removed from the output. Note: removing VM\-required attributes may cause Class Loader failures. 
       
   280 .RE
 
       
   281 
   263 .LP
 
   282 .LP
 
   264 .LP
 
   283 .LP
 
   265 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 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.
 
   266 .LP
 
   285 .LP
 
   267 .RE
 
   286 .RE
 
   365 .RE
 
   384 .RE
 
   366 .SH "SEE ALSO"
 
   385 .SH "SEE ALSO"
 
   367 .LP
 
   386 .LP
 
   368 .RS 3
 
   387 .RS 3
 
   369 .TP 2
 
   388 .TP 2
 
   370 *
 
   389 o
 
   371 unpack200 \- JAR Unpacking Tool 
   390 unpack200(1) 
   372 .TP 2
 
   391 .TP 2
 
   373 *
 
   392 o
 
   374 \f2unpack200(1)\fP, \f2jar(1)\fP, \f2jarsigner(1)\fP, \f2attributes(5)\fP man pages 
   393 .na
 
   375 .TP 2
 
   394 \f2Java SE Documentation\fP @
 
   376 *
 
   395 .fi
 
   377 Java SE Documentation 
   396 http://java.sun.com/javase/6/docs/index.html 
   378 .TP 2
 
   397 .TP 2
 
   379 *
 
   398 o
 
   380 .na
 
   399 .na
 
   381 \f2Java Deployment Guide \- Pack200\fP @
 
   400 \f2Java Deployment Guide \- Pack200\fP @
 
   382 .fi
 
   401 .fi
 
   383 http://java.sun.com/javase/6/docs/technotes/guides/deployment/deployment\-guide/pack200.html 
   402 http://java.sun.com/javase/6/docs/technotes/guides/deployment/deployment\-guide/pack200.html 
   384 .TP 2
 
   403 .TP 2
 
   385 *
 
   404 o
 
   386 \f2jar\fP \- Java Archive Tool 
   405 jar(1) \- Java Archive Tool 
   387 .TP 2
 
   406 .TP 2
 
   388 *
 
   407 o
 
   389 .na
 
   408 jarsigner(1) \- JAR Signer tool 
   390 \f2jarsigner\fP \- JAR Signer tool @
 
   409 .TP 2
 
   391 .fi
 
   410 o
 
   392 http://java.sun.com/javase/6/docs/technotes/tools/solaris/jarsigner.html 
   411 \f2attributes(5)\fP man page 
   393 .RE
 
   412 .RE
 
   394 
   413 
   395 .LP
 
   414 .LP
 
   396 .SH "NOTES"
 
   415 .SH "NOTES"
 
   397 .LP
 
   416 .LP
 
   399 .LP
 
   418 .LP
 
   400 .LP
 
   419 .LP
 
   401 This command should not be confused with \f2pack(1)\fP. They are distinctly separate products.
 
   420 This command should not be confused with \f2pack(1)\fP. They are distinctly separate products.
 
   402 .LP
 
   421 .LP
 
   403 .LP
 
   422 .LP
 
   404 The Java SE API Specification provided with the SDK is the superseding authority, in case of discrepancies.
 
   423 The Java SE API Specification provided with the JDK is the superseding authority, in case of discrepancies.
 
       
   424 .LP
 
       
   425 
   405 .LP
 
   426 .LP
 
   406  
   427
jdk-sandbox