home *** CD-ROM | disk | FTP | other *** search
/ io Programmo 14 / IOPROG_14.ISO / soft / sdkjava / sdkjava.exe / SDKJava.cab / Samples / Debugger / ReadMe.txt < prev   
Encoding:
Text File  |  1998-03-05  |  6.3 KB  |  204 lines
  1. Important
  2. =========
  3.  
  4. The key "HKEY_LOCAL_MACHINE\Software\Microsoft\Java VM\Debug" must exist to
  5. enable debugging under the Microsoft Java VM.  You can create this key
  6. programmatically.  You will probably not want to run with this key except when
  7. debugging since it disables the JIT compiler, and invokes a slower than normal
  8. version of the bytecode interpreter loop.  You can delete it using RegEdit.exe.
  9. The debugger samples create this key themselves to enable debugging.
  10.  
  11. Files of special interest are preceded by "***".
  12.  
  13.  
  14. Files
  15. =====
  16.  
  17. Debugger\
  18.     Java debugger sample code.
  19.  
  20.     JavaDbg.idl
  21.         An IDL description of the debugger interfaces.
  22.  
  23. *** ReadMe.txt
  24.         This file.
  25.  
  26.     C++ Debugger\
  27.         Source files for Win32 C++ debugger sample console application
  28.         JDebug.exe.
  29.  
  30.         GUIDs.cpp
  31.             GUIDs used by the C++ debugger sample.
  32.  
  33. ***     JDebug.bat
  34.             Runs the C++ debugger sample on "Hello, world" applet.
  35.  
  36. ***     JDebug.cpp
  37.             C++ debugger sample.
  38.  
  39.         JDebug.ico
  40.             Sample icon.
  41.  
  42.         JDebug.mak
  43.             MS Developer's studio makefile.
  44.  
  45.         JDebug.rc
  46.             MS Developer's studio resource file.
  47.  
  48.         Project.hpp
  49.             Common project header file.
  50.  
  51.         RefCount.hpp
  52.             Simple COM reference counting class.
  53.  
  54.         Resource.h
  55.             MS Developer's studio resource header file.
  56.  
  57.         Release\
  58.             Built release C++ debugger sample binaries.
  59.  
  60.             JDebug.exe
  61.                 Release Win32 C++ debugger sample console application.
  62.  
  63.     Hello\
  64.         Simple "Hello, world" sample Java debuggee applet.
  65.  
  66.         Hello.bat
  67.             Runs Hello under JView.exe.
  68.  
  69.         Hello.class
  70.             "Hello, world" Java class file.
  71.  
  72.         Hello.java
  73.             "Hello, world" Java source file.
  74.  
  75.     Java Debugger\
  76.         Source files for Java debugger sample application JavaDebugger.class.
  77.  
  78. ***     JavaDebugger.java
  79.             Java debugger Java source.
  80.  
  81.         DebuggeeProcess.java
  82.  
  83.         DebuggeeProcess.class
  84.         JavaDebugger.class
  85.             Java debugger .class files.
  86.  
  87.         JDbgHlpr.dll
  88.             Java debugger helper classes' native method implementations.
  89.  
  90. ***     JDebug.bat
  91.             Runs the Java debugger sample on "Hello, world" applet.
  92.  
  93.         com\ms\debug\
  94.  
  95.             *.class
  96.                 Java debugger interface and helper .class files.
  97.  
  98.         Helpers\
  99.             Source code for Java debugger helper classes.
  100.  
  101.             ConstantPoolHelper.java
  102.             EnumRemoteBooleanValueHelper.java
  103.             EnumRemoteDoubleValueHelper.java
  104.             EnumRemoteFloatValueHelper.java
  105.             LockBytesHelper.java
  106.             RemoteBooleanObjectHelper.java
  107.             RemoteDoubleObjectHelper.java
  108.             RemoteFloatObjectHelper.java
  109.                 Java debugger helper Java source.  Not all parameter types used
  110.                 by the debugger interfaces can be automatically marshaled by
  111.                 the current Java VM.  These classes and their native methods
  112.                 allow a Java debugger to use all the Java debugger interfaces
  113.                 supported by the Java VM.  The native methods of these classes
  114.                 are implemented in jdbghlpr.dll.  The need for at least some of
  115.                 these classes will be removed in future releases of the Java VM.
  116.  
  117.             JDbgHlpr\
  118.                 MS Developer's Studio source project for JDbgHlpr.dll.
  119.  
  120.                 *.h
  121.                     C header files describing Java class objects.  Generated by
  122.                     MSJavaH.
  123.  
  124.                 Helpers.cpp
  125.                     Native methods for Java debugger interface helper classes.
  126.  
  127.                 JDbgHlpr.cpp
  128.                     DLL entry point.
  129.  
  130.                 JDbgHlpr.def
  131.                     Module definition file.
  132.  
  133.                 JDbgHlpr.mak
  134.                     MS Developer's studio makefile.
  135.  
  136.                 JDbgHlpr.rc
  137.                     MS Developer's studio resource file.
  138.  
  139.                 Process.cpp
  140.                     Native methods for DebuggeeProcess.
  141.  
  142.                 Project.hpp
  143.                     Common project header file.
  144.  
  145.                 Resource.h
  146.                     MS Developer's studio resource header file.
  147.  
  148.         Prototypes\
  149.             Method prototypes for Java debugger interfaces.
  150.  
  151.             *.java
  152.                 Java shorthand source files describing debugger interface
  153.                 semantics for Java.  These are not the actual Java files used
  154.                 to generate the com\ms\debug .class files.  Those .class files
  155.                 contain additional COM marshaling information not present in
  156.                 these Java source files.  These Java source files are provided
  157.                 to briefly describe the semantics of the debugger interfaces
  158.                 under Java to developers.
  159.  
  160.  
  161. Notes
  162. =====
  163.  
  164. Java debugging functionality has been defined for the following areas, but not
  165. implemented:
  166.  
  167.     1) Passing a debug string from the debuggee to the debugger.
  168.         IRemoteProcessCallback::DebugStringEvent()
  169.  
  170.     2) Thread groups.
  171.         IEnumRemoteThread
  172.         IEnumRemoteThreadGroup
  173.         IJavaEnumRemoteThread
  174.         IJavaEnumRemoteThreadGroup
  175.         IRemoteProcess::GetThreadGroups()
  176.         IRemoteProcessCallback::ThreadGroupCreateEvent()
  177.         IRemoteProcessCallback::ThreadGroupDestroyEvent()
  178.         IRemoteThread::GetThreadGroup()
  179.         IRemoteThreadGroup
  180.  
  181.     3) Data breakpoints.
  182.         IRemoteObject::ClearBreakpoint()
  183.         IRemoteObject::SetBreakpoint()
  184.             Including ClearBreakpoint() and SetBreakpoint() of all interfaces
  185.             derived from IRemoteObject:
  186.                 IRemoteArrayObject
  187.                 IRemoteBooleanObject
  188.                 IRemoteByteObject
  189.                 IRemoteCharObject
  190.                 IRemoteClassObject
  191.                 IRemoteContainerObject
  192.                 IRemoteDoubleObject
  193.                 IRemoteFloatObject
  194.                 IRemoteIntObject
  195.                 IRemoteLongObject
  196.                 IRemoteShortObject
  197.         IRemoteProcessCallback::DataBreakpointEvent()
  198.  
  199. Subsequent releases of the Microsoft Java VM may implement these features.
  200.  
  201.  
  202. Copyright Microsoft Corporation 1998.
  203.  
  204.