rgbenson / memprof Goto Github PK

memprof (c) Joe Damato  @joedamato   http://timetobleed.com

What is memprof?
================
Memprof is a memory profiler for Ruby that requires no patches to the Ruby VM.
It can help you find Ruby level memory leaks in your application.

How to use
==========

require 'memprof'
Memprof.start

# ruby code

Memprof.stats

# more ruby code

Memprof.stats
Memprof.stop


The above code will output 2 summaries, allowing you to compare which objects were
destroyed and which are still around.

Memprof.stats also takes an (optional) file name to write the output to a file.

Supported systems
=================
**This only works on unstripped binaries.**

Currently supporting:

  Linux (enable-shared AND disable-shared):
    x86_64 builds of Ruby Enterprise Edition 1.8.6/1.8.7
    x86_64 builds of MRI Ruby

  Snow Leopard (enable-shared AND disable-shared):
    x86_64 builds of Ruby Enterprise Edition 1.8.6/1.8.7
    x86_64 builds of MRI Ruby

Experimental (somewhat broken) support:

  Linux and OSX:
    i386/i686 support.

  Snow Leopard:
    OSX system Ruby, distributed with Snow Leopard.

Coming soon:

  Linux:
    Tracking object allocationns in C extensions.

  Official support for Ruby 1.9
  Official support for i386/i686

CREDITS
=======
Jake Douglas for the Mach O/snow leopard support.

Aman Gupta for various bug fixes and other cleanup.