aboutsummaryrefslogtreecommitdiffstats
path: root/lib/observer/doc/src/crashdump_help.html
diff options
context:
space:
mode:
authorErlang/OTP <[email protected]>2009-11-20 14:54:40 +0000
committerErlang/OTP <[email protected]>2009-11-20 14:54:40 +0000
commit84adefa331c4159d432d22840663c38f155cd4c1 (patch)
treebff9a9c66adda4df2106dfd0e5c053ab182a12bd /lib/observer/doc/src/crashdump_help.html
downloadotp-84adefa331c4159d432d22840663c38f155cd4c1.tar.gz
otp-84adefa331c4159d432d22840663c38f155cd4c1.tar.bz2
otp-84adefa331c4159d432d22840663c38f155cd4c1.zip
The R13B03 release.OTP_R13B03
Diffstat (limited to 'lib/observer/doc/src/crashdump_help.html')
-rw-r--r--lib/observer/doc/src/crashdump_help.html307
1 files changed, 307 insertions, 0 deletions
diff --git a/lib/observer/doc/src/crashdump_help.html b/lib/observer/doc/src/crashdump_help.html
new file mode 100644
index 0000000000..736a024288
--- /dev/null
+++ b/lib/observer/doc/src/crashdump_help.html
@@ -0,0 +1,307 @@
+</<!doctype chapter PUBLIC "-//Stork//DTD chapter//EN">
+<!--
+ ``The contents of this file are subject to the Erlang Public License,
+ Version 1.1, (the "License"); you may not use this file except in
+ compliance with the License. You should have received a copy of the
+ Erlang Public License along with this software. If not, it can be
+ retrieved via the world wide web at http://www.erlang.org/.
+
+ Software distributed under the License is distributed on an "AS IS"
+ basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See
+ the License for the specific language governing rights and limitations
+ under the License.
+
+ The Initial Developer of the Original Code is Ericsson Utvecklings AB.
+ Portions created by Ericsson are Copyright 1999, Ericsson Utvecklings
+ AB. All Rights Reserved.''
+
+ $Id$
+-->
+<html>
+<head>
+<title>Crashdump Viewer help</title>
+</head>
+<body BGCOLOR="#FFFFFF">
+<center>
+<a HREF="http://www.erlang.se"><img BORDER=0 ALT="[Erlang Systems]"
+SRC="min_head.gif"></a>
+</center>
+<blockquote>
+ <h2>Information pages</h2>
+
+ <p>Each menu item points to an information page. If no information
+ is found for an item, the page will simply say "No information
+ found". The reason for not finding any information about an item
+ can be that the dump is truncated, that it is a dump from an old
+ OTP release in which this item was not written or that the item
+ simply wasn't present in the system at the point of failure.
+
+ <p>If the dump was truncated, a warning is displayed.
+
+ <p>Even if some information about an item exists, there might be
+ empty fields if the dump originates from an old OTP release.
+
+ <p>The value "-1" in any field means "unknown", and in most cases
+ it means that the dump was truncated somewhere around this field.
+
+ <p>Only some of the fields in the different information pages are
+ described here. These are fields that to not exist in the raw
+ crashdump, or in some way differs from the fields in the raw
+ crashdump. Details about other field can be found in the user's
+ guide for the Erlang runtime system, in the chapter "How to
+ interpret the Erlang crash dumps". A link to this chapter can be
+ found in the Crashdump Viewer's menu under documentation, and
+ there are also direct links from the specific sections below to
+ related information in "How to interpret the Erlang crash dumps".
+
+ <a NAME="general_info">
+ <h3>General information</h3>
+
+ <p>This is the first page shown when a new dump is loaded into
+ the system. It shows a very short overview of the dump.
+
+ <p>'Node name' will only exist in dumps originating from OTP R9C
+ and later.
+
+ <p>The following fields are not described in the Erlang runtime
+ system user's guide:
+
+ <dl>
+ <dt><strong>Crashdump created on</strong></dt>
+ <dd>Time of failure.</dd>
+
+ <dt><strong>Memory allocated</strong></dt>
+ <dd>The total number of bytes allocated, equivalent to
+ <code>c:memory(total)</code>. This will only be present in
+ dumps from OTP R9C and later.</dd>
+
+ <dt><strong>Memory maximum</strong></dt>
+ <dd>The maximum number of bytes that has been allocated
+ during the lifetime of the originating node. This will not be
+ present in dumps older than OTP R9C, and even in newer
+ releases it is only shown if the Erlang runtime system was run
+ instrumented.</dd>
+
+ <dt><strong>Atoms</strong></dt>
+ <dd>If at all available in the dump, this is the total
+ number of atoms in the atom table. If the size of the atom
+ table is not available, the number of atoms visible in the
+ dump is presented.</dd>
+
+ <dt><strong>Processes, ETS tables and Funs</strong></dt>
+ <dd>The number of processes, ETS tables and funs visible in
+ the dump.</dd>
+ </dl>
+
+ <center>
+ <a href=/crashdump_erts_doc/crash_dump.html#general_info>
+ More...</a>
+ </center>
+
+
+ <a NAME="processes">
+ <h3>Processes</h3>
+
+ <p>The Process Information page shows a list of all processes
+ found in the crashdump, including some short information about
+ each process. By default the processes are sorted by their
+ pids. To sort by other topic, click any heading in the process
+ table.
+
+ <p>Detailed information about a specific process is shown when
+ the pid is clicked.
+
+ <center>
+ <a href=/crashdump_erts_doc/crash_dump.html#processes>
+ More...</a>
+ </center>
+
+
+
+ <a NAME="ports">
+ <h3>Ports</h3>
+
+ <p>The port information page shows all port information found in
+ the dump.
+
+ <center>
+ <a href=/crashdump_erts_doc/crash_dump.html#ports>
+ More...</a>
+ </center>
+
+
+
+ <a NAME="ets_tables">
+ <h3>ETS tables</h3>
+
+ <p>The ETS table information page shows all ETS table
+ information found in the dump. The 'Id' is the same as the
+ 'Table' field found in the raw crashdump, and 'Memory' is the
+ 'Words' field from the raw crashdump translated into
+ bytes. 'Type' is the type of table, and it can be either "hash"
+ or "tree". For tree tables there will be no value in the
+ 'Bucket' field.
+
+ <p>Clicking a pid in the 'Owner' column takes you to the
+ detailed information about the process owning the ETS table.
+
+ <center>
+ <a href=/crashdump_erts_doc/crash_dump.html#ets_tables>
+ More...</a>
+ </center>
+
+
+ <a NAME="timers">
+ <h3>Timers</h3>
+
+ <p>The timer information page shows all timer information found
+ in the dump.
+
+ <p>Clicking a pid in the 'Owner' column takes you to the
+ detailed information about the process owning the timer.
+
+ <center>
+ <a href=/crashdump_erts_doc/crash_dump.html#timers>
+ More...</a>
+ </center>
+
+
+
+ <a NAME="funs">
+ <h3>Fun table</h3>
+
+ <p>The Fun table information page shows all Fun information
+ found in the dump. Fun information will only exist in dumps from
+ OTP R8B or later.
+
+ <center>
+ <a href=/crashdump_erts_doc/crash_dump.html#funs>
+ More...</a>
+ </center>
+
+
+
+ <a NAME="atoms">
+ <h3>Atoms</h3>
+
+ <p>The atoms information page lists all atoms found in the
+ dump. The last created atom is listed first.
+
+ <p>Note that if the dump is from OTP R8B or earlier, the raw
+ dump lists the atoms in the opposite order and the Crashdump
+ Viewer reverses them. This means that there is no problem if the
+ dump is not truncated. However, if the dump is truncated, the
+ last atoms might not be shown at all!!
+
+ <center>
+ <a href=/crashdump_erts_doc/crash_dump.html#atoms>
+ More...</a>
+ </center>
+
+
+ <a NAME="distribution_info">
+ <h3>Distribution information</h3>
+
+ <p>The distribution information page shows all distribution
+ information found in the dump.
+
+ <p>If the page shows "Not alive", it means that the node was not
+ distributed.
+
+ <p>It the node was distributed, all connected nodes are
+ shown. Visible nodes are alive nodes with a living connection to
+ the originating node. Hidden nodes are the same as visible
+ nodes, except they are started with the "-hidden" flag. Not
+ connected nodes are nodes that are not connected to the
+ originating node anymore, but references (i.e. process or port
+ identitifiers) exist.
+
+ <p>'Links/Monitors' may contain information about links or
+ monitors between processes on the originating node and the
+ connected node.
+
+ <p>'Extra Info' may contain debug information (i.e. special
+ information written if the emulator is debug compiled) or error
+ information.
+
+ <center>
+ <a href=/crashdump_erts_doc/crash_dump.html#distribution_info>
+ More...</a>
+ </center>
+
+
+ <a NAME="loaded_modules">
+ <h3>Loaded modules</h3>
+
+ <p>The loaded modules information page shows all modules that
+ were loaded on the originating node, and the current size of the
+ code. If old code exsits, the old size is also shown.
+
+ <p>Detailed information about a specific module is shown when
+ the module name is clicked.
+
+ <center>
+ <a href=/crashdump_erts_doc/crash_dump.html#loaded_modules>
+ More...</a>
+ </center>
+
+
+ <a NAME="internal_tables">
+ <h3>Internal tables</h3>
+
+ <p>Internal tables are shown in two information pages: hash
+ tables and index tables.
+
+ <center>
+ <a href=/crashdump_erts_doc/crash_dump.html#internal_tables>
+ More...</a>
+ </center>
+
+
+ <a NAME="memory">
+ <h3>Memory</h3>
+
+ <p>Memory information is divided into three pages.
+
+ <p>The first page, <strong>Memory</strong>, shows information
+ similar to what you can obtain on a living node with
+ <code>c:memory()</code>. This will only be present in dumps from
+ OTP R9C and later.
+ <a href=/crashdump_erts_doc/crash_dump.html#memory>More...</a>
+
+ <p>The <strong>Allocated areas</strong> page shows information
+ similar to what you can obtain on a living node with
+ <code>erlang:system_info(allocated_areas)</code>.
+ <a href=/crashdump_erts_doc/crash_dump.html#allocated_areas>More...</a>
+
+ <p>The <strong>Allocator information</strong> page shows
+ information about allocators. The contents of the page will vary
+ with the version.
+ <a href=/crashdump_erts_doc/crash_dump.html#allocator>More...</a>
+
+ <center>
+
+ </center>
+
+
+ <h3>Documentation</h3>
+
+ <p>'Crashdump Viewer help' is this document.
+
+ <p>'How to interpret Erlang crashdumps' is a document from the
+ Erlang runtime system describing details in the raw
+ crashdumps. Here you will also find information about each
+ single field in the different information pages.
+
+</blockquote>
+<center>
+<hr>
+<font SIZE=-1>
+
+Copyright &copy; 1991-2003
+<a HREF="http://www.erlang.se">Ericsson Utvecklings AB</a><br>
+<!--#include virtual="/ssi/otp_footer.html"-->
+</font>
+</center>
+</body>
+</html> \ No newline at end of file