Gecko [ beacons-mine.com ]

Name	Size	Permission	Date
cgi	[ DIR ]	drwxr-xr-x	2026-02-18 15:11
date	[ DIR ]	drwxr-xr-x	2026-02-18 15:11
digest	[ DIR ]	drwxr-xr-x	2026-02-18 15:11
dl	[ DIR ]	drwxr-xr-x	2026-02-18 15:11
drb	[ DIR ]	drwxr-xr-x	2026-02-18 15:11
fiddle	[ DIR ]	drwxr-xr-x	2026-02-18 15:11
io	[ DIR ]	drwxr-xr-x	2026-02-18 15:11
irb	[ DIR ]	drwxr-xr-x	2026-02-18 15:11
json	[ DIR ]	drwxr-xr-x	2026-02-18 15:11
matrix	[ DIR ]	drwxr-xr-x	2026-02-18 15:11
net	[ DIR ]	drwxr-xr-x	2026-02-18 15:11
openssl	[ DIR ]	drwxr-xr-x	2026-02-18 15:11
optparse	[ DIR ]	drwxr-xr-x	2026-02-18 15:11
psych	[ DIR ]	drwxr-xr-x	2026-02-18 15:11
racc	[ DIR ]	drwxr-xr-x	2026-02-18 15:11
rake	[ DIR ]	drwxr-xr-x	2026-02-18 15:11
rbconfig	[ DIR ]	drwxr-xr-x	2026-02-18 15:11
rdoc	[ DIR ]	drwxr-xr-x	2026-02-18 15:11
rexml	[ DIR ]	drwxr-xr-x	2026-02-18 15:11
rinda	[ DIR ]	drwxr-xr-x	2026-02-18 15:11
ripper	[ DIR ]	drwxr-xr-x	2026-02-18 15:11
rss	[ DIR ]	drwxr-xr-x	2026-02-18 15:11
rubygems	[ DIR ]	drwxr-xr-x	2026-02-18 15:11
shell	[ DIR ]	drwxr-xr-x	2026-02-18 15:11
syslog	[ DIR ]	drwxr-xr-x	2026-02-18 15:11
test	[ DIR ]	drwxr-xr-x	2026-02-18 15:11
uri	[ DIR ]	drwxr-xr-x	2026-02-18 15:11
webrick	[ DIR ]	drwxr-xr-x	2026-02-18 15:11
x86_64-linux	[ DIR ]	drwxr-xr-x	2026-02-18 15:11
xmlrpc	[ DIR ]	drwxr-xr-x	2026-02-18 15:11
yaml	[ DIR ]	drwxr-xr-x	2026-02-18 15:11
English.rb	6.44 KB	-rw-r--r--	2013-02-04 08:20
abbrev.rb	3.31 KB	-rw-r--r--	2013-02-21 23:05
base64.rb	2.63 KB	-rw-r--r--	2013-05-19 08:40
benchmark.rb	17.95 KB	-rw-r--r--	2013-09-20 21:35
cgi.rb	9.84 KB	-rw-r--r--	2013-07-18 19:20
cmath.rb	8.93 KB	-rw-r--r--	2015-07-03 14:42
complex.rb	380 B	-rw-r--r--	2009-08-16 21:04
csv.rb	81.68 KB	-rw-r--r--	2014-09-14 20:55
date.rb	946 B	-rw-r--r--	2023-07-26 19:52
debug.rb	29.08 KB	-rw-r--r--	2013-12-14 20:18
delegate.rb	11.13 KB	-rw-r--r--	2014-02-02 19:16
digest.rb	2.34 KB	-rw-r--r--	2023-07-26 19:52
dl.rb	280 B	-rw-r--r--	2023-07-26 19:52
drb.rb	19 B	-rw-r--r--	2009-10-02 16:15
e2mmap.rb	3.89 KB	-rw-r--r--	2013-12-17 16:50
erb.rb	26.07 KB	-rw-r--r--	2014-08-11 20:25
expect.rb	2.14 KB	-rw-r--r--	2023-07-26 19:52
fiddle.rb	1.65 KB	-rw-r--r--	2023-07-26 19:52
fileutils.rb	47.17 KB	-rw-r--r--	2015-04-28 10:46
find.rb	2.36 KB	-rw-r--r--	2014-10-15 21:01
forwardable.rb	7.86 KB	-rw-r--r--	2013-05-24 03:16
getoptlong.rb	15.38 KB	-rw-r--r--	2013-05-19 20:20
gserver.rb	8.86 KB	-rw-r--r--	2014-07-06 19:27
ipaddr.rb	17.05 KB	-rw-r--r--	2015-10-29 20:06
irb.rb	20.03 KB	-rw-r--r--	2016-03-25 13:52
json.rb	1.74 KB	-rw-r--r--	2023-07-26 19:52
kconv.rb	5.74 KB	-rw-r--r--	2023-07-26 19:52
logger.rb	22.37 KB	-rw-r--r--	2016-02-25 16:34
mathn.rb	6.52 KB	-rw-r--r--	2011-08-27 03:52
matrix.rb	45.43 KB	-rw-r--r--	2014-07-11 19:38
mkmf.rb	80.5 KB	-rw-r--r--	2023-07-26 19:49
monitor.rb	6.93 KB	-rw-r--r--	2012-11-16 22:25
mutex_m.rb	2 KB	-rw-r--r--	2013-02-20 08:21
observer.rb	5.81 KB	-rw-r--r--	2013-11-21 10:14
open-uri.rb	24.27 KB	-rw-r--r--	2014-02-22 14:24
open3.rb	20.37 KB	-rw-r--r--	2013-12-01 08:43
openssl.rb	528 B	-rw-r--r--	2023-07-26 19:52
optparse.rb	50.8 KB	-rw-r--r--	2013-11-28 13:04
ostruct.rb	7.7 KB	-rw-r--r--	2013-10-23 20:44
pathname.rb	15.3 KB	-rw-r--r--	2023-07-26 19:52
pp.rb	14.1 KB	-rw-r--r--	2013-10-22 14:59
prettyprint.rb	16.33 KB	-rw-r--r--	2013-05-19 08:40
prime.rb	13.2 KB	-rw-r--r--	2013-07-15 09:51
profile.rb	205 B	-rw-r--r--	2009-10-02 16:15
profiler.rb	4.51 KB	-rw-r--r--	2013-05-20 04:34
pstore.rb	14.85 KB	-rw-r--r--	2012-11-11 09:53
psych.rb	14.88 KB	-rw-r--r--	2023-07-26 19:52
rake.rb	2.12 KB	-rw-r--r--	2013-10-12 03:05
rational.rb	308 B	-rw-r--r--	2009-09-24 06:12
rdoc.rb	4.92 KB	-rw-r--r--	2013-12-22 15:55
resolv-replace.rb	1.73 KB	-rw-r--r--	2013-03-11 19:17
resolv.rb	72.31 KB	-rw-r--r--	2015-05-13 11:03
ripper.rb	2.53 KB	-rw-r--r--	2023-07-26 19:52
rss.rb	2.84 KB	-rw-r--r--	2011-05-11 15:52
rubygems.rb	30.97 KB	-rw-r--r--	2023-07-26 19:49
scanf.rb	23.54 KB	-rw-r--r--	2013-12-14 08:25
securerandom.rb	8.49 KB	-rw-r--r--	2013-11-07 23:34
set.rb	18.7 KB	-rw-r--r--	2013-11-23 05:20
shell.rb	10.3 KB	-rw-r--r--	2013-05-19 08:40
shellwords.rb	5.94 KB	-rw-r--r--	2013-12-14 23:56
singleton.rb	4.02 KB	-rw-r--r--	2011-05-18 19:39
socket.rb	25.6 KB	-rw-r--r--	2023-07-26 19:52
sync.rb	7.25 KB	-rw-r--r--	2013-05-19 08:40
tempfile.rb	11.4 KB	-rw-r--r--	2013-11-21 14:58
thwait.rb	3.38 KB	-rw-r--r--	2013-11-07 22:32
time.rb	21.32 KB	-rw-r--r--	2015-08-17 13:11
timeout.rb	3.7 KB	-rw-r--r--	2015-08-17 13:25
tmpdir.rb	4.15 KB	-rw-r--r--	2013-05-19 08:40
tracer.rb	6.4 KB	-rw-r--r--	2013-07-18 19:20
tsort.rb	14.14 KB	-rw-r--r--	2013-10-17 21:29
ubygems.rb	268 B	-rw-r--r--	2009-10-02 16:15
un.rb	8.87 KB	-rw-r--r--	2013-07-05 19:13
uri.rb	3.07 KB	-rw-r--r--	2011-05-14 01:33
weakref.rb	3.23 KB	-rw-r--r--	2013-11-10 04:12
webrick.rb	6.69 KB	-rw-r--r--	2013-10-06 05:09
xmlrpc.rb	8.49 KB	-rw-r--r--	2013-12-12 08:39
yaml.rb	2.31 KB	-rw-r--r--	2013-08-12 09:19

