tunemygc 1.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 4401c1469c2636840a42026092dcd8d682d8825f
+  data.tar.gz: 5e44ddbc6336a4683b155393087bc8d39bc95cba
+SHA512:
+  metadata.gz: 294670fabab8fa5203a580b6a4182ebb888d83d52710dfe8f82fb5545b6daefdeb3dad21d72c16b7bc2c6f0f0b3cc5ccd73d65bac3512468dd1c383f21a58568
+  data.tar.gz: 6bac1f88cad71533a4731332526dabc49e3b60b2d77c68a133dc7b6dea55ade00b8522cf372b2884777f572744028e70f59435303e27ac1ebfb1c3c8ad88f760

data/.gitignore

@@ -0,0 +1,4 @@
+.DS_Store
+.ruby-version
+tmp/*
+lib/tunemygc/tunemygc_ext.*

data/.travis.yml

@@ -0,0 +1,19 @@
+language: ruby
+bundler_args: --quiet
+rvm:
+  - 2.1.0
+  - 2.1.1
+  - 2.1.2
+  - 2.1.5
+  - 2.2.0
+  - ruby-head
+script: "bundle exec rake"
+env: RUBY_GC_TUNE=1 RUBY_GC_TUNE_DEBUG=1
+gemfile:
+  - Gemfile
+notifications:
+  recipients:
+    - lourens@methodmissing.com
+branches:
+  only:
+    - master

data/Gemfile

@@ -0,0 +1,5 @@
+source 'https://rubygems.org'
+
+gemspec
+
+gem 'rails'

data/Gemfile.lock

@@ -0,0 +1,125 @@
+PATH
+  remote: .
+  specs:
+    tunemygc (1.0)
+      activesupport
+      certified
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    actionmailer (4.2.0)
+      actionpack (= 4.2.0)
+      actionview (= 4.2.0)
+      activejob (= 4.2.0)
+      mail (~> 2.5, >= 2.5.4)
+      rails-dom-testing (~> 1.0, >= 1.0.5)
+    actionpack (4.2.0)
+      actionview (= 4.2.0)
+      activesupport (= 4.2.0)
+      rack (~> 1.6.0)
+      rack-test (~> 0.6.2)
+      rails-dom-testing (~> 1.0, >= 1.0.5)
+      rails-html-sanitizer (~> 1.0, >= 1.0.1)
+    actionview (4.2.0)
+      activesupport (= 4.2.0)
+      builder (~> 3.1)
+      erubis (~> 2.7.0)
+      rails-dom-testing (~> 1.0, >= 1.0.5)
+      rails-html-sanitizer (~> 1.0, >= 1.0.1)
+    activejob (4.2.0)
+      activesupport (= 4.2.0)
+      globalid (>= 0.3.0)
+    activemodel (4.2.0)
+      activesupport (= 4.2.0)
+      builder (~> 3.1)
+    activerecord (4.2.0)
+      activemodel (= 4.2.0)
+      activesupport (= 4.2.0)
+      arel (~> 6.0)
+    activesupport (4.2.0)
+      i18n (~> 0.7)
+      json (~> 1.7, >= 1.7.7)
+      minitest (~> 5.1)
+      thread_safe (~> 0.3, >= 0.3.4)
+      tzinfo (~> 1.1)
+    addressable (2.3.6)
+    arel (6.0.0)
+    builder (3.2.2)
+    certified (1.0.0)
+    crack (0.4.2)
+      safe_yaml (~> 1.0.0)
+    erubis (2.7.0)
+    globalid (0.3.0)
+      activesupport (>= 4.1.0)
+    hike (1.2.3)
+    i18n (0.7.0)
+    json (1.8.2)
+    loofah (2.0.1)
+      nokogiri (>= 1.5.9)
+    mail (2.6.3)
+      mime-types (>= 1.16, < 3)
+    mime-types (2.4.3)
+    mini_portile (0.6.2)
+    minitest (5.5.0)
+    multi_json (1.10.1)
+    nokogiri (1.6.5)
+      mini_portile (~> 0.6.0)
+    rack (1.6.0)
+    rack-test (0.6.2)
+      rack (>= 1.0)
+    rails (4.2.0)
+      actionmailer (= 4.2.0)
+      actionpack (= 4.2.0)
+      actionview (= 4.2.0)
+      activejob (= 4.2.0)
+      activemodel (= 4.2.0)
+      activerecord (= 4.2.0)
+      activesupport (= 4.2.0)
+      bundler (>= 1.3.0, < 2.0)
+      railties (= 4.2.0)
+      sprockets-rails
+    rails-deprecated_sanitizer (1.0.3)
+      activesupport (>= 4.2.0.alpha)
+    rails-dom-testing (1.0.5)
+      activesupport (>= 4.2.0.beta, < 5.0)
+      nokogiri (~> 1.6.0)
+      rails-deprecated_sanitizer (>= 1.0.1)
+    rails-html-sanitizer (1.0.1)
+      loofah (~> 2.0)
+    railties (4.2.0)
+      actionpack (= 4.2.0)
+      activesupport (= 4.2.0)
+      rake (>= 0.8.7)
+      thor (>= 0.18.1, < 2.0)
+    rake (10.4.2)
+    rake-compiler (0.9.5)
+      rake
+    safe_yaml (1.0.4)
+    sprockets (2.12.3)
+      hike (~> 1.2)
+      multi_json (~> 1.0)
+      rack (~> 1.0)
+      tilt (~> 1.1, != 1.3.0)
+    sprockets-rails (2.2.2)
+      actionpack (>= 3.0)
+      activesupport (>= 3.0)
+      sprockets (>= 2.8, < 4.0)
+    thor (0.19.1)
+    thread_safe (0.3.4)
+    tilt (1.4.1)
+    tzinfo (1.2.2)
+      thread_safe (~> 0.1)
+    webmock (1.20.4)
+      addressable (>= 2.3.6)
+      crack (>= 0.3.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  rails
+  rake
+  rake-compiler (~> 0.9.3)
+  tunemygc!
+  webmock

data/README.md

@@ -0,0 +1,193 @@
+## [TuneMyGC](https://www.tunemygc.com) - optimal MRI Ruby 2.1+ Garbage Collection
+
+[![Build Status](https://travis-ci.org/bear-metal/tunemygc.svg)](https://travis-ci.org/bear-metal/tunemygc)
+
+The Ruby garbage collector has been flagged as the crux of Ruby performance and memory use for a long time. It has improved a lot over the last years, but there's still a lot to tune and control. *The default configuration is not suitable and optimal for Rails applications, and neither is there a one-size-fits-all set of tuned parameters that would suit every app.* However, hand-tuning the GC parameters is a slippery slope to navigate for most developers.
+
+## We're fixing this
+
+![tunemygc workflow diagram](https://raw.githubusercontent.com/bear-metal/tunemygc/master/assets/tunemygc-graphic2x-80dac1571cacc70d9b272bb62ae9f6df.png?token=AAABe8sM_ofiQkrCpNw7OYRbtHMLO9l5ks5UuQlYwA%3D%3D)
+
+## Benefits
+
+* Faster boot times
+* Less major GC cycles during requests
+* Less worst case memory usage - it's bound by sensible upper limits and growth factors
+* No need to keep up to date with the C Ruby GC as an evolving moving target
+* [in progress] A repeatable process to infer an optimal GC config for that app's current state within the context of a longer development cycle.
+
+## Benchmarks
+
+We used [Discourse](http://www.discourse.org) as our primary test harness as it's representative of most Rails applications and has been instrumental in asserting RGenC developments on Rails as well.
+
+![tunemygc workflow diagram](https://raw.githubusercontent.com/bear-metal/tunemygc/master/assets/discourse_bench.png?token=AAABe8sM_ofiQkrCpNw7OYRbtHMLO9l5ks5UuQlYwA%3D%3D)
+
+## Installing
+
+#### OS X / Linux
+
+Add to your Gemfile and run `bundle install`
+
+``` sh
+gem 'tunemygc', :require => 'tunemygc'
+```
+This gem linterposes itself into the Rails request/response lifecycles and piggy backs off the new GC events in Ruby 2.x for introspection. Tuning recommendations are handled through a web service at `https://tunemygc.com`. You will need a `rails > 4.1`, installation and MRI Ruby `2.1`, or later.
+
+#### Windows
+
+Has not been tested at all.
+
+## Getting started
+
+There isn't much setup other than adding the gem to your Gemfile and running a single command from your application root to register your application with the `https://tunemygc.com` service:
+
+``` sh
+Lourenss-MacBook-Air-2:discourse lourens$ bundle exec tunemygc -r lourens@bearmetal.eu
+Application registered. Use RUBY_GC_TOKEN=08de9e8822c847244b31290cedfc1d51 in your environment.
+```
+
+We require a valid email address as a canonical reference for tuner tokens for your applications.
+
+For the above command sequences, to sample your Rails app for tuning, run:
+
+``` sh
+RUBY_GC_TOKEN=08de9e8822c847244b31290cedfc1d51 RUBY_GC_TUNE=1 bundle exec rails s
+```
+
+The CLI interface supports retrieving configuration options for your application as well.
+
+``` sh
+Lourenss-MacBook-Air-2:discourse lourens$ bundle exec tunemygc
+Usage: tunemygc [options]
+    -r, --register EMAIL             Register this Rails app with the https://tunemygc.com service
+    -c, --config TOKEN               Fetch the last known config for a given Rails app
+    -h, --help                       How to use the TuneMyGC agent CLI
+```
+
+## Configuration options
+
+We fully embrace and encourage [12 factor](http://12factor.net) conventions and as such configuration is limited to a few environment variables. No config files and YAML or initializer cruft.
+
+#### Basic
+
+* `RUBY_GC_TOKEN=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`
+
+This application specific token is required for GC instrumentation. You can generate one from the CLI interface by registering for the service with a valid email address:
+
+``` sh
+Lourenss-MacBook-Air-2:discourse lourens$ bundle exec tunemygc -r lourens@bearmetal.eu
+Application registered. Use RUBY_GC_TOKEN=08de9e8822c847244b31290cedfc1d51 in your environment.
+```
+
+* `RUBY_GC_TUNE=1`
+
+Enables the interposer for taking a few lightweight snapshots and submitting them to `tunemygc.com`. Without this environment variable set, it won't interpose itself.
+
+For the above command sequences, to sample my Rails app for tuning, I'd run:
+
+``` sh
+RUBY_GC_TOKEN=08de9e8822c847244b31290cedfc1d51 RUBY_GC_TUNE=1 bundle exec rails s
+```
+
+#### Advanced
+
+* `RUBY_GC_TUNE_REQUESTS=x`
+
+Controls the interposer lifetime for sampling requests. It will enable itself, then remove request instrumentation after `x` requests. A good minimum ballpark sample set would be 200
+
+* `RUBY_GC_TUNE_DEBUG=1`
+
+As above, but dumps snapshots to Rails logger or STDOUT prior to submission. Mostly for developer use/support.
+
+## How do I use this?
+
+This gem is only a lightweight agent and designed to not get in your way. There's not much workflow at the moment other than applying the suggested GC configuration to your application's environment.
+
+#### Interpreting configurations
+
+An instrumented process dumps a reccommended config to the Rails logger.
+
+``` sh
+[TuneMyGC] Syncing 688 snapshots
+[TuneMyGC] ==== Recommended GC configs from https://tunemygc.com/configs/d739119e4abc38d42e183d1361991818.json
+[TuneMyGC] export RUBY_GC_HEAP_INIT_SLOTS=382429
+[TuneMyGC] export RUBY_GC_HEAP_FREE_SLOTS=603850
+[TuneMyGC] export RUBY_GC_HEAP_GROWTH_FACTOR=1.2
+[TuneMyGC] export RUBY_GC_HEAP_GROWTH_MAX_SLOTS=301925
+[TuneMyGC] export RUBY_GC_HEAP_OLDOBJECT_LIMIT_FACTOR=2.0
+[TuneMyGC] export RUBY_GC_MALLOC_LIMIT=35818030
+[TuneMyGC] export RUBY_GC_MALLOC_LIMIT_MAX=42981636
+[TuneMyGC] export RUBY_GC_MALLOC_LIMIT_GROWTH_FACTOR=1.32
+[TuneMyGC] export RUBY_GC_OLDMALLOC_LIMIT=32782669
+[TuneMyGC] export RUBY_GC_OLDMALLOC_LIMIT_MAX=49174003.5
+[TuneMyGC] export RUBY_GC_OLDMALLOC_LIMIT_GROWTH_FACTOR=1.2
+```
+
+We're still in the process of building tools and a launcher shim around this. You can also retrieve the last known configuration for you app via the CLI interface:
+
+``` sh
+Lourenss-MacBook-Air-2:discourse lourens$ bundle exec tunemygc -c 3b8796e5627f97ec760f000d55d9b3f5
+=== Suggested GC configuration:
+
+export RUBY_GC_HEAP_INIT_SLOTS=382429
+export RUBY_GC_HEAP_FREE_SLOTS=603850
+export RUBY_GC_HEAP_GROWTH_FACTOR=1.2
+export RUBY_GC_HEAP_GROWTH_MAX_SLOTS=301925
+export RUBY_GC_HEAP_OLDOBJECT_LIMIT_FACTOR=2.0
+export RUBY_GC_MALLOC_LIMIT=35818030
+export RUBY_GC_MALLOC_LIMIT_MAX=42981636
+export RUBY_GC_MALLOC_LIMIT_GROWTH_FACTOR=1.32
+export RUBY_GC_OLDMALLOC_LIMIT=32782669
+export RUBY_GC_OLDMALLOC_LIMIT_MAX=49174003.5
+export RUBY_GC_OLDMALLOC_LIMIT_GROWTH_FACTOR=1.2
+```
+
+#### Heroku and 12 factor
+
+We have a [Heroku](http://www.heroku.com) addon in Alpha testing and the Ruby GC lends itself well to tuning through 12 factor principles as it's designed around environment variables.
+
+## Security and privacy concerns
+
+We don't track any data specific to your application other than a simple environment header which allows us to pick the best tuner for your setup:
+
+* Ruby version eg. "2.2.0"
+* Rails version eg. "4.1.8"
+* Compile time GC options eg. "["USE_RGENGC", "RGENGC_ESTIMATE_OLDMALLOC", "GC_ENABLE_LAZY_SWEEP"]"
+* Compile time GC constants eg. "{"RVALUE_SIZE"=>40, "HEAP_OBJ_LIMIT"=>408, "HEAP_BITMAP_SIZE"=>56, "HEAP_BITMAP_PLANES"=>3}"
+
+Samples hitting our tuner endpoint doesn't include any proprietary details from your application either - just data points about GC activity.
+
+We do however ask for a valid email address as a canonical reference for tuner tokens for your applications.
+
+## Feedback and issues
+
+When trouble strikes, please file an [issue](https://www.github.com/bear-metal/tunemygc/issues) or email Lourens directly <lourens@bearmetal.eu>
+
+[Bear Metal OÜ](http://www.bearmetal.eu) is also available for consulting around general Rails performance, heap dump analysis (more tools coming soon) and custom Ruby extension development.
+
+## License
+
+(The MIT License)
+
+Copyright (c) 2015:
+
+* [Bear Metal OÜ](http://bearmetal.eu)
+
+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.

data/Rakefile

@@ -0,0 +1,32 @@
+# encoding: utf-8
+
+require 'rubygems' unless defined?(Gem)
+require 'rake' unless defined?(Rake)
+
+require 'rake/extensiontask'
+require 'rake/testtask'
+
+Rake::ExtensionTask.new('tunemygc') do |ext|
+  ext.name = 'tunemygc_ext'
+  ext.ext_dir = 'ext/tunemygc'
+  ext.lib_dir = "lib/tunemygc"
+  CLEAN.include 'lib/**/tunemygc_ext.*'
+end
+
+desc 'Run tunemygc tests'
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'test'
+  t.pattern = "test/**/test_*.rb"
+  t.verbose = true
+  t.warning = true
+end
+
+namespace :debug do
+  desc "Run the test suite under gdb"
+  task :gdb do
+    system "gdb --args ruby rake"
+  end
+end
+
+task :test => :compile
+task :default => :test

