summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
author <shinichiro.hamaji@gmail.com>2008-10-30 10:33:45 +0000
committer <shinichiro.hamaji@gmail.com>2008-10-30 10:33:45 +0000
commit91d9fd88149bba962b8bc37a3d421d91720497a4 (patch)
treece562b89dbbcf84ea853c6b58b99379c7ea4093e /doc
parentb8dbc14c517b684c96c7265c55df70b7128da5ec (diff)
downloadglog-91d9fd88149bba962b8bc37a3d421d91720497a4.tar.gz
glog-91d9fd88149bba962b8bc37a3d421d91720497a4.tar.bz2
glog-91d9fd88149bba962b8bc37a3d421d91720497a4.zip
Add InstallFailureSignalHandler(). The function installs a signal handler that
will dump useful information when the program crashes on certain signals such as SIGSEGV. Also, changed the version of autoconf (2.59 => 2.61). git-svn-id: https://google-glog.googlecode.com/svn/trunk@11 eb4d4688-79bd-11dd-afb4-1d65580434c0
Diffstat (limited to 'doc')
-rw-r--r--doc/glog.html28
1 files changed, 28 insertions, 0 deletions
diff --git a/doc/glog.html b/doc/glog.html
index 8d36abc..c9816e0 100644
--- a/doc/glog.html
+++ b/doc/glog.html
@@ -392,6 +392,34 @@ opposed to a severity level.
"Present occurence is " &lt;&lt; COUNTER;
</pre>
+<h2> <A name="signal">Failure Signal Handler</A> </h2>
+
+<p>
+The library provides a convenient signal handler that will dump useful
+information when the program crashes on certain signals such as SIGSEGV.
+The signal handler can be installed by
+google::InstallFailureSignalHandler(). The following is an example of output
+from the signal handler.
+
+<pre>
+*** Aborted at 1225095260 (unix time) try "date -d @1225095260" if you are using GNU date ***
+*** SIGSEGV (@0x0) received by PID 17711 (TID 0x7f893090a6f0) from PID 0; stack trace: ***
+PC: @ 0x412eb1 TestWaitingLogSink::send()
+ @ 0x7f892fb417d0 (unknown)
+ @ 0x412eb1 TestWaitingLogSink::send()
+ @ 0x7f89304f7f06 google::LogMessage::SendToLog()
+ @ 0x7f89304f35af google::LogMessage::Flush()
+ @ 0x7f89304f3739 google::LogMessage::~LogMessage()
+ @ 0x408cf4 TestLogSinkWaitTillSent()
+ @ 0x4115de main
+ @ 0x7f892f7ef1c4 (unknown)
+ @ 0x4046f9 (unknown)
+</pre>
+
+<p>
+By default, the signal handler writes the failure dump to the standard
+error. You can customize the destination by InstallFailureWriter().
+
<h2> <A name="misc">Miscellaneous Notes</A> </h2>
<h3><A NAME=message>Performance of Messages</A></h3>