Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Browse files

Add docs and gemspec

  • Loading branch information...
commit 9b9a8f700f3893273c13d97553243ca17769f1d2 1 parent 083f19a
@FooBarWidget authored
Showing with 79 additions and 0 deletions.
  1. +20 −0 LICENSE.txt
  2. +35 −0 README.markdown
  3. +24 −0 crash-watch.gemspec
View
20 LICENSE.txt
@@ -0,0 +1,20 @@
+Copyright (c) 2010 Phusion
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
View
35 README.markdown
@@ -0,0 +1,35 @@
+# Introduction
+
+* Do you have (server) processes that sometimes crash for mysterious reasons?
+* Can you not figure out why?
+* Do they not print any error messages to their log files upon crashing?
+
+`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.
+
+## Installation
+
+ gem install crash-watch
+
+You must also have GDB installed. Mac OS X already has it by default. If you're on Linux, try one of these:
+
+ apt-get install gdb
+ yum install gdb
+
+## Sample usage
+
+ $ crash-watch <PID>
+ Monitoring PID <PID>...
+ (...some time later, <PID> exits...)
+ Process exited.
+ Exit code = 0
+ Backtrace = [
+ Thread 1 (process 95205):
+ #0 0x00007fff87ea1db0 in _exit ()
+ No symbol table info available.
+ #1 0x000000010002a260 in ruby_stop ()
+ No symbol table info available.
+ #2 0x0000000100031a54 in ruby_run ()
+ No symbol table info available.
+ #3 0x00000001000009e4 in main ()
+ No symbol table info available.
+ ]
View
24 crash-watch.gemspec
@@ -0,0 +1,24 @@
+Gem::Specification.new do |s|
+ s.name = "crash-watch"
+ s.version = "1.0.0"
+ s.authors = ["Hongli Lai"]
+ s.date = "2010-04-16"
+ s.description = "Monitor processes and display useful information when they crash."
+ s.summary = "Monitor processes and display useful information when they crash"
+ s.email = "hongli@phusion.nl"
+ s.files = Dir[
+ "README.markdown",
+ "LICENSE.txt",
+ "crash-watch.gemspec",
+ "bin/**/*",
+ "lib/**/*",
+ "test/**/*"
+ ]
+ s.homepage = %q{http://money.rubyforge.org/}
+ s.rdoc_options = ["--charset=UTF-8"]
+ s.executables = ["crash-watch"]
+ s.require_paths = ["lib"]
+ s.add_development_dependency("ffi")
+ s.add_development_dependency("rspec")
+end
+

0 comments on commit 9b9a8f7

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