← Back to branch summary

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

« back to all changes in this revision

Viewing changes to system/doc/system_principles/error_logging.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:
system/doc/system_principles/error_logging.xml
 
1
<?xml version="1.0" encoding="latin1" ?>
 
2
<!DOCTYPE chapter SYSTEM "chapter.dtd">
 
3
 
 
4
<chapter>
 
5
  <header>
 
6
    <copyright>
 
7
      <year>2003</year><year>2009</year>
 
8
      <holder>Ericsson AB. All Rights Reserved.</holder>
 
9
    </copyright>
 
10
    <legalnotice>
 
11
      The contents of this file are subject to the Erlang Public License,
 
12
      Version 1.1, (the "License"); you may not use this file except in
 
13
      compliance with the License. You should have received a copy of the
 
14
      Erlang Public License along with this software. If not, it can be
 
15
      retrieved online at http://www.erlang.org/.
 
16
    
 
17
      Software distributed under the License is distributed on an "AS IS"
 
18
      basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See
 
19
      the License for the specific language governing rights and limitations
 
20
      under the License.
 
21
    
 
22
    </legalnotice>
 
23
 
 
24
    <title>Error Logging</title>
 
25
    <prepared></prepared>
 
26
    <docno></docno>
 
27
    <date></date>
 
28
    <rev></rev>
 
29
    <file>error_logging.xml</file>
 
30
  </header>
 
31
 
 
32
  <section>
 
33
    <title>Error Information From the Runtime System</title>
 
34
    <p>Error information from the runtime system, that is, information
 
35
      about a process terminating due to an uncaught error exception,
 
36
      is by default written to terminal (tty):</p>
 
37
    <code type="none"><![CDATA[
 
38
=ERROR REPORT==== 9-Dec-2003::13:25:02 ===
 
39
Error in process <0.27.0> with exit value: {{badmatch,[1,2,3]},[{m,f,1},{shell,eval_loop,2}]}]]></code>
 
40
    <p>The error information is handled by the <em>error logger</em>, a
 
41
      system process registered as <c>error_logger</c>. This process
 
42
      receives all error messages from the Erlang runtime system and
 
43
      also from the standard behaviours and different Erlang/OTP
 
44
      applications.</p>
 
45
    <p>The exit reasons (such as <c>badarg</c> above) used by
 
46
      the runtime system are described in
 
47
      <seealso marker="doc/reference_manual:errors#exit_reasons">Errors and Error Handling</seealso>
 
48
      in the Erlang Reference Manual.</p>
 
49
    <p>The process <c>error_logger</c> and its user interface (with
 
50
      the same name) are described in
 
51
      <seealso marker="kernel:error_logger">error_logger(3)</seealso>.
 
52
      It is possible to configure the system so that error information
 
53
      is written to file instead/as well as tty. Also, it is possible
 
54
      for user defined applications to send and format error
 
55
      information using <c>error_logger</c>.</p>
 
56
  </section>
 
57
 
 
58
  <section>
 
59
    <title>SASL Error Logging</title>
 
60
    <p>The standard behaviors (<c>supervisor</c>, <c>gen_server</c>,
 
61
      etc.) sends progress and error information to <c>error_logger</c>.
 
62
      If the SASL application is started, this information is written
 
63
      to tty as well. See
 
64
      <seealso marker="sasl:error_logging">SASL Error Logging</seealso>
 
65
      in the SASL User's Guide for further information.</p>
 
66
    <pre>
 
67
% <input>erl -boot start_sasl</input>
 
68
Erlang (BEAM) emulator version 5.4.13 [hipe] [threads:0] [kernel-poll]
 
69
 
 
70
 
 
71
=PROGRESS REPORT==== 31-Mar-2006::12:45:58 ===
 
72
          supervisor: {local,sasl_safe_sup}
 
73
             started: [{pid,&lt;0.33.0>},
 
74
                       {name,alarm_handler},
 
75
                       {mfa,{alarm_handler,start_link,[]}},
 
76
                       {restart_type,permanent},
 
77
                       {shutdown,2000},
 
78
                       {child_type,worker}]
 
79
 
 
80
=PROGRESS REPORT==== 31-Mar-2006::12:45:58 ===
 
81
          supervisor: {local,sasl_safe_sup}
 
82
             started: [{pid,&lt;0.34.0>},
 
83
                       {name,overload},
 
84
                       {mfa,{overload,start_link,[]}},
 
85
                       {restart_type,permanent},
 
86
                       {shutdown,2000},
 
87
                       {child_type,worker}]
 
88
 
 
89
=PROGRESS REPORT==== 31-Mar-2006::12:45:58 ===
 
90
          supervisor: {local,sasl_sup}
 
91
             started: [{pid,&lt;0.32.0>},
 
92
                       {name,sasl_safe_sup},
 
93
                       {mfa,{supervisor,
 
94
                                start_link,
 
95
                                [{local,sasl_safe_sup},sasl,safe]}},
 
96
                       {restart_type,permanent},
 
97
                       {shutdown,infinity},
 
98
                       {child_type,supervisor}]
 
99
 
 
100
=PROGRESS REPORT==== 31-Mar-2006::12:45:58 ===
 
101
          supervisor: {local,sasl_sup}
 
102
             started: [{pid,&lt;0.35.0>},
 
103
                       {name,release_handler},
 
104
                       {mfa,{release_handler,start_link,[]}},
 
105
                       {restart_type,permanent},
 
106
                       {shutdown,2000},
 
107
                       {child_type,worker}]
 
108
 
 
109
=PROGRESS REPORT==== 31-Mar-2006::12:45:58 ===
 
110
         application: sasl
 
111
          started_at: nonode@nohost
 
112
Eshell V5.4.13  (abort with ^G)
 
113
1> </pre>
 
114
  </section>
 
115
</chapter>
 
116