v8/tools/oom_dump
yangguo@chromium.org cb2f43cb14 Always include debugger support.
Motivation: we do not have test coverage for debuggersupport=off.

R=jkummerow@chromium.org

Review URL: https://codereview.chromium.org/256653004

git-svn-id: http://v8.googlecode.com/svn/branches/bleeding_edge@20969 ce2b1a6d-e550-0410-aec6-3dcde31c8c00
2014-04-25 11:00:37 +00:00
..
oom_dump.cc Always include debugger support. 2014-04-25 11:00:37 +00:00
README Update oom_dump README to indicate that people should build the correct V8 version. 2011-07-26 06:03:36 +00:00
SConstruct Initial implementation of oom_dump utility. 2010-08-16 12:36:02 +00:00

oom_dump extracts useful information from Google Chrome OOM minidumps.

To build one needs a google-breakpad checkout
(http://code.google.com/p/google-breakpad/).

First, one needs to build and install breakpad itself. For instructions
check google-breakpad, but currently it's as easy as:

  ./configure
  make
  sudo make install

(the catch: breakpad installs .so into /usr/local/lib, so you might
need some additional tweaking to make it discoverable, for example,
put a soft link into /usr/lib directory).

Next step is to build v8.  Note: you should build x64 version of v8,
if you're on 64-bit platform, otherwise you would get a link error when
building oom_dump.  Also, if you are testing against an older version of chrome
you should build the corresponding version of V8 to make sure that the type-id 
enum have the correct values.

The last step is to build oom_dump itself.  The following command should work:

  cd <v8 working copy>/tools/oom_dump
  scons BREAKPAD_DIR=<path to google-breakpad working copy>

(Additionally you can control v8 working copy dir, but the default should work.)

If everything goes fine, oom_dump <path to minidump> should print
some useful information about the OOM crash.

Note: currently only 32-bit Windows minidumps are supported.