jstack.1 revision 0
0N/A.'" t
0N/A."
0N/A." Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
0N/A." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
0N/A."
0N/A." This code is free software; you can redistribute it and/or modify it
0N/A." under the terms of the GNU General Public License version 2 only, as
0N/A." published by the Free Software Foundation.
0N/A."
0N/A." This code is distributed in the hope that it will be useful, but WITHOUT
0N/A." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
0N/A." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
0N/A." version 2 for more details (a copy is included in the LICENSE file that
0N/A." accompanied this code).
0N/A."
0N/A." You should have received a copy of the GNU General Public License version
0N/A." 2 along with this work; if not, write to the Free Software Foundation,
0N/A." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
0N/A."
0N/A." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
0N/A." CA 95054 USA or visit www.sun.com if you need additional information or
0N/A." have any questions.
0N/A."
0N/A." `
0N/A.TH jstack 1 "07 Aug 2006"
0N/A." Generated by html2man
0N/A
0N/A.LP
0N/A.SH NAME
0N/Ajstack \- Stack Trace
0N/A.br
0N/A
0N/A.LP
0N/A.SH "SYNOPSIS"
0N/A.LP
0N/A
0N/A.LP
0N/A.nf
0N/A\f3
0N/A.fl
0N/A\fP\f3jstack\fP [ option ] pid
0N/A.fl
0N/A\f3jstack\fP [ option ] executable core
0N/A.fl
0N/A\f3jstack\fP [ option ] [server\-id@]remote\-hostname\-or\-IP
0N/A.fl
0N/A.fi
0N/A
0N/A.LP
0N/A.SH "PARAMETERS"
0N/A.LP
0N/A
0N/A.LP
0N/A.LP
0N/AOptions are mutually exclusive. Option, if used, should follow immediately after the command name. See OPTIONS.
0N/A.LP
0N/A.RS 3
0N/A.TP 3
0N/Apid
0N/Aprocess 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.
0N/A.RE
0N/A
0N/A.LP
0N/A.RS 3
0N/A.TP 3
0N/Aexecutable
0N/AJava executable from which the core dump was produced.
0N/A.br
0N/A.TP 3
0N/Acore
0N/Acore file for which the stack trace is to be printed.
0N/A.br
0N/A.TP 3
0N/Aremote\-hostname\-or\-IP
0N/Aremote debug server's (see jsadebugd) hostname or IP address.
0N/A.br
0N/A.TP 3
0N/Aserver\-id
0N/Aoptional unique id, if multiple debug servers are running on the same remote host.
0N/A.RE
0N/A
0N/A.LP
0N/A.SH "DESCRIPTION"
0N/A.LP
0N/A
0N/A.LP
0N/A.LP
0N/A\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.:
0N/A.br
0N/A
0N/A.LP
0N/A.RS 3
0N/A
0N/A.LP
0N/A.nf
0N/A\f3
0N/A.fl
0N/Ajstack \-J\-d64 \-m pid
0N/A.fl
0N/A\fP
0N/A.fi
0N/A.RE
0N/A
0N/A.LP
0N/A.LP
0N/A\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
0N/A.LP
0N/A.nf
0N/A\f3
0N/A.fl
0N/A\fP\f3 jstack pid \fP
0N/A.fl
0N/A.fi
0N/A
0N/A.LP
0N/A.SH "OPTIONS"
0N/A.LP
0N/A
0N/A.LP
0N/A.RS 3
0N/A.TP 3
0N/A\-F
0N/AForces a stack dump when 'jstack pid' does not respond.
0N/A.TP 3
0N/A\-m
0N/Aprints mixed mode (both Java and native C/C++ frames) stack trace.
0N/A.TP 3
0N/A\-h
0N/Aprints a help message.
0N/A.br
0N/A.br
0N/A.TP 3
0N/A\-help
0N/Aprints a help message
0N/A.br
0N/A.RE
0N/A
0N/A.LP
0N/A.SH "SEE ALSO"
0N/A.LP
0N/A.RS 3
0N/A.TP 2
0N/Ao
0N/Apstack(1)
0N/A.TP 2
0N/Ao
0N/Ac++filt(1)
0N/A.TP 2
0N/Ao
0N/Ajps
0N/A.TP 2
0N/Ao
0N/Ajsadebugd
0N/A.RE
0N/A
0N/A.LP
0N/A.SH "KNOWN BUGS"
0N/A.LP
0N/A
0N/A.LP
0N/A.LP
0N/AMixed mode stack trace, the \-m option, does not work with the remote debug server.
0N/A.LP
0N/A
0N/A.LP
0N/A
0N/A