Rename

# = monitor.rb
#
# Copyright (C) 2001  Shugo Maeda <shugo@ruby-lang.org>
#
# This library is distributed under the terms of the Ruby license.
# You can freely distribute/modify this library.
#

require 'thread'

#
# In concurrent programming, a monitor is an object or module intended to be
# used safely by more than one thread.  The defining characteristic of a
# monitor is that its methods are executed with mutual exclusion.  That is, at
# each point in time, at most one thread may be executing any of its methods.
# This mutual exclusion greatly simplifies reasoning about the implementation
# of monitors compared to reasoning about parallel code that updates a data
# structure.
#
# You can read more about the general principles on the Wikipedia page for
# Monitors[http://en.wikipedia.org/wiki/Monitor_%28synchronization%29]
#
# == Examples
#
# === Simple object.extend
#
#   require 'monitor.rb'
#
#   buf = []
#   buf.extend(MonitorMixin)
#   empty_cond = buf.new_cond
#
#   # consumer
#   Thread.start do
#     loop do
#       buf.synchronize do
#         empty_cond.wait_while { buf.empty? }
#         print buf.shift
#       end
#     end
#   end
#
#   # producer
#   while line = ARGF.gets
#     buf.synchronize do
#       buf.push(line)
#       empty_cond.signal
#     end
#   end
#
# The consumer thread waits for the producer thread to push a line to buf
# while <tt>buf.empty?</tt>.  The producer thread (main thread) reads a
# line from ARGF and pushes it into buf then calls <tt>empty_cond.signal</tt>
# to notify the consumer thread of new data.
#
# === Simple Class include
#
#   require 'monitor'
#
#   class SynchronizedArray < Array
#
#     include MonitorMixin
#
#     def initialize(*args)
#       super(*args)
#     end
#
#     alias :old_shift :shift
#     alias :old_unshift :unshift
#
#     def shift(n=1)
#       self.synchronize do
#         self.old_shift(n)
#       end
#     end
#
#     def unshift(item)
#       self.synchronize do
#         self.old_unshift(item)
#       end
#     end
#
#     # other methods ...
#   end
#
# +SynchronizedArray+ implements an Array with synchronized access to items.
# This Class is implemented as subclass of Array which includes the
# MonitorMixin module.
#
module MonitorMixin
  #
  # FIXME: This isn't documented in Nutshell.
  #
  # Since MonitorMixin.new_cond returns a ConditionVariable, and the example
  # above calls while_wait and signal, this class should be documented.
  #
  class ConditionVariable
    class Timeout < Exception; end

