home *** CD-ROM | disk | FTP | other *** search
/ Programming Languages Suite / JBuilder8.iso / Solaris / resource / jre / man / sman1 / extcheck.1 < prev    next >
Encoding:
Text File  |  2002-09-06  |  5.0 KB  |  99 lines
  1. <!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
  2. <!--ArborText, Inc., 1988-1999, v.4002-->
  3. <!ENTITY % javaents SYSTEM "javaman.ent">
  4. %javaents;
  5. ]>
  6. <?Pub UDT _bookmark _target>
  7. <?Pub Inc>
  8. <refentry id="extcheck-1">
  9. <!--@(#)extcheck.1 1.11 01/03/14 SMI;-->
  10. <refmeta><refentrytitle>extcheck</refentrytitle><manvolnum>1</manvolnum>
  11. <refmiscinfo class="date">23 Apr 2001</refmiscinfo>
  12. <refmiscinfo class="sectdesc">&man1;</refmiscinfo>
  13. <refmiscinfo class="software">&java-release;</refmiscinfo>
  14. <refmiscinfo class="arch">generic</refmiscinfo>
  15. <refmiscinfo class="copyright"> Copyright 2001 Sun Microsystems, Inc. All
  16. rights reserved.  Copyright 2001 Sun Microsystems, Inc. Tous droits réservés.
  17. </refmiscinfo>
  18. </refmeta>
  19. <refnamediv><refname>extcheck</refname><refpurpose>jar conflict detection
  20. utility</refpurpose></refnamediv>
  21. <refsynopsisdiv><title>&synp-tt;</title>
  22. <cmdsynopsis><command>extcheck</command><arg choice="opt"><option>verbose
  23. </option></arg><arg choice="plain"><replaceable>targetfile.jar</replaceable></arg>
  24. <arg choice="opt"><option>J</option></arg><arg choice="plain"><replaceable>
  25. option</replaceable></arg>
  26. </cmdsynopsis></refsynopsisdiv>
  27. <refsect1><title>&desc-tt;</title>
  28. <indexterm id="extcheck-1-indx-1"><primary sortas="jar conflict detection utility">
  29. jar conflict detection utility — extcheck</primary></indexterm><indexterm
  30. id="extcheck-1-indx-2"><primary sortas="extcheck">extcheck — jar conflict
  31. detection utility</primary></indexterm><para>The <command>extcheck</command>
  32. utility checks a specified <literal>jar</literal> file for title and version
  33. conflicts with any extensions installed in the JDK™ software. Before
  34. installing an extension, you can use this utility to see if the same or a
  35. more recent version of the extension is already installed.</para>
  36. <para>The <command>extcheck</command> utility compares the Specification-title
  37. and Specification-version headers in the manifest of the <replaceable>targetfile.jar
  38. </replaceable> file against the corresponding headers in all <literal>jar
  39. </literal> files currently installed in the extension directory. (The extension
  40. directory is <literal>jre/lib/ext</literal> by default.) The <command>extcheck
  41. </command> utility compares version numbers in the same way as the method <literal>
  42. java.lang.Package.isCompatibleWith</literal>. </para>
  43. </refsect1>
  44. <refsect1><title>&opts-tt;</title>
  45. <para>The following options are supported:</para>
  46. <variablelist termlength="narrow">
  47. <varlistentry><term remap="15"><option>verbose</option> </term><listitem>
  48. <para>Lists <literal>jar</literal> files in the extension directory as they
  49. are checked. Additionally, manifest attributes of the target  <literal>jar
  50. </literal> file and any conflicting <literal>jar</literal> files are also
  51. reported.</para>
  52. </listitem></varlistentry>
  53. <varlistentry><term><option role="nodash">J</option><replaceable>option</replaceable></term>
  54. <listitem><para>Pass <replaceable>option</replaceable> to the Java virtual
  55. machine, where option is one of the options described on the man page for
  56. the java application launcher, java (1). For example, <literal>-J-Xms48m</literal>
  57. sets the startup memory to 48 megabytes. It is a common convention for <literal>
  58. -J</literal> to pass options to the underlying virtual machine.</para>
  59. </listitem></varlistentry><?Pub Caret>
  60. </variablelist></refsect1>
  61. <refsect1><title>&exit-tt;</title>
  62. <para>The following exit values are returned:</para>
  63. <variablelist termlength="narrow">
  64. <varlistentry><term remap="15"><returnvalue>0</returnvalue> </term><listitem>
  65. <para>No conflict is detected.</para>
  66. </listitem></varlistentry>
  67. <varlistentry><term>non-zero</term><listitem><para>If the manifest of any
  68. of the <literal>jar</literal> files in the extensions directory has the same
  69. Specification-title and the same or a newer Specification-version number,
  70. or if <replaceable>targetfile.jar</replaceable> does not have the Specification-title
  71. or Specification-version attributes in its manifest.</para>
  72. </listitem></varlistentry>
  73. </variablelist></refsect1>
  74. <refsect1><title>&attr-tt;</title>
  75. <para>See <olink targetdocent="REFMAN5" localinfo="attributes-5"><citerefentry>
  76. <refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink>
  77. for a description of the following attributes:</para>
  78. <informaltable frame="all" orient="port">
  79. <tgroup cols="2" colsep="1" rowsep="1"><colspec colnum="1" colname="col1"
  80. colwidth="1*" colsep="1" align="left"><colspec colnum="2" colname="col2" colwidth="1*"
  81. align="left">
  82. <thead>
  83. <row><entry colname="col1" rowsep="1" align="center" valign="top">ATTRIBUTE
  84. TYPE</entry><entry colname="col2" rowsep="1" align="center" valign="top">
  85. ATTRIBUTE VALUE</entry></row>
  86. </thead>
  87. <tbody>
  88. <row><entry>Availability</entry><entry>SUNWj3dev</entry></row>
  89. </tbody>
  90. </tgroup>
  91. </informaltable>
  92. </refsect1>
  93. <refsect1><title>&also-tt;</title>
  94. <para><citerefentry><refentrytitle>jar</refentrytitle><manvolnum>1</manvolnum>
  95. </citerefentry> </para>
  96. </refsect1>
  97. </refentry>
  98. <?Pub *0000005084>
  99.