Table of Contents

• Title and Copyright Information
• Preface
  • Audience
  • Documentation Accessibility
  • Diversity and Inclusion
  • Related Documents
  • Conventions
• Part I General Java Troubleshooting
  • 1 Prepare Java for Troubleshooting
    • Update the Java Runtime
    • Enable Options and Flags for JVM Troubleshooting
    • Make a Java Application Easier to Debug
    • Gather Relevant Data
  • 2 Diagnostic Tools
    • Diagnostic Tools Overview
    • JDK Mission Control
      • Troubleshoot with JDK Mission Control
    • Flight Recorder
      • Produce a Flight Recording
        • Start a Flight Recording
        • Use Triggers for Automatic Flight Recordings
        • Use Startup Flags at the Command Line to Produce a Flight Recording
      • Analyze a Flight Recording
        • Analyze a Flight Recording Using JMC
          • View Automated Analysis Results Page
            • Analyze the Java Application
            • JVM Internals
            • Environment
        • Analyze a Flight Recording Using the jfr tool or JFR APIs
    • The jcmd Utility
      • Useful Commands for the jcmd Utility
      • Troubleshoot with the jcmd Utility
    • Native Memory Tracking
      • How to Monitor VM Internal Memory
      • Use NMT to Detect a Memory Leak
      • NMT Memory Categories
    • JConsole
      • Troubleshoot with the JConsole Tool
      • Monitor Local and Remote Applications with JConsole
    • The jdb Utility
      • Troubleshoot with the jdb Utility
    • The jinfo Utility
      • Troubleshooting with the jinfo Utility
    • The jmap Utility
      • Heap Configuration and Usage
      • Heap Histogram
      • Class Loader Statistics
    • The jps Utility
    • The jrunscript Utility
    • The jstack Utility
      • Troubleshoot with the jstack Utility
      • Stack Trace from a Core Dump
      • Mixed Stack
    • The jstat Utility
    • The visualgc Tool
    • Control+Break Handler
      • Thread Dump
      • Thread States for a Thread Dump
      • Detect Deadlocks
      • Heap Summary
    • Native Operating System Tools
      • Troubleshooting Tools Based on the Operating System
      • Probe Providers in Java HotSpot VM
    • Custom Diagnostic Tools
      • The java.lang.management Package
      • The java.lang.instrument Package
      • The java.lang.Thread Class
      • JVM Tool Interface
      • Java Platform Debugger Architecture
    • Postmortem Diagnostic Tools
    • Hung Processes Tools
    • Monitoring Tools
    • Other Tools, Options, Variables, and Properties
    • The jstatd Daemon
  • 3 Troubleshoot Memory Leaks
    • The java.lang.OutOfMemoryError Error
    • Detecting a Memory Leak
      • JConsole
      • JDK Mission Control
      • Garbage Collection logs
    • Diagnosing Java Memory Leaks
      • Diagnostic Data
        • Heap Histograms
        • Heap Dumps
        • Java Flight Recordings
        • Class Loader Statistics
      • Analysis Tools
        • Heap Dump Analysis Tools
        • JDK Mission Control (JMC)
        • The jfr tool
        • NetBeans Profiler
    • Diagnosing Native Memory Leaks
      • Tracking All Memory Allocation and Free Calls
        • Native Memory Leaks for Allocations performed by the JVM
        • Native Memory Leaks from Outside the JVM
      • Tracking All Memory Allocations in the JNI Library
    • Monitoring the Objects Pending Finalization
    • Troubleshooting a Crash Instead of a java.lang.OutOfMemoryError error
  • 4 Troubleshoot Performance Issues Using Flight Recorder
    • Flight Recorder Overhead
    • Find Bottlenecks
      • Find Bottlenecks
      • Use the jfr Tool to Find Bottlenecks
    • Garbage Collection Performance
      • Use JDK Mission Control to Debug Garbage Collection Issues
      • Use the jfr Tool to Debug Garbage Collection Issues
    • Synchronization Performance
      • Synchronization Performance
      • Use jdk.JavaMonitorWait Events to Debug Synchronization Issues
    • I/O Performance
      • I/O Performance
      • Use the Socket Read and Write Events to Debug I/O Issues
    • Code Execution Performance
      • Code Execution Performance
      • Use jdk.CPULoad and jdk.ThreadCPULoad Events to Monitor Code Execution Performance
  • 5 Troubleshoot Security APIs
• Part II Debug JVM Issues
  • 6 Troubleshoot System Crashes
    • Determine Where the Crash Occurred
      • Crash the Native Code
      • Crash in the Compiled Code
      • Crash in the HotSpot Compiler Thread
      • Crash in the VM Thread
      • Crash Due to Stack Overflow
    • Find a Workaround
      • Working Around Crashes in the HotSpot Compiler Thread or Compiled Code
      • Working Around Crashes During Garbage Collection
      • Working Around Crashes Caused by Class Data Sharing
    • Microsoft Visual C++ Version Considerations
  • 7 Troubleshoot Process Hangs and Loops
    • Diagnose a Loop Process
    • Diagnose a Hung Process
      • Deadlock Detected
      • Deadlock Not Detected
      • No Thread Dump
  • 8 Handle Signals and Exceptions
    • Handle Signals on Linux and macOS
    • Handle Exceptions on Windows
    • Signal Chaining
    • Handle Exceptions Using the Java HotSpot VM
    • Console Handlers
    • Signals Used in Linux and macOS