#
    # Releases the lock held in the associated monitor and waits; reacquires the lock on wakeup.
    #
    # If +timeout+ is given, this method returns after +timeout+ seconds passed,
    # even if no other thread doesn't signal.
    #
    def wait(timeout = nil)
      @monitor.__send__(:mon_check_owner)
      count = @monitor.__send__(:mon_exit_for_cond)
      begin
        @cond.wait(@monitor.instance_variable_get(:@mon_mutex), timeout)
        return true
      ensure
        @monitor.__send__(:mon_enter_for_cond, count)
      end
    end

#
    # Calls wait repeatedly while the given block yields a truthy value.
    #
    def wait_while
      while yield
        wait
      end
    end

#
    # Calls wait repeatedly until the given block yields a truthy value.
    #
    def wait_until
      until yield
        wait
      end
    end

#
    # Wakes up the first thread in line waiting for this lock.
    #
    def signal
      @monitor.__send__(:mon_check_owner)
      @cond.signal
    end

#
    # Wakes up all threads waiting for this lock.
    #
    def broadcast
      @monitor.__send__(:mon_check_owner)
      @cond.broadcast
    end

private

def initialize(monitor)
      @monitor = monitor
      @cond = ::ConditionVariable.new
    end
  end

def self.extend_object(obj)
    super(obj)
    obj.__send__(:mon_initialize)
  end

