lib/rainbows.rb

   1 # -*- encoding: binary -*-
   2 require 'kgio'
   3 require 'unicorn'
   4 # the value passed to TCP_DEFER_ACCEPT actually matters in Linux 2.6.32+
   5 Unicorn::SocketHelper::DEFAULTS[:tcp_defer_accept] = 60
   6
   7 # See http://rainbows.bogomips.org/ for documentation
   8 module Rainbows
   9   # :stopdoc:
  10   O = {}
  11
  12   # map of numeric file descriptors to IO objects to avoid using IO.new
  13   # and potentially causing race conditions when using /dev/fd/
  14   FD_MAP = {}
  15   FD_MAP.compare_by_identity if FD_MAP.respond_to?(:compare_by_identity)
  16
  17   require 'rainbows/const'
  18   require 'rainbows/http_parser'
  19   require 'rainbows/http_server'
  20   autoload :Response, 'rainbows/response'
  21   autoload :ProcessClient, 'rainbows/process_client'
  22   autoload :Client, 'rainbows/client'
  23   autoload :Base, 'rainbows/base'
  24   autoload :Sendfile, 'rainbows/sendfile'
  25   autoload :AppPool, 'rainbows/app_pool'
  26   autoload :DevFdResponse, 'rainbows/dev_fd_response'
  27   autoload :MaxBody, 'rainbows/max_body'
  28   autoload :QueuePool, 'rainbows/queue_pool'
  29   autoload :EvCore, 'rainbows/ev_core'
  30   autoload :SocketProxy, 'rainbows/socket_proxy'
  31
  32   # :startdoc:
  33   # Sleeps the current application dispatch.  This will pick the
  34   # optimal method to sleep depending on the concurrency model chosen
  35   # (which may still suck and block the entire process).  Using this
  36   # with the basic :Coolio or :EventMachine models is not recommended.
  37   # This should be used within your Rack application.
  38   def self.sleep(seconds)
  39     case Rainbows.server.use
  40     when :FiberPool, :FiberSpawn
  41       Rainbows::Fiber.sleep(seconds)
  42     when :RevFiberSpawn, :CoolioFiberSpawn
  43       Rainbows::Fiber::Coolio::Sleeper.new(seconds)
  44     when :Revactor
  45       Actor.sleep(seconds)
  46     else
  47       Kernel.sleep(seconds)
  48     end
  49   end
  50   # :stopdoc:
  51
  52   class << self
  53     attr_accessor :server
  54     attr_accessor :cur # may not always be used
  55     attr_reader :alive
  56     attr_writer :worker
  57     attr_writer :forked
  58     attr_writer :readers
  59   end
  60
  61   def self.config!(mod, *opts)
  62     @forked or abort "#{mod} should only be loaded in a worker process"
  63     opts.each do |opt|
  64       mod.const_set(opt.to_s.upcase, Rainbows.server.__send__(opt))
  65     end
  66   end
  67
  68   @alive = true
  69   @cur = 0
  70   @expire = nil
  71   @at_quit = []
  72
  73   def self.at_quit(&block)
  74     @at_quit << block
  75   end
  76
  77   def self.tick
  78     @worker.tick = now.to_i
  79     exit!(2) if @expire && now >= @expire
  80     @alive && @server.master_pid == Process.ppid or quit!
  81   end
  82
  83   def self.cur_alive
  84     @alive || @cur > 0
  85   end
  86
  87   def self.quit!
  88     unless @expire
  89       @alive = false
  90       Rainbows::HttpParser.quit
  91       @expire = now + (@server.timeout * 2.0)
  92       tmp = @readers.dup
  93       @readers.clear
  94       tmp.each { |s| s.close rescue nil }.clear
  95       @at_quit.each { |task| task.call }
  96
  97       # XXX hack to break out of IO.select in worker_loop for some models
  98       Process.kill(:QUIT, $$)
  99     end
 100     false
 101   end
 102
 103   # try to use the monotonic clock in Ruby >= 2.1, it is immune to clock
 104   # offset adjustments and generates less garbage (Float vs Time object)
 105   begin
 106     Process.clock_gettime(Process::CLOCK_MONOTONIC)
 107     def self.now
 108       Process.clock_gettime(Process::CLOCK_MONOTONIC)
 109     end
 110   rescue NameError, NoMethodError
 111     def self.now # Ruby <= 2.0
 112       Rainbows.now
 113     end
 114   end
 115
 116   autoload :Base, "rainbows/base"
 117   autoload :WriterThreadPool, "rainbows/writer_thread_pool"
 118   autoload :WriterThreadSpawn, "rainbows/writer_thread_spawn"
 119   autoload :Revactor, "rainbows/revactor"
 120   autoload :ThreadSpawn, "rainbows/thread_spawn"
 121   autoload :ThreadPool, "rainbows/thread_pool"
 122   autoload :Rev, "rainbows/rev"
 123   autoload :RevThreadSpawn, "rainbows/rev_thread_spawn"
 124   autoload :RevThreadPool, "rainbows/rev_thread_pool"
 125   autoload :RevFiberSpawn, "rainbows/rev_fiber_spawn"
 126   autoload :Coolio, "rainbows/coolio"
 127   autoload :CoolioThreadSpawn, "rainbows/coolio_thread_spawn"
 128   autoload :CoolioThreadPool, "rainbows/coolio_thread_pool"
 129   autoload :CoolioFiberSpawn, "rainbows/coolio_fiber_spawn"
 130   autoload :Epoll, "rainbows/epoll"
 131   autoload :XEpoll, "rainbows/xepoll"
 132   autoload :EventMachine, "rainbows/event_machine"
 133   autoload :FiberSpawn, "rainbows/fiber_spawn"
 134   autoload :FiberPool, "rainbows/fiber_pool"
 135   autoload :ActorSpawn, "rainbows/actor_spawn"
 136   autoload :NeverBlock, "rainbows/never_block"
 137   autoload :XEpollThreadSpawn, "rainbows/xepoll_thread_spawn"
 138   autoload :XEpollThreadPool, "rainbows/xepoll_thread_pool"
 139   autoload :StreamResponseEpoll, "rainbows/stream_response_epoll"
 140
 141   autoload :Fiber, 'rainbows/fiber' # core class
 142   autoload :StreamFile, 'rainbows/stream_file'
 143   autoload :ThreadTimeout, 'rainbows/thread_timeout'
 144   autoload :WorkerYield, 'rainbows/worker_yield'
 145   autoload :SyncClose, 'rainbows/sync_close'
 146   autoload :ReverseProxy, 'rainbows/reverse_proxy'
 147   autoload :JoinThreads, 'rainbows/join_threads'
 148   autoload :PoolSize, 'rainbows/pool_size'
 149 end
 150
 151 require 'rainbows/error'
 152 require 'rainbows/configurator'