• Part III Debug Core Library Issues
  • 9 Time Zone Settings in the JRE
    • Native Time Zone Information and the JRE
      • Determine the Time Zone Data Version in Use
      • Troubleshoot Problems with Java Time Zone Updater Tool
    • Determine the Default Time Zone on Windows
      • Check the Default Time Zone Java Runtime Reports
      • Determine the Setting in the Control Panel
      • Check for Automatic Daylight Saving Time Adjustment
      • Set the Default Time Zone in Windows Settings
      • Check -Duser.timezone System Property
      • Special Tool in Windows
      • Internal Representation of Time Zone Mappings
• Part IV Debug Client Issues
  • 10 Introduction to Client Issues
    • Java SE Desktop Technologies
    • General Steps to Troubleshoot an Issue
    • Identify the Type of Issue
      • Java Client Crashes
      • Performance Problems
      • Behavior Problems
    • Basic Tools
    • Java Debug Wire Protocol
  • 11 AWT
    • Debug Tips for AWT
    • Layout Manager Issues
    • Key Events
    • Modality Issues
    • AWT Crashes
    • Focus Events
      • How to Trace Focus Events
      • Native Focus System
      • Focus Models Supported by X Window Managers
      • Miscellaneous Problems with Focus
    • Data Transfer
      • Debug Drag-and-Drop Applications
      • Frequent Issues with Data Transfer
    • Other Issues
      • Splash Screen Issues
      • Tray Icon Issues
      • Pop-up Menu Issues
      • Background or Foreground Color Inheritance
      • AWT Panel Size Restriction
      • Hangs During Debugging of Pop-up Menus and Similar Components on X11
      • Window.toFront()/toBack() Behavior on X11
    • Heavyweight or Lightweight Components Mix
  • 12 Java 2D Pipeline Rendering and Properties
    • Linux: X11 Pipeline
      • X11 Pipeline Pixmaps Properties
      • X11 Pipeline MIT Shared Memory Extension
    • Windows OS: DirectDraw/GDI Pipeline
    • Windows OS: Direct3D Pipeline in Full-Screen Mode
    • OpenGL Pipeline in Linux and Windows
      • Enable OpenGL Pipeline
      • Minimum Requirements
      • Diagnose Startup Issues
      • Diagnose Rendering and Performance Issues
      • Latest OpenGL Drivers
  • 13 Java 2D
    • Generic Performance Issues
      • Hardware-Accelerated Rendering Primitives
      • Primitive Tracing to Detect and Avoid Non-Accelerated Rendering
      • Causes of Poor Rendering Performance
      • Improve Performance of Software-only Rendering
    • Text-Related Issues
      • Application Crash During Text Rendering
      • Differences in Text Appearance
      • Font Metrics
    • Java 2D Printing
  • 14 Swing
    • General Debug Tips for Swing
    • Specific Debug Tips for Swing
      • Incorrect Threading
      • JComponent Children Overlap
      • Display Update
      • Model Change
      • Add or Remove Components
      • Opaque Override
      • Permanent Changes to Graphics
      • Custom Painting and Double Buffering
      • Opaque Content Pane
      • Renderer Call for Each Cell Performance
      • Possible Leaks
      • Mix Heavyweight and Lightweight Components
      • Use Synth
      • Track Activity on Event Dispatch Thread
      • Specify Default Layout Manager
      • Listener Object Dispatched to Incorrect Component
      • Add a Component to Content Pane
      • Drag and Drop Support
      • One Parent for a Component
      • JFileChooser Issues with Windows Shortcuts
  • 15 Internationalization
    • Troubleshoot Internationalization and Localization
  • 16 Java Sound
    • Troubleshoot Java Sound Issues
• Part V Submit Bug Reports
  • 17 Submit a Bug Report
    • Check for Fixes in Update Releases
    • Prepare to Submit a Bug Report
    • Collect Data for a Bug Report
      • Detailed Description of the Problem
      • Hardware Details
      • Operating System Details
      • Java SE Version
      • Command-Line Options
      • Environment Variables
      • Fatal Error Log
      • Core and Crash Dump
      • Logs and Traces
    • Report a Bug
    • Collect Core Dumps
      • Collect Core Dumps on Linux
      • Reasons for Not Getting a Core File
      • Collect Crash Dumps on Windows
• Appendices
  • A Fatal Error Log
    • Location of Fatal Error Log
    • Description of Fatal Error Log
    • Header Format
    • Thread Section Format
    • Process Section Format
    • System Section Format
  • B Java 2D Properties
    • Properties on Linux
    • Properties on Windows
    • Properties on macOS
  • C Environment Variables and System Properties
    • The JAVA_TOOL_OPTIONS Environment Variable
    • The java.security.debug System Property
  • D Command-Line Options
    • Java HotSpot VM Command-Line Options
    • Other Command-Line Options
  • E Summary of Tools in This Release