Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse code

Add docs and gemspec

  • Loading branch information...
commit 9b9a8f700f3893273c13d97553243ca17769f1d2 1 parent 083f19a
Hongli Lai authored

Showing 3 changed files with 79 additions and 0 deletions. Show diff stats Hide diff stats

  1. +20 0 LICENSE.txt
  2. +35 0 README.markdown
  3. +24 0 crash-watch.gemspec
20 LICENSE.txt
... ... @@ -0,0 +1,20 @@
  1 +Copyright (c) 2010 Phusion
  2 +
  3 +Permission is hereby granted, free of charge, to any person obtaining
  4 +a copy of this software and associated documentation files (the
  5 +"Software"), to deal in the Software without restriction, including
  6 +without limitation the rights to use, copy, modify, merge, publish,
  7 +distribute, sublicense, and/or sell copies of the Software, and to
  8 +permit persons to whom the Software is furnished to do so, subject to
  9 +the following conditions:
  10 +
  11 +The above copyright notice and this permission notice shall be
  12 +included in all copies or substantial portions of the Software.
  13 +
  14 +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
  15 +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  16 +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
  17 +NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
  18 +LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
  19 +OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
  20 +WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
35 README.markdown
Source Rendered
... ... @@ -0,0 +1,35 @@
  1 +# Introduction
  2 +
  3 +* Do you have (server) processes that sometimes crash for mysterious reasons?
  4 +* Can you not figure out why?
  5 +* Do they not print any error messages to their log files upon crashing?
  6 +
  7 +`crash-watch` to the rescue! This little program will monitor a specified process and wait until it crashes. It will then print useful information such as its exit status, what signal caused it to abort, and its backtrace.
  8 +
  9 +## Installation
  10 +
  11 + gem install crash-watch
  12 +
  13 +You must also have GDB installed. Mac OS X already has it by default. If you're on Linux, try one of these:
  14 +
  15 + apt-get install gdb
  16 + yum install gdb
  17 +
  18 +## Sample usage
  19 +
  20 + $ crash-watch <PID>
  21 + Monitoring PID <PID>...
  22 + (...some time later, <PID> exits...)
  23 + Process exited.
  24 + Exit code = 0
  25 + Backtrace = [
  26 + Thread 1 (process 95205):
  27 + #0 0x00007fff87ea1db0 in _exit ()
  28 + No symbol table info available.
  29 + #1 0x000000010002a260 in ruby_stop ()
  30 + No symbol table info available.
  31 + #2 0x0000000100031a54 in ruby_run ()
  32 + No symbol table info available.
  33 + #3 0x00000001000009e4 in main ()
  34 + No symbol table info available.
  35 + ]
24 crash-watch.gemspec
... ... @@ -0,0 +1,24 @@
  1 +Gem::Specification.new do |s|
  2 + s.name = "crash-watch"
  3 + s.version = "1.0.0"
  4 + s.authors = ["Hongli Lai"]
  5 + s.date = "2010-04-16"
  6 + s.description = "Monitor processes and display useful information when they crash."
  7 + s.summary = "Monitor processes and display useful information when they crash"
  8 + s.email = "hongli@phusion.nl"
  9 + s.files = Dir[
  10 + "README.markdown",
  11 + "LICENSE.txt",
  12 + "crash-watch.gemspec",
  13 + "bin/**/*",
  14 + "lib/**/*",
  15 + "test/**/*"
  16 + ]
  17 + s.homepage = %q{http://money.rubyforge.org/}
  18 + s.rdoc_options = ["--charset=UTF-8"]
  19 + s.executables = ["crash-watch"]
  20 + s.require_paths = ["lib"]
  21 + s.add_development_dependency("ffi")
  22 + s.add_development_dependency("rspec")
  23 +end
  24 +

0 comments on commit 9b9a8f7

Please sign in to comment.
Something went wrong with that request. Please try again.