#
  # Attempts to enter exclusive section.  Returns +false+ if lock fails.
  #
  def mon_try_enter
    if @mon_owner != Thread.current
      unless @mon_mutex.try_lock
        return false
      end
      @mon_owner = Thread.current
    end
    @mon_count += 1
    return true
  end
  # For backward compatibility
  alias try_mon_enter mon_try_enter

#
  # Enters exclusive section.
  #
  def mon_enter
    if @mon_owner != Thread.current
      @mon_mutex.lock
      @mon_owner = Thread.current
    end
    @mon_count += 1
  end

#
  # Leaves exclusive section.
  #
  def mon_exit
    mon_check_owner
    @mon_count -=1
    if @mon_count == 0
      @mon_owner = nil
      @mon_mutex.unlock
    end
  end

#
  # Enters exclusive section and executes the block.  Leaves the exclusive
  # section automatically when the block exits.  See example under
  # +MonitorMixin+.
  #
  def mon_synchronize
    mon_enter
    begin
      yield
    ensure
      mon_exit
    end
  end
  alias synchronize mon_synchronize

#
  # Creates a new MonitorMixin::ConditionVariable associated with the
  # receiver.
  #
  def new_cond
    return ConditionVariable.new(self)
  end

private

# Use <tt>extend MonitorMixin</tt> or <tt>include MonitorMixin</tt> instead
  # of this constructor.  Have look at the examples above to understand how to
  # use this module.
  def initialize(*args)
    super
    mon_initialize
  end

# Initializes the MonitorMixin after being included in a class or when an
  # object has been extended with the MonitorMixin
  def mon_initialize
    @mon_owner = nil
    @mon_count = 0
    @mon_mutex = Mutex.new
  end

def mon_check_owner
    if @mon_owner != Thread.current
      raise ThreadError, "current thread not owner"
    end
  end

def mon_enter_for_cond(count)
    @mon_owner = Thread.current
    @mon_count = count
  end

def mon_exit_for_cond
    count = @mon_count
    @mon_owner = nil
    @mon_count = 0
    return count
  end
end

# Use the Monitor class when you want to have a lock object for blocks with
# mutual exclusion.
#
#   require 'monitor'
#
#   lock = Monitor.new
#   lock.synchronize do
#     # exclusive access
#   end
#
class Monitor
  include MonitorMixin
  alias try_enter try_mon_enter
  alias enter mon_enter
  alias exit mon_exit
end

# Documentation comments:
#  - All documentation comes from Nutshell.
#  - MonitorMixin.new_cond appears in the example, but is not documented in
#    Nutshell.
#  - All the internals (internal modules Accessible and Initializable, class
#    ConditionVariable) appear in RDoc.  It might be good to hide them, by
#    making them private, or marking them :nodoc:, etc.
#  - RDoc doesn't recognise aliases, so we have mon_synchronize documented, but
#    not synchronize.
#  - mon_owner is in Nutshell, but appears as an accessor in a separate module
#    here, so is hard/impossible to RDoc.  Some other useful accessors
#    (mon_count and some queue stuff) are also in this module, and don't appear
#    directly in the RDoc output.
#  - in short, it may be worth changing the code layout in this file to make the
#    documentation easier

# Local variables:
# mode: Ruby
# tab-width: 8
# End: