home *** CD-ROM | disk | FTP | other *** search
/ Programming Languages Suite / JBuilder8.iso / Solaris / resource / jre / man / sman1 / javap.1 < prev    next >
Encoding:
Text File  |  2002-09-06  |  9.0 KB  |  191 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="javap-1">
  9. <!--@(#)javap.1 1.13 01/03/14 SMI;-->
  10. <refmeta><refentrytitle>javap</refentrytitle><manvolnum>1</manvolnum>
  11. <refmiscinfo class="date">Apr 23 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>javap</refname><refpurpose>Java class file disassembler
  20. </refpurpose></refnamediv>
  21. <refsynopsisdiv><title>&synp-tt;</title>
  22. <cmdsynopsis><command>javap</command><arg choice="opt"><option>b</option></arg>
  23. <arg choice="opt"><option>bootclasspath</option> <replaceable>path</replaceable></arg>
  24. <arg choice="opt"><option>c</option></arg><arg choice="opt"><option>classpath
  25. </option> <replaceable>path</replaceable></arg><arg choice="opt"><option>
  26. extdirs</option> <replaceable>dirs</replaceable></arg><arg choice="opt"><option>
  27. help</option></arg><arg choice="opt"><option>J</option> <replaceable>
  28. flag</replaceable></arg><arg choice="opt"><option>l</option></arg><arg choice="opt"><option>
  29. package</option></arg><arg choice="opt"><option>private</option></arg><arg
  30. choice="opt"><option>protected</option></arg><arg choice="opt"><option>public
  31. </option></arg><arg choice="opt"><option>s</option></arg><arg choice="opt"><option>
  32. verbose</option></arg><arg choice="plain" rep="repeat"><replaceable>class
  33. </replaceable></arg>
  34. </cmdsynopsis></refsynopsisdiv>
  35. <refsect1><title>&desc-tt;</title>
  36. <indexterm id="javap-1-indx-1"><primary sortas="Java class file disassembler">
  37. Java class file disassembler — javap</primary></indexterm><indexterm
  38. id="javap-1-indx-2"><primary sortas="javap">javap — Java class file
  39. disassembler</primary></indexterm><para>The <command>javap</command> command
  40. disassembles a Java™ class file. The options determine the output. If
  41. no options are used, <command>javap</command> prints out the <literal>package
  42. </literal>, <literal>protected</literal>, and <literal>public</literal> fields
  43. and methods of the classes passed to it. The <command>javap</command> command
  44. displays its output to <literal>stdout</literal>. For example, compile the
  45. following class declaration:<informalexample><para><screen>import java.awt.*;
  46. import java.applet.*;
  47.  
  48. public class DocFooter extends Applet {
  49.         String date;
  50.         String email;
  51.  
  52.         public void init() {
  53.             resize(500,100);
  54.  
  55.             date = getParameter("LAST_UPDATED");
  56.             email = getParameter("EMAIL");
  57.         }
  58.  
  59.         public void paint(Graphics g) {
  60.             g.drawString(date + " by ",100, 15);
  61.             g.drawString(email,290,15);
  62.         }
  63. }</screen></para>
  64. </informalexample></para>
  65. <para>The output from <command>javap</command> <literal>DocFooter</literal>
  66. yields:<informalexample><para><screen>Compiled from DocFooter.java
  67. public class DocFooter extends java.applet.Applet {
  68.     java.lang.String date;
  69.     java.lang.String email;
  70.     public void init();
  71.     public void paint(java.awt.Graphics);
  72.     public DocFooter();
  73. }
  74.  
  75. </screen></para>
  76. </informalexample></para>
  77. </refsect1>
  78. <refsect1><title>&opts-tt;</title>
  79. <para>The following options are supported:</para>
  80. <variablelist termlength="wholeline">
  81. <varlistentry><term remap="15"><option>b</option> </term><listitem><para>
  82. Ensures backward compatibility with <command>javap</command> in JDK 1.1.</para>
  83. </listitem></varlistentry>
  84. <varlistentry><term remap="15"><option>bootclasspath</option> <replaceable>
  85. path</replaceable> </term><listitem><para>Specifies path from which to load
  86. bootstrap classes. By default, the bootstrap classes are the classes implementing
  87. the core Java platform located in <filename>jre/lib/rt.jar</filename> and
  88. other important jar files.<?Pub Caret></para>
  89. </listitem></varlistentry>
  90. <varlistentry><term remap="15"><option>c</option> </term><listitem><para>
  91. Prints out disassembled code, that is, the instructions that comprise the
  92. Java bytecodes, for each of the methods in the class. These are documented
  93. in the Java Virtual Machine Specification.</para>
  94. </listitem></varlistentry>
  95. <varlistentry><term remap="15"><option>classpath</option> <replaceable>path
  96. </replaceable> </term><listitem><para>Specifies the <replaceable>path</replaceable> <command>
  97. javap</command> uses to look up classes. Overrides the default or the <envar>
  98. CLASSPATH</envar> environment variable if it is set. Directories are separated
  99. by colons (<literal>:</literal>). Thus the general format for <replaceable>
  100. path</replaceable> is:<informalexample><para><literal>.:<your_path></literal></para>
  101. </informalexample>For example:<informalexample><para><literal>.:/home/avh/classes:/usr/local/java/classes
  102. </literal> </para>
  103. </informalexample></para>
  104. </listitem></varlistentry>
  105. <varlistentry><term remap="15"><option>extdirs</option> <replaceable>dirs
  106. </replaceable></term><listitem><para>Overrides location at which installed
  107. extensions are searched. The default location for extensions is <filename>
  108. jre/lib/ext</filename>. </para>
  109. </listitem></varlistentry>
  110. <varlistentry><term remap="15"><option>help</option> </term><listitem><para>
  111. Prints out help message for <command>javap</command>. </para>
  112. </listitem></varlistentry>
  113. <varlistentry><term remap="15"><option>J</option> <replaceable>flag</replaceable> 
  114. </term><listitem><para>Passes <replaceable>flag</replaceable> directly to
  115. runtime system.<informalexample><para><screen>example% <userinput>javap –J–version
  116. </userinput>
  117.  
  118. example% <userinput>javap –JJ–Djava.security.manager \
  119.      –Djava.security.policy=MyPolicy MyClassName</userinput></screen></para>
  120. </informalexample></para>
  121. </listitem></varlistentry>
  122. <varlistentry><term remap="15"><option>l</option> </term><listitem><para>
  123. Displays line and local variable tables.</para>
  124. </listitem></varlistentry>
  125. <varlistentry><term remap="15"><option>package</option> </term><listitem>
  126. <para>Default. Shows only package, protected, and public classes and members.
  127. </para>
  128. </listitem></varlistentry>
  129. <varlistentry><term remap="15"><option>private</option> </term><listitem>
  130. <para>Shows all classes and members.</para>
  131. </listitem></varlistentry>
  132. <varlistentry><term remap="15"><option>protected</option> </term><listitem>
  133. <para>Shows only protected and public classes and members.</para>
  134. </listitem></varlistentry>
  135. <varlistentry><term remap="15"><option>public</option> </term><listitem><para>
  136. Shows only public classes and members.</para>
  137. </listitem></varlistentry>
  138. <varlistentry><term remap="15"><option>s</option> </term><listitem><para>
  139. Displays internal type signatures.</para>
  140. </listitem></varlistentry>
  141. <varlistentry><term remap="15"><option>verbose</option> </term><listitem>
  142. <para>Prints stack size, number of <replaceable>locals</replaceable>, and <replaceable>
  143. args</replaceable> for methods.</para>
  144. </listitem></varlistentry>
  145. </variablelist></refsect1>
  146. <refsect1><title>&envr-tt;</title>
  147. <variablelist termlength="narrow">
  148. <varlistentry><term remap="15"><envar>CLASSPATH</envar> </term><listitem>
  149. <para>Used to provide the system with a path to user-defined classes. Directories
  150. are separated by colons. For example: <informalexample><para><literal>.:/home/avh/classes:/usr/local/java/classes
  151. </literal> </para>
  152. </informalexample></para>
  153. </listitem></varlistentry>
  154. </variablelist></refsect1>
  155. <refsect1><title>&attr-tt;</title>
  156. <para>See <citerefentry><refentrytitle>attributes</refentrytitle><manvolnum>
  157. 5</manvolnum></citerefentry> for a description of the following attributes:
  158. </para>
  159. <informaltable frame="All" orient="Port">
  160. <tgroup cols="2" colsep="1" rowsep="1"><colspec colnum="1" colname="col1"
  161. colwidth="1*" colsep="1" align="Left"><colspec colnum="2" colname="col2" colwidth="1*"
  162. align="Left">
  163. <thead>
  164. <row><entry colname="col1" align="center" valign="top">ATTRIBUTE TYPE</entry>
  165. <entry colname="col2" align="center" valign="top">ATTRIBUTE VALUE</entry>
  166. </row>
  167. </thead>
  168. <tbody>
  169. <row><entry>Availability</entry><entry>SUNWj3dev</entry></row>
  170. </tbody>
  171. </tgroup>
  172. </informaltable>
  173. </refsect1>
  174. <refsect1><title>&also-tt;</title>
  175. <para><citerefentry><refentrytitle>java</refentrytitle><manvolnum>1</manvolnum>
  176. </citerefentry>, <citerefentry><refentrytitle>javac</refentrytitle><manvolnum>
  177. 1</manvolnum></citerefentry>, <citerefentry><refentrytitle>javadoc</refentrytitle>
  178. <manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>javah
  179. </refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>
  180. jdb</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry>
  181. <refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry> 
  182. </para>
  183. </refsect1>
  184. <!--+ 07/27/00 08:34:40
  185.     | tagMorph:  $Id: tagMorph-engine 1.54 1998/01/19 05:44:48 $
  186.     | tagMorph library:  $Id: libtagMorph.a 1.50 1998/01/19 22:02:51 $
  187.     | sunman-to-solbook 1.17
  188.     +-->
  189. </refentry>
  190. <?Pub *0000009186>
  191.