jdk/src/linux/doc/man/jstack.1
changeset 2692 345bc8d65b19
parent 2 90ce3da70b43
child 5506 202f599c92aa
--- a/jdk/src/linux/doc/man/jstack.1	Thu Apr 30 15:04:39 2009 -0700
+++ b/jdk/src/linux/doc/man/jstack.1	Mon May 04 18:28:26 2009 -0700
@@ -1,6 +1,4 @@
-.'" t
-."
-." Copyright 2004-2006 Sun Microsystems, Inc.  All Rights Reserved.
+." Copyright 2004 Sun Microsystems, Inc.  All Rights Reserved.
 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
 ."
 ." This code is free software; you can redistribute it and/or modify it
@@ -21,12 +19,11 @@
 ." CA 95054 USA or visit www.sun.com if you need additional information or
 ." have any questions.
 ."
-." `
-.TH jstack 1 "07 Aug 2006"
-." Generated by html2man
+.TH jstack 1 "04 May 2009"
+." Generated from HTML by html2man (author: Eric Armstrong)
 
 .LP
-.SH NAME
+.SH "Name"
 jstack \- Stack Trace
 .br
 
@@ -57,7 +54,7 @@
 .RS 3
 .TP 3
 pid 
-process id for which the stack trace is to be printed. The process must be a Java process. To get a list of Java processes running on a machine, jps may be used. 
+process id for which the stack trace is to be printed. The process must be a Java process. To get a list of Java processes running on a machine, jps(1) may be used. 
 .RE
 
 .LP
@@ -72,7 +69,7 @@
 .br
 .TP 3
 remote\-hostname\-or\-IP 
-remote debug server's (see jsadebugd) hostname or IP address. 
+remote debug server's (see jsadebugd(1)) hostname or IP address. 
 .br
 .TP 3
 server\-id 
@@ -103,15 +100,10 @@
 
 .LP
 .LP
-\f3NOTE \- This utility is unsupported and may or may not be available in future versions of the JDK. The only form of jstack that is available on Windows platforms is\fP
+\f3NOTE\fP \- This utility is unsupported and may or may not be available in future versions of the JDK. In Windows Systems where dbgeng.dll is not present, 'Debugging Tools For Windows' needs to be installed to have these tools working. Also, \f2PATH\fP environment variable should contain the location of \f2jvm.dll\fP used by the target process or the location from which the Crash Dump file was produced.
 .LP
-.nf
-\f3
-.fl
-\fP\f3    jstack pid \fP
-.fl
-.fi
-
+.LP
+For example, \f2set PATH=<jdk>\\jre\\bin\\client;%PATH%\fP
 .LP
 .SH "OPTIONS"
 .LP
@@ -120,7 +112,14 @@
 .RS 3
 .TP 3
 \-F 
-Forces a stack dump when 'jstack pid' does not respond. 
+Force a stack dump when 'jstack [\-l] pid' does not respond. 
+.TP 3
+\-l 
+Long listing. Prints additional information about locks such as list of owned java.util.concurrent 
+.na
+\f2ownable synchronizers\fP @
+.fi
+http://java.sun.com/javase/6/docs/api/java/util/concurrent/locks/AbstractOwnableSynchronizer.html. 
 .TP 3
 \-m 
 prints mixed mode (both Java and native C/C++ frames) stack trace. 
@@ -147,10 +146,10 @@
 c++filt(1) 
 .TP 2
 o
-jps 
+jps(1) 
 .TP 2
 o
-jsadebugd 
+jsadebugd(1) 
 .RE
 
 .LP