Documentation Contents

Contents

Title and Copyright Information

Preface

• Audience
• Documentation Accessibility
• Related Documents
• Conventions

1 Diagnostic Tools and Options

• Introduction
• Summary of Tools and Options
  • Tools and Options for Post-Mortem Diagnostics
  • Tools and Options for Hung Processes
  • Tools and Options for Monitoring
  • Other Tools, Options, Variables, and Properties

2 Detailed Tool Descriptions

• HPROF
  • Heap Allocation Profile (heap=sites)
  • Heap Dump Profile (heap=dump)
  • CPU Usage Sampling Profile (cpu=samples)
  • CPU Usage Times Profile (cpu=times)
• Java VisualVM
• JConsole
• The jdb Utility
  • Attaching to a Process
  • Attaching to a Core File on the Same Machine
  • Attaching to a Core File or a Hung Process from a Different Machine
• The jhat Utility
  • Standard Queries
  • Custom Queries
  • Heap Analysis Hints
• The jinfo Utility
• The jmap Utility
  • Heap Configuration and Usage
  • Heap Histogram
  • Permanent Generation Statistics
• The jps Utility
• The jrunscript Utility
• The jsadebugd Daemon
• The jstack Utility
  • Forcing a Stack Dump
  • Printing Stack Trace From Core Dump
  • Printing a Mixed Stack
• The jstat Utility
• The jstatd Daemon
• The visualgc Tool
• Control+Break Handler
  • Thread Dump
  • Detected Deadlocks
  • Heap Summary
• Native Operating System Tools
  • Using the DTrace Tool
  • Improvements in the pmap Tool
  • Improvements in the pstack Tool
• Custom Diagnostic Tools
  • The java.lang.management Package
  • The java.lang.instrument Package
  • The java.lang.Thread Class
  • Java Virtual Machine Tools Interface
  • Java Platform Debugger Architecture

3 Troubleshooting Memory Leaks

• Understanding the OutOfMemoryError Exception
• Crash Instead of OutOfMemoryError
• Diagnosing Leaks in Java Language Code
  • Creating a Heap Dump
  • Obtaining a Heap Histogram
  • Monitoring the Number of Objects Pending Finalization
• Diagnosing Leaks in Native Code
  • Tracking All Memory Allocation and Free Calls
  • Tracking Memory Allocation in a JNI Library
  • Tracking Memory Allocation With OS Support
  • Using the dbx Debugger to Find Leaks
  • Using the libumem Tool to Find Leaks

4 Troubleshooting System Crashes

• Determining Where the Crash Occurred
  • Crash in Native Code
  • Crash in Compiled Code
  • Crash in the HotSpot Compiler Thread
  • Crash in VMThread
  • Crash Due to Stack Overflow
• Finding 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

5 Troubleshooting Hanging or Looping Processes

• Diagnosing a Looping Process
• Diagnosing a Hung Process
  • Deadlock Detected
  • Deadlock Not Detected
  • No Thread Dump
• Solaris 8 OS Thread Library

6 Integrating Signal and Exception Handling

• Signal Handling on Solaris OS and Linux
  • Signal Chaining
• Exception Handling on Windows
  • Exception Handling By the Java HotSpot VM
  • Console Handlers

7 Submitting Bug Reports

• Checking for Existing Fixes in Update Releases
• Preparing to Submit a Bug Report
• Collecting Data for a Bug Report
  • Hardware Details
  • Operating System
  • Java SE Version
  • Command-Line Options
  • Environment Variables
  • Fatal Error Log
  • Core or Crash Dump
  • Detailed Description of the Problem
  • Logs and Traces
  • Results from Troubleshooting Steps
• Collecting Core Dumps
  • Collecting Core Dumps on Solaris OS
  • Collecting Core Dumps on Linux
  • Reasons for Not Getting a Core File
  • Collecting Crash Dumps on Windows

A Environment Variables and System Properties

B Command-Line Options

• HotSpot VM Command-Line Options
  • The -XX:+HeapDumpOnOutOfMemoryError Option
  • The -XX:OnError= Option
  • The -XX:+ShowMessageBoxOnError Option
  • Other -XX Options
• Other Command-Line Options
  • The -Xcheck:jni Option
  • The -verbose:class Option
  • The -verbose:gc Option
  • The -verbose:jni Option

C Fatal Error Log

• Location of Fatal Error Log
• Description of Fatal Error Log
• Header Format
• Thread Section Format
  • Thread Information
  • Signal Information
  • Register Context
  • Machine Instructions
  • Thread Stack
  • Further Details
• Process Section Format
  • Thread List
  • VM State
  • Mutexes and Monitors
  • Heap Summary
  • Memory Map
  • VM Arguments and Environment Variables
  • Signal Handlers
• System Section Format

D Summary of Tools in This Release

• Changes to Troubleshooting Tools in JDK 7

---

Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Contact Us