annotate src/linux/doc/man/jstack.1 @ 0:37a05a11f281

Initial load
author duke
date Sat, 01 Dec 2007 00:00:00 +0000
parents
children b056c42ea5b4
rev   line source
duke@0 1 .'" t
duke@0 2 ."
duke@0 3 ." Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
duke@0 4 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
duke@0 5 ."
duke@0 6 ." This code is free software; you can redistribute it and/or modify it
duke@0 7 ." under the terms of the GNU General Public License version 2 only, as
duke@0 8 ." published by the Free Software Foundation.
duke@0 9 ."
duke@0 10 ." This code is distributed in the hope that it will be useful, but WITHOUT
duke@0 11 ." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
duke@0 12 ." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
duke@0 13 ." version 2 for more details (a copy is included in the LICENSE file that
duke@0 14 ." accompanied this code).
duke@0 15 ."
duke@0 16 ." You should have received a copy of the GNU General Public License version
duke@0 17 ." 2 along with this work; if not, write to the Free Software Foundation,
duke@0 18 ." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
duke@0 19 ."
duke@0 20 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
duke@0 21 ." CA 95054 USA or visit www.sun.com if you need additional information or
duke@0 22 ." have any questions.
duke@0 23 ."
duke@0 24 ." `
duke@0 25 .TH jstack 1 "07 Aug 2006"
duke@0 26 ." Generated by html2man
duke@0 27
duke@0 28 .LP
duke@0 29 .SH NAME
duke@0 30 jstack \- Stack Trace
duke@0 31 .br
duke@0 32
duke@0 33 .LP
duke@0 34 .SH "SYNOPSIS"
duke@0 35 .LP
duke@0 36
duke@0 37 .LP
duke@0 38 .nf
duke@0 39 \f3
duke@0 40 .fl
duke@0 41 \fP\f3jstack\fP [ option ] pid
duke@0 42 .fl
duke@0 43 \f3jstack\fP [ option ] executable core
duke@0 44 .fl
duke@0 45 \f3jstack\fP [ option ] [server\-id@]remote\-hostname\-or\-IP
duke@0 46 .fl
duke@0 47 .fi
duke@0 48
duke@0 49 .LP
duke@0 50 .SH "PARAMETERS"
duke@0 51 .LP
duke@0 52
duke@0 53 .LP
duke@0 54 .LP
duke@0 55 Options are mutually exclusive. Option, if used, should follow immediately after the command name. See OPTIONS.
duke@0 56 .LP
duke@0 57 .RS 3
duke@0 58 .TP 3
duke@0 59 pid
duke@0 60 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.
duke@0 61 .RE
duke@0 62
duke@0 63 .LP
duke@0 64 .RS 3
duke@0 65 .TP 3
duke@0 66 executable
duke@0 67 Java executable from which the core dump was produced.
duke@0 68 .br
duke@0 69 .TP 3
duke@0 70 core
duke@0 71 core file for which the stack trace is to be printed.
duke@0 72 .br
duke@0 73 .TP 3
duke@0 74 remote\-hostname\-or\-IP
duke@0 75 remote debug server's (see jsadebugd) hostname or IP address.
duke@0 76 .br
duke@0 77 .TP 3
duke@0 78 server\-id
duke@0 79 optional unique id, if multiple debug servers are running on the same remote host.
duke@0 80 .RE
duke@0 81
duke@0 82 .LP
duke@0 83 .SH "DESCRIPTION"
duke@0 84 .LP
duke@0 85
duke@0 86 .LP
duke@0 87 .LP
duke@0 88 \f3jstack\fP prints Java stack traces of Java threads for a given Java process or core file or a remote debug server. For each Java frame, the full class name, method name, 'bci' (byte code index) and line number, if available, are printed. With the \-m option, jstack prints both Java and native frames of all threads along with the 'pc' (program counter). For each native frame, the closest native symbol to 'pc', if available, is printed. C++ mangled names are not demangled. To demangle C++ names, the output of this command may be piped to \f3c++filt\fP. If the given process is running on a 64\-bit VM, you may need to specify the \f2\-J\-d64\fP option, e.g.:
duke@0 89 .br
duke@0 90
duke@0 91 .LP
duke@0 92 .RS 3
duke@0 93
duke@0 94 .LP
duke@0 95 .nf
duke@0 96 \f3
duke@0 97 .fl
duke@0 98 jstack \-J\-d64 \-m pid
duke@0 99 .fl
duke@0 100 \fP
duke@0 101 .fi
duke@0 102 .RE
duke@0 103
duke@0 104 .LP
duke@0 105 .LP
duke@0 106 \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
duke@0 107 .LP
duke@0 108 .nf
duke@0 109 \f3
duke@0 110 .fl
duke@0 111 \fP\f3 jstack pid \fP
duke@0 112 .fl
duke@0 113 .fi
duke@0 114
duke@0 115 .LP
duke@0 116 .SH "OPTIONS"
duke@0 117 .LP
duke@0 118
duke@0 119 .LP
duke@0 120 .RS 3
duke@0 121 .TP 3
duke@0 122 \-F
duke@0 123 Forces a stack dump when 'jstack pid' does not respond.
duke@0 124 .TP 3
duke@0 125 \-m
duke@0 126 prints mixed mode (both Java and native C/C++ frames) stack trace.
duke@0 127 .TP 3
duke@0 128 \-h
duke@0 129 prints a help message.
duke@0 130 .br
duke@0 131 .br
duke@0 132 .TP 3
duke@0 133 \-help
duke@0 134 prints a help message
duke@0 135 .br
duke@0 136 .RE
duke@0 137
duke@0 138 .LP
duke@0 139 .SH "SEE ALSO"
duke@0 140 .LP
duke@0 141 .RS 3
duke@0 142 .TP 2
duke@0 143 o
duke@0 144 pstack(1)
duke@0 145 .TP 2
duke@0 146 o
duke@0 147 c++filt(1)
duke@0 148 .TP 2
duke@0 149 o
duke@0 150 jps
duke@0 151 .TP 2
duke@0 152 o
duke@0 153 jsadebugd
duke@0 154 .RE
duke@0 155
duke@0 156 .LP
duke@0 157 .SH "KNOWN BUGS"
duke@0 158 .LP
duke@0 159
duke@0 160 .LP
duke@0 161 .LP
duke@0 162 Mixed mode stack trace, the \-m option, does not work with the remote debug server.
duke@0 163 .LP
duke@0 164
duke@0 165 .LP
duke@0 166