data/bin/tunemygc

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+
+require 'tunemygc'
+require 'tunemygc/cli'
+
+TuneMyGc::CLI.start(ARGV)

data/ext/tunemygc/extconf.rb

@@ -0,0 +1,92 @@
+# encoding: utf-8
+
+require 'mkmf'
+
+dir_config('tunemygc')
+
+# Only defined for Ruby 2.1.x and 2.2.x
+gc_events = have_const('RUBY_INTERNAL_EVENT_GC_END_SWEEP')
+
+if gc_events
+  # From ko1/gc_tracer
+  # Piggy backs off the new methods to retrieve GC stats and latest cycle info without doing
+  # allocations - thus safe to call within a GC cycle and properly snapshot what we need without
+  # the results being skewed by postponed jobs, which isn't deterministic.
+  open("tunemygc_env.h", 'w'){|f|
+    gc_stat = GC.stat
+    gc_latest_info = GC.latest_gc_info
+    f.puts '#include "ruby/ruby.h"'
+    f.puts "static VALUE sym_gc_stat[#{gc_stat.keys.size}];"
+    f.puts "static VALUE sym_latest_gc_info[#{gc_latest_info.keys.size}];"
+
+    f.puts 'typedef struct {'
+    f.puts '    double ts;'
+    f.puts '    size_t peak_rss;'
+    f.puts '    size_t current_rss;'
+    f.puts '    VALUE stage;'
+    gc_stat.keys.each do |key|
+      f.puts "    size_t #{key};"
+    end
+    gc_latest_info.each do |key, val|
+      f.puts "    VALUE #{key};"
+    end
+    f.puts '} tunemygc_stat_record;'
+
+    f.puts "static void"
+    f.puts "tunemygc_set_stat_record(tunemygc_stat_record *record)"
+    f.puts "{"
+      #
+      gc_stat.keys.each.with_index{|k, i|
+        f.puts "    record->#{k} = rb_gc_stat(sym_gc_stat[#{i}]);"
+      }
+      gc_latest_info.keys.each.with_index{|k, i|
+        f.puts "    record->#{k} = rb_gc_latest_gc_info(sym_latest_gc_info[#{i}]);"
+      }
+      #
+    f.puts "}"
+
+    f.puts "static VALUE"
+    f.puts "tunemygc_get_stat_record(tunemygc_stat_record *record)"
+    f.puts "{"
+      #
+      f.puts  "    VALUE stat = rb_hash_new();"
+      f.puts  "    VALUE latest_info = rb_hash_new();"
+      f.puts  "    VALUE snapshot = rb_ary_new2(7);"
+      gc_stat.keys.each.with_index{|k, i|
+        f.puts "    rb_hash_aset(stat, sym_gc_stat[#{i}], SIZET2NUM(record->#{k}));"
+      }
+      gc_latest_info.keys.each.with_index{|k, i|
+        f.puts "    rb_hash_aset(latest_info, sym_latest_gc_info[#{i}], record->#{k});"
+      }
+      f.puts "    rb_ary_store(snapshot, 0, DBL2NUM(record->ts));"
+      f.puts "    rb_ary_store(snapshot, 1, SIZET2NUM(record->peak_rss));"
+      f.puts "    rb_ary_store(snapshot, 2, SIZET2NUM(record->current_rss));"
+      f.puts "    rb_ary_store(snapshot, 3, record->stage);"
+      f.puts "    rb_ary_store(snapshot, 4, stat);"
+      f.puts "    rb_ary_store(snapshot, 5, latest_info);"
+      f.puts "    rb_ary_store(snapshot, 6, Qnil);"
+      f.puts "    return snapshot;"
+      #
+    f.puts "}"
+
+    f.puts "static void"
+    f.puts "tunemygc_setup_trace_symbols(void)"
+    f.puts "{"
+      #
+      gc_stat.keys.each.with_index{|k, i|
+        f.puts "    sym_gc_stat[#{i}] = ID2SYM(rb_intern(\"#{k}\"));"
+      }
+      gc_latest_info.keys.each.with_index{|k, i|
+        f.puts "    sym_latest_gc_info[#{i}] = ID2SYM(rb_intern(\"#{k}\"));"
+      }
+      #
+    f.puts "}"
+  }
+
+  create_makefile('tunemygc/tunemygc_ext')
+else
+  # do nothing if we're not running within Ruby 2.1.x or 2.2.x
+  File.open('Makefile', 'w') do |f|
+    f.puts "install:\n\t\n"
+  end
+end

