Module: Rainbows::Epoll

Includes:
Base
Defined in:
lib/rainbows/epoll.rb

Overview

Edge-triggered epoll concurrency model using sleepy_penguin for epoll.

Unlike more portable options like Coolio and EventMachine, this is Linux-only, but uses edge-triggering instead of level-triggering, so it may perform better in some cases. Coolio and EventMachine have better library support and may be widely-used, however.

Consider using XEpoll instead of this if you are using Ruby 1.9, it will avoid accept()-scalability issues with many worker processes.

When serving static files, this is extremely unfair and optimized for throughput at the expense of fairness. This is not an issue if you’re not serving static files, or if your working set is small enough to always be in your kernel page cache. This concurrency model may starve clients if you have slow disks and large static files.

Do not use this if you have slow external dependencies.

RubyGem Requirements

  • raindrops 0.6.0 or later

  • sleepy_penguin 3.0.1 or later

  • sendfile 1.1.0 or later

Instance Method Summary collapse

Methods included from Base

included, #process_client, #reopen_worker_logs, #sig_receiver

Instance Method Details

#init_worker_process(worker) ⇒ Object 



38
39
40
41
42
43
 
# File 'lib/rainbows/epoll.rb', line 38

def init_worker_process(worker)
  super
  Rainbows.const_set(:EP, SleepyPenguin::Epoll.new)
  Rainbows::Client.__send__ :include, Client
  LISTENERS.each { |io| io.extend(Server) }
end

#worker_loop(worker) ⇒ Object

:nodoc:



45
46
47
48
 
# File 'lib/rainbows/epoll.rb', line 45

def worker_loop(worker) # :nodoc:
  init_worker_process(worker)
  Client.loop
end