~ubuntu-branches/ubuntu/trusty/erlang/trusty

« back to all changes in this revision

Viewing changes to lib/observer/doc/src/crashdump_ug.xml

  • Committer: Bazaar Package Importer
  • Author(s): Clint Byrum
  • Date: 2011-05-05 15:48:43 UTC
  • mfrom: (3.5.13 sid)
  • Revision ID: james.westby@ubuntu.com-20110505154843-0om6ekzg6m7ugj27
Tags: 1:14.b.2-dfsg-3ubuntu1
* Merge from debian unstable.  Remaining changes:
  - Drop libwxgtk2.8-dev build dependency. Wx isn't in main, and not
    supposed to.
  - Drop erlang-wx binary.
  - Drop erlang-wx dependency from -megaco, -common-test, and -reltool, they
    do not really need wx. Also drop it from -debugger; the GUI needs wx,
    but it apparently has CLI bits as well, and is also needed by -megaco,
    so let's keep the package for now.
  - debian/patches/series: Do what I meant, and enable build-options.patch
    instead.
* Additional changes:
  - Drop erlang-wx from -et
* Dropped Changes:
  - patches/pcre-crash.patch: CVE-2008-2371: outer level option with
    alternatives caused crash. (Applied Upstream)
  - fix for ssl certificate verification in newSSL: 
    ssl_cacertfile_fix.patch (Applied Upstream)
  - debian/patches/series: Enable native.patch again, to get stripped beam
    files and reduce the package size again. (build-options is what
    actually accomplished this)
  - Remove build-options.patch on advice from upstream and because it caused
    odd build failures.

Show diffs side-by-side

added added

removed removed

Lines of Context:
4
4
<chapter>
5
5
  <header>
6
6
    <copyright>
7
 
      <year>2003</year><year>2009</year>
 
7
      <year>2003</year><year>2011</year>
8
8
      <holder>Ericsson AB. All Rights Reserved.</holder>
9
9
    </copyright>
10
10
    <legalnotice>
38
38
 
39
39
  <section>
40
40
    <title>Getting Started</title>
41
 
    <p>From an erlang node, start Crashdump Viewer by calling
42
 
      <c>crashdump_viewer:start()</c>. This will automatically start
43
 
      WebTool and display the web address where WebTool can be
44
 
      found. See the documentation for the WebTool application for
45
 
      further information about how to use WebTool.
46
 
      </p>
 
41
 
 
42
    <p>The easiest way to start Crashdump Viewer is to use the
 
43
    provided shell script named <c>cdv</c> with the full path to the
 
44
    erlang crashdump as an argument. The script can be found in the
 
45
    priv directory of the <c>observer</c> application. This starts
 
46
    WebTool, Crashdump Viewer and a web browser, and loads the given
 
47
    file. The browser should then display a page named General
 
48
    Information which shows a short summary of the information in
 
49
    the crashdump.</p>
 
50
 
 
51
    <p>The default browser is Internet Explorer on Windows or else
 
52
    Firefox. To use another browser, give the browser's start command
 
53
    as the second argument to <c>cdv</c>. If the given browser name is
 
54
    not known to Crashdump Viewer, the browser argument is executed as
 
55
    a command with the start URL as the only argument.</p>
 
56
 
 
57
    <p>Under Windows the batch file <c>cdv.bat</c> can be used.</p>
 
58
 
 
59
    <p>It is also possible to start the Crashdump Viewer from within
 
60
    an erlang node by calling <seealso
 
61
    marker="crashdump_viewer#start/0">crashdump_viewer:start/0</seealso>. This
 
62
    will automatically start WebTool and display the web address where
 
63
    WebTool can be found. See the documentation for the WebTool
 
64
    application for further information about how to use WebTool.</p>
 
65
 
47
66
    <p>Point your web browser to the address displayed, and you should
48
67
      now see the start page of WebTool. At the top of the page, you
49
68
      will see a link to "CrashDumpViewer". Click this link to get to
52
71
      connection to the internet, or you must set no proxy for
53
72
      localhost.)
54
73
      </p>
55
 
    <p>You can also start WebTool, Crashdump Viewer and a browser in
56
 
      one go by running the <c>start_webtool</c> script found in the
57
 
      <c>priv</c> directory of the WebTool application, e.g.
58
 
            <br></br>
59
 
<c>>start_webtool crashdump_viewer</c></p>
60
74
    <p>From the start page of Crashdump Viewer, push the "Load
61
75
      Crashdump" button to load a crashdump into the tool. Then enter
62
 
      the filename of the crashdump in the entry field and push the "Ok"
63
 
      button.
 
76
      the filename of the crashdump in the entry field and push the
 
77
      "Ok" button. This will bring you to the General Information
 
78
      page, i.e. the same page as the <c>cdv</c> script will open in
 
79
      the browser.
64
80
      </p>
65
81
    <p>Crashdumps generated by OTP R9C and later are loaded directly
66
82
      into the Crashdump Viewer, while dumps from earlier releases first