data/ext/tunemygc/getRSS.c

@@ -0,0 +1,122 @@
+/*
+ * Author:  David Robert Nadeau
+ * Site:    http://NadeauSoftware.com/
+ * License: Creative Commons Attribution 3.0 Unported License
+ *          http://creativecommons.org/licenses/by/3.0/deed.en_US
+ */
+
+#if defined(_WIN32)
+#include <windows.h>
+#include <psapi.h>
+
+#elif defined(__unix__) || defined(__unix) || defined(unix) || (defined(__APPLE__) && defined(__MACH__))
+#include <unistd.h>
+#include <sys/resource.h>
+
+#if defined(__APPLE__) && defined(__MACH__)
+#include <mach/mach.h>
+
+#elif (defined(_AIX) || defined(__TOS__AIX__)) || (defined(__sun__) || defined(__sun) || defined(sun) && (defined(__SVR4) || defined(__svr4__)))
+#include <fcntl.h>
+#include <procfs.h>
+
+#elif defined(__linux__) || defined(__linux) || defined(linux) || defined(__gnu_linux__)
+#include <stdio.h>
+
+#endif
+
+#else
+#error "Cannot define getPeakRSS( ) or getCurrentRSS( ) for an unknown OS."
+#endif
+
+
+
+
+
+/**
+ * Returns the peak (maximum so far) resident set size (physical
+ * memory use) measured in bytes, or zero if the value cannot be
+ * determined on this OS.
+ */
+size_t getPeakRSS( )
+{
+#if defined(_WIN32)
+	/* Windows -------------------------------------------------- */
+	PROCESS_MEMORY_COUNTERS info;
+	GetProcessMemoryInfo( GetCurrentProcess( ), &info, sizeof(info) );
+	return (size_t)info.PeakWorkingSetSize;
+
+#elif (defined(_AIX) || defined(__TOS__AIX__)) || (defined(__sun__) || defined(__sun) || defined(sun) && (defined(__SVR4) || defined(__svr4__)))
+	/* AIX and Solaris ------------------------------------------ */
+	struct psinfo psinfo;
+	int fd = -1;
+	if ( (fd = open( "/proc/self/psinfo", O_RDONLY )) == -1 )
+		return (size_t)0L;		/* Can't open? */
+	if ( read( fd, &psinfo, sizeof(psinfo) ) != sizeof(psinfo) )
+	{
+		close( fd );
+		return (size_t)0L;		/* Can't read? */
+	}
+	close( fd );
+	return (size_t)(psinfo.pr_rssize * 1024L);
+
+#elif defined(__unix__) || defined(__unix) || defined(unix) || (defined(__APPLE__) && defined(__MACH__))
+	/* BSD, Linux, and OSX -------------------------------------- */
+	struct rusage rusage;
+	getrusage( RUSAGE_SELF, &rusage );
+#if defined(__APPLE__) && defined(__MACH__)
+	return (size_t)rusage.ru_maxrss;
+#else
+	return (size_t)(rusage.ru_maxrss * 1024L);
+#endif
+
+#else
+	/* Unknown OS ----------------------------------------------- */
+	return (size_t)0L;			/* Unsupported. */
+#endif
+}
+
+
+
+
+
+/**
+ * Returns the current resident set size (physical memory use) measured
+ * in bytes, or zero if the value cannot be determined on this OS.
+ */
+size_t getCurrentRSS( )
+{
+#if defined(_WIN32)
+	/* Windows -------------------------------------------------- */
+	PROCESS_MEMORY_COUNTERS info;
+	GetProcessMemoryInfo( GetCurrentProcess( ), &info, sizeof(info) );
+	return (size_t)info.WorkingSetSize;
+
+#elif defined(__APPLE__) && defined(__MACH__)
+	/* OSX ------------------------------------------------------ */
+	struct mach_task_basic_info info;
+	mach_msg_type_number_t infoCount = MACH_TASK_BASIC_INFO_COUNT;
+	if ( task_info( mach_task_self( ), MACH_TASK_BASIC_INFO,
+		(task_info_t)&info, &infoCount ) != KERN_SUCCESS )
+		return (size_t)0L;		/* Can't access? */
+	return (size_t)info.resident_size;
+
+#elif defined(__linux__) || defined(__linux) || defined(linux) || defined(__gnu_linux__)
+	/* Linux ---------------------------------------------------- */
+	long rss = 0L;
+	FILE* fp = NULL;
+	if ( (fp = fopen( "/proc/self/statm", "r" )) == NULL )
+		return (size_t)0L;		/* Can't open? */
+	if ( fscanf( fp, "%*s%ld", &rss ) != 1 )
+	{
+		fclose( fp );
+		return (size_t)0L;		/* Can't read? */
+	}
+	fclose( fp );
+	return (size_t)rss * (size_t)sysconf( _SC_PAGESIZE);
+
+#else
+	/* AIX, BSD, Solaris, and Unknown OS ------------------------ */
+	return (size_t)0L;			/* Unsupported. */
+#endif
+}