win32-semaphore 0.4.2 → 0.4.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 9f9238e3788d95d1f36ffaf34a294a449d3f5cf1
-  data.tar.gz: 936daceae5621a20ec60ceee6c0d37bde279268a
+  metadata.gz: c68f8fb2fc2287ed58d227b07c37980aa608d1f9
+  data.tar.gz: 726ec74da679318c6d63dc24ea34392d0d81c064
 SHA512:
-  metadata.gz: 256d91d371a994a456f00707e03c2e09e5ed6c63570a98a51db535b77b6d3c09ef62a04899cd42cf24fe2ee06f45657e3a67bc99d3b0bed402b552c22c0ec3ba
-  data.tar.gz: 47217dc543048157a8a5d6b61c40203ca05f9526d2e5333c5bf01597cb64e4c623e385de9394a26ffeada6cf3708eb9b79f5bbf61fd5b986bdce8ca3485ab1ff
+  metadata.gz: b4cbbd8ea7d4075698afec1cac1b0b31b6f3cef10e60e0694ac9e63f3cf9bfe6fd14e45c0ee418a0507757f30ccd7c34a8c441c4ab18c1139603aca7992851ce
+  data.tar.gz: 0f1a77a05ad27d8118253fe1b2f2699979b8fd3a4d6b51199541dc5582febdcc6e20c91276cb24f87bbd4759569f145c0afa36045190e7a0a9d0eb0a5f16d3e9

data/CHANGES

@@ -1,59 +1,66 @@
-== 0.4.2 - 21-Oct-2013
-* Fixed the INVALID_HANDLE_VALUE constant for 64-bit Ruby.
-* Added Rake as a development dependency.
-* Fixed gem:create task for Rubygems 2.
-
-== 0.4.1 - 10-Apr-2013
-* Fixed the HANDLE type in the underlying FFI code. This affects
-  64 bit versions of Ruby.
-
-== 0.4.0 - 10-Jul-2012
-* Converted source to use FFI.
-* Refactored tests.
-* Now requires Ruby 1.9 or later.
-* Removed the Error class. Now uses SystemCallError (Errno::) internally if
-  a Windows function fails.
-
-== 0.3.2 - 23-Mar-2012
-* Refactored the Rakefile and cleaned up the gemspec.
-* Removed one test that was originally designed for the C version.
-
-== 0.3.1 - 11-Aug-2009
-* Changed license to Artistic 2.0.
-* The Semaphore.open method is now slightly more robust.
-* Renamed the test and example files.
-* Some gemspec updates, including license and description.
-
-== 0.3.0 - 3-May-2007
-* Now pure Ruby.
-* Added a Rakefile, with test, install and example tasks.
-* Both the Semaphore.new and Semaphore.open methods now accept a block, and
-  automatically close the associated handle at the end of the block.
-* The Semaphore.new method now accepts an optional fourth argument that
-  controls whether the Event object can be inherited by other processes.
-* Added a gemspec.
-* Removed the doc/semaphore.txt file. The documentation is now inlined via
-  RDoc. There is also some documentation in the README file.
-
-== 0.2.2 - 10-Jun-2005
-* Now Unicode friendly.
-* Inlined rdoc documentation into the C source code.
-* Made the semaphore.txt file rdoc friendly.
-* Removed the semaphore.rd file.
-
-== 0.2.1 - 1-Mar-2005
-* Added a VERSION constant (oops).
-* Moved the 'examples' directory to the toplevel directory.
-* Made the CHANGES and README files rdoc friendly.
-* Removed an unused (and unnecessary) helper function in semaphore.h.
-
-== 0.2.0 - 16-Jul-2004
-* Modified to use the newer allocation framework.  This means that as of this
-  release, this package requires Ruby 1.8.0 or later.
-* Fixed a bug in the constructor where it was possible for the constructor to
-  fail, but have no error raised.
-* Moved the test.rb file to the doc/examples directory.
-* Added more tests.
-
-== 0.1.0 - 14-May-2004
-* Initial release
+== 0.4.3 - 23-Nov-2015
+* Fixed the function prototype for OpenSemaphore and made corresponding changes.
+* The gem is now signed.
+* Added a win32-semaphore.rb file for convenience.
+* The gem related tasks in the gemspec now assume Rubygems 2.x.
+* Added certs to the gemspec and removed references to rubyforge_project.
+
+== 0.4.2 - 21-Oct-2013
+* Fixed the INVALID_HANDLE_VALUE constant for 64-bit Ruby.
+* Added Rake as a development dependency.
+* Fixed gem:create task for Rubygems 2.
+
+== 0.4.1 - 10-Apr-2013
+* Fixed the HANDLE type in the underlying FFI code. This affects
+  64 bit versions of Ruby.
+
+== 0.4.0 - 10-Jul-2012
+* Converted source to use FFI.
+* Refactored tests.
+* Now requires Ruby 1.9 or later.
+* Removed the Error class. Now uses SystemCallError (Errno::) internally if
+  a Windows function fails.
+
+== 0.3.2 - 23-Mar-2012
+* Refactored the Rakefile and cleaned up the gemspec.
+* Removed one test that was originally designed for the C version.
+
+== 0.3.1 - 11-Aug-2009
+* Changed license to Artistic 2.0.
+* The Semaphore.open method is now slightly more robust.
+* Renamed the test and example files.
+* Some gemspec updates, including license and description.
+
+== 0.3.0 - 3-May-2007
+* Now pure Ruby.
+* Added a Rakefile, with test, install and example tasks.
+* Both the Semaphore.new and Semaphore.open methods now accept a block, and
+  automatically close the associated handle at the end of the block.
+* The Semaphore.new method now accepts an optional fourth argument that
+  controls whether the Event object can be inherited by other processes.
+* Added a gemspec.
+* Removed the doc/semaphore.txt file. The documentation is now inlined via
+  RDoc. There is also some documentation in the README file.
+
+== 0.2.2 - 10-Jun-2005
+* Now Unicode friendly.
+* Inlined rdoc documentation into the C source code.
+* Made the semaphore.txt file rdoc friendly.
+* Removed the semaphore.rd file.
+
+== 0.2.1 - 1-Mar-2005
+* Added a VERSION constant (oops).
+* Moved the 'examples' directory to the toplevel directory.
+* Made the CHANGES and README files rdoc friendly.
+* Removed an unused (and unnecessary) helper function in semaphore.h.
+
+== 0.2.0 - 16-Jul-2004
+* Modified to use the newer allocation framework.  This means that as of this
+  release, this package requires Ruby 1.8.0 or later.
+* Fixed a bug in the constructor where it was possible for the constructor to
+  fail, but have no error raised.
+* Moved the test.rb file to the doc/examples directory.
+* Added more tests.
+
+== 0.1.0 - 14-May-2004
+* Initial release

data/MANIFEST

@@ -1,8 +1,10 @@
-* CHANGES
-* MANIFEST
-* README
-* Rakefile
-* win32-semaphore.gemspec
-* examples/example_semaphore.rb
-* lib/win32/semaphore.rb
-* test/test_win32_semaphore.rb
+* CHANGES
+* MANIFEST
+* README
+* Rakefile
+* win32-semaphore.gemspec
+* certs/djberg96_pub.pem
+* examples/example_semaphore.rb
+* lib/win32-semaphore.rb
+* lib/win32/semaphore.rb
+* test/test_win32_semaphore.rb

data/README

@@ -1,57 +1,55 @@
-== Brief Description
-   An interface for MS Windows Semaphores.
-
-== Prerequisites
-   win32-ipc 0.6.0 or later.
-
-== Installation
-   gem install win32-semaphore
-
-== Synopsis
-   require 'win32/semaphore'
-   include Win32
-
-   Semaphore.new(1, 5, 'test') do |sem|
-     puts 'uh, oh' unless sem.wait(10) > 0
-     sem.release(2) # 2
-   end
-
-== Documentation
-   The semaphore.rb file contains inline RDoc documentation. If you installed
-   this file as a gem, then you have the docs.
-
-   For more detailed documentation about Semaphores on MS Windows in general,
-   please visit http://www.msdn.com/library and lookup the CreateSemaphore(),
-   OpenSemaphore() and ReleaseSemaphore() functions.
-
-== Notes
-   The Semaphore class is a subclass of Win32::Ipc (win32-ipc). This package
-   require's the win32-ipc package internally (you don't need to explicitly
-   call it).
-
-== Acknowledgements
-   Adapted originally from the Win32::Semaphore Perl module by Christopher
-   J. Madsen.
-
-== Known Bugs
-   None known.  Any bugs should be reported on the project page at
-   https://github.com/djberg96/win32-semaphore.
-
-== Future Plans
-   Suggestions welcome.
-
-== License
-   Artistic 2.0
-
-== Copyright
-   (C) 2003-2013 Daniel J. Berger
-   All Rights Reserved	
-
-== Warranty
-   This package is provided "as is" and without any express or
-   implied warranties, including, without limitation, the implied
-   warranties of merchantability and fitness for a particular purpose.
-
-== Authors
-   Daniel J. Berger
-   Park Heesob
+== Brief Description
+   An interface for MS Windows Semaphores.
+
+== Prerequisites
+   win32-ipc 0.6.0 or later.
+
+== Installation
+   gem install win32-semaphore
+
+== Synopsis
+   require 'win32/semaphore'
+   include Win32
+
+   Semaphore.new(1, 5, 'test') do |sem|
+     puts 'uh, oh' unless sem.wait(10) > 0
+     sem.release(2) # 2
+   end
+
+== Documentation
+   The semaphore.rb file contains inline RDoc documentation. If you installed
+   this file as a gem, then you have the docs.
+
+   For more detailed documentation about Semaphores on MS Windows in general,
+   please visit http://www.msdn.com/library and lookup the CreateSemaphore(),
+   OpenSemaphore() and ReleaseSemaphore() functions.
+
+== Notes
+   The Win32::Semaphore class is a subclass of Win32::Ipc.
+
+== Acknowledgements
+   Adapted originally from the Win32::Semaphore Perl module by Christopher
+   J. Madsen.
+
+== Known Bugs
+   None known. Any bugs should be reported on the project page at
+   https://github.com/djberg96/win32-semaphore.
+
+== Future Plans
+   Suggestions welcome.
+
+== License
+   Artistic 2.0
+
+== Copyright
+   (C) 2003-2015 Daniel J. Berger
+   All Rights Reserved	
+
+== Warranty
+   This package is provided "as is" and without any express or
+   implied warranties, including, without limitation, the implied
+   warranties of merchantability and fitness for a particular purpose.
+
+== Authors
+   Daniel J. Berger
+   Park Heesob

data/Rakefile

@@ -1,36 +1,33 @@
-require 'rake'
-require 'rake/clean'
-require 'rake/testtask'
-
-CLEAN.include("**/*.gem")
-
-namespace :gem do
-  desc 'Create the win32-semaphore gem'
-  task :create => [:clean] do
-    spec = eval(IO.read('win32-semaphore.gemspec'))
-    if Gem::VERSION < "2.0.0"
-      Gem::Builder.new(spec).build
-    else
-      require 'rubygems/package'
-      Gem::Package.build(spec)
-    end
-  end
-
-  desc 'Install the win32-semaphore gem'
-  task :install => [:create] do
-    file = Dir["*.gem"].first
-    sh "gem install #{file}"
-  end
-end
-
-desc 'Run the example program'
-task :example do
-  ruby '-Ilib examples/example_semaphore.rb'
-end
-
-Rake::TestTask.new do |t|
-  t.verbose = true
-  t.warning = true
-end
-
-task :default => :test
+require 'rake'
+require 'rake/clean'
+require 'rake/testtask'
+
+CLEAN.include("**/*.gem")
+
+namespace :gem do
+  desc 'Create the win32-semaphore gem'
+  task :create => [:clean] do
+    require 'rubygems/package'
+    spec = eval(IO.read('win32-semaphore.gemspec'))
+    spec.signing_key = File.join(Dir.home, '.ssh', 'gem-private_key.pem')
+    Gem::Package.build(spec, true)
+  end
+
+  desc 'Install the win32-semaphore gem'
+  task :install => [:create] do
+    file = Dir["*.gem"].first
+    sh "gem install -l #{file}"
+  end
+end
+
+desc 'Run the example program'
+task :example do
+  ruby '-Ilib examples/example_semaphore.rb'
+end
+
+Rake::TestTask.new do |t|
+  t.verbose = true
+  t.warning = true
+end
+
+task :default => :test

data/certs/djberg96_pub.pem

@@ -0,0 +1,21 @@
+-----BEGIN CERTIFICATE-----
+MIIDcDCCAligAwIBAgIBATANBgkqhkiG9w0BAQUFADA/MREwDwYDVQQDDAhkamJl
+cmc5NjEVMBMGCgmSJomT8ixkARkWBWdtYWlsMRMwEQYKCZImiZPyLGQBGRYDY29t
+MB4XDTE1MDkwMjIwNDkxOFoXDTE2MDkwMTIwNDkxOFowPzERMA8GA1UEAwwIZGpi
+ZXJnOTYxFTATBgoJkiaJk/IsZAEZFgVnbWFpbDETMBEGCgmSJomT8ixkARkWA2Nv
+bTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAMyTkvXqRp6hLs9eoJOS
+Hmi8kRYbq9Vkf15/hMxJpotYMgJVHHWrmDcC5Dye2PbnXjTkKf266Zw0PtT9h+lI
+S3ts9HO+vaCFSMwFFZmnWJSpQ3CNw2RcHxjWkk9yF7imEM8Kz9ojhiDXzBetdV6M
+gr0lV/alUr7TNVBDngbXEfTWscyXh1qd7xZ4EcOdsDktCe5G45N/o3662tPQvJsi
+FOF0CM/KuBsa/HL1/eoEmF4B3EKIRfTHrQ3hu20Kv3RJ88QM4ec2+0dd97uX693O
+zv6981fyEg+aXLkxrkViM/tz2qR2ZE0jPhHTREPYeMEgptRkTmWSKAuLVWrJEfgl
+DtkCAwEAAaN3MHUwCQYDVR0TBAIwADALBgNVHQ8EBAMCBLAwHQYDVR0OBBYEFEwe
+nn6bfJADmuIDiMSOzedOrL+xMB0GA1UdEQQWMBSBEmRqYmVyZzk2QGdtYWlsLmNv
+bTAdBgNVHRIEFjAUgRJkamJlcmc5NkBnbWFpbC5jb20wDQYJKoZIhvcNAQEFBQAD
+ggEBAHmNOCWoDVD75zHFueY0viwGDVP1BNGFC+yXcb7u2GlK+nEMCORqzURbYPf7
+tL+/hzmePIRz7i30UM//64GI1NLv9jl7nIwjhPpXpf7/lu2I9hOTsvwSumb5UiKC
+/sqBxI3sfj9pr79Wpv4MuikX1XPik7Ncb7NPsJPw06Lvyc3Hkg5X2XpPtLtS+Gr2
+wKJnmzb5rIPS1cmsqv0M9LPWflzfwoZ/SpnmhagP+g05p8bRNKjZSA2iImM/GyYZ
+EJYzxdPOrx2n6NYR3Hk+vHP0U7UBSveI6+qx+ndQYaeyCn+GRX2PKS9h66YF/Q1V
+tGSHgAmcLlkdGgan182qsE/4kKM=
+-----END CERTIFICATE-----

data/examples/example_semaphore.rb

@@ -1,40 +1,40 @@
-##############################################################
-# example_semaphore.rb
-#
-# A test script for general futzing.  Modify as you see fit.
-#
-# Note that you can run this via the 'rake example' task.
-##############################################################
-require "win32/semaphore"
-include Win32
-
-test = 1
-s = Semaphore.new(3,3,"test")
-test += 1
-puts "ok #{test}"
-
-print 'not ' unless s.wait(10) > 0
-test += 1
-puts "ok #{test}"
-
-print 'not ' unless s.wait(0) > 0
-test += 1
-puts "ok #{test}"
-
-printf "If you don't see 'ok %d' immediately, you'd better hit Ctrl-C\n", test+1
-print 'not ' unless s.wait > 0
-test += 1
-puts "ok #{test}"
-
-print 'not ' if s.wait(0) > 0
-test += 1
-puts "ok #{test}"
-
-s.release
-s.release(1)
-
-print 'not ' unless (result = s.release(1)) == 2
-test += 1
-puts "ok #{test}\t(result is #{result})"
-
+##############################################################
+# example_semaphore.rb
+#
+# A test script for general futzing.  Modify as you see fit.
+#
+# Note that you can run this via the 'rake example' task.
+##############################################################
+require "win32/semaphore"
+include Win32
+
+test = 1
+s = Semaphore.new(3,3,"test")
+test += 1
+puts "ok #{test}"
+
+print 'not ' unless s.wait(10) > 0
+test += 1
+puts "ok #{test}"
+
+print 'not ' unless s.wait(0) > 0
+test += 1
+puts "ok #{test}"
+
+printf "If you don't see 'ok %d' immediately, you'd better hit Ctrl-C\n", test+1
+print 'not ' unless s.wait > 0
+test += 1
+puts "ok #{test}"
+
+print 'not ' if s.wait(0) > 0
+test += 1
+puts "ok #{test}"
+
+s.release
+s.release(1)
+
+print 'not ' unless (result = s.release(1)) == 2
+test += 1
+puts "ok #{test}\t(result is #{result})"
+
 s.close

data/lib/win32-semaphore.rb

@@ -0,0 +1 @@
+require_relative 'win32/semaphore'

data/lib/win32/semaphore.rb

@@ -1,165 +1,167 @@
-require 'win32/ipc'
-
-# The Win32 module serves as a namespace only.
-module Win32
-
-  # The Semaphore class encapsulates semaphore objects on Windows.
-  class Semaphore < Ipc
-    typedef :ulong, :dword
-    typedef :uintptr_t, :handle
-
-    ffi_lib :kernel32
-
-    private
-
-    class SecurityAttributes < FFI::Struct
-      layout(
-        :nLength, :dword,
-        :lpSecurityDescriptor, :pointer,
-        :bInheritHandle, :bool
-      )
-    end
-
-    attach_function :CreateSemaphoreW, [:pointer, :long, :long, :buffer_in], :handle
-    attach_function :OpenSemaphoreW, [:dword, :bool, :buffer_in], :handle
-    attach_function :ReleaseSemaphore, [:handle, :long, :pointer], :bool
-
-    private_class_method :CreateSemaphoreW, :OpenSemaphoreW, :ReleaseSemaphore
-
-    SEMAPHORE_ALL_ACCESS = 0x1F0003
-    INVALID_HANDLE_VALUE = FFI::Pointer.new(-1).address
-
-    public
-
-    # The version of the win32-semaphore library
-    VERSION = '0.4.2'
-
-    # The initial count for the semaphore object. This value must be greater
-    # than or equal to zero and less than or equal to +max_count+. The state
-    # of a semaphore is signaled when its count is greater than zero and
-    # nonsignaled when it is zero. The count is decreased by one whenever
-    # a wait function releases a thread that was waiting for the semaphore.
-    # The count is increased by a specified amount by calling
-    # Semaphore#release method.
-    #
-    attr_reader :initial_count
-
-    # The maximum count for the semaphore object. This value must be
-    # greater than zero.
-    #
-    attr_reader :max_count
-
-    # The name of the Semaphore object.
-    #
-    attr_reader :name
-
-    # Creates and returns new Semaphore object. If +name+ is omitted, the
-    # Semaphore object is created without a name, i.e. it's anonymous.
-    #
-    # If +name+ is provided and it already exists, then it is opened
-    # instead, and the +initial_count+ and +max_count+ parameters are
-    # ignored.
-    #
-    # The +initial_count+ and +max_count+ parameters set the initial count
-    # and maximum count for the Semaphore object, respectively. See the
-    # documentation for the corresponding accessor for more information.
-    #
-    # The +inherit+ attribute determines whether or not the semaphore can
-    # be inherited by child processes.
-    #
-    def initialize(initial_count, max_count, name=nil, inherit=true)
-      @initial_count = initial_count
-      @max_count = max_count
-      @name      = name
-      @inherit   = inherit
-
-      if name && name.encoding.to_s != 'UTF-16LE'
-        name = name + 0.chr
-        name.encode!('UTF-16LE')
-      end
-
-      if inherit
-        sec = SecurityAttributes.new
-        sec[:nLength] = SecurityAttributes.size
-        sec[:bInheritHandle] = true
-      else
-        sec = nil
-      end
-
-      handle = CreateSemaphoreW(sec, initial_count, max_count, name)
-
-      if handle == 0 || handle == INVALID_HANDLE_VALUE
-        raise SystemCallError.new("CreateSemaphore", FFI.errno)
-      end
-
-      super(handle)
-
-      if block_given?
-        begin
-          yield self
-        ensure
-          close
-        end
-      end
-    end
-
-    # Open an existing Semaphore by +name+. The +inherit+ argument sets
-    # whether or not the object was opened such that a process created by the
-    # CreateProcess() function (a Windows API function) can inherit the
-    # handle. The default is true.
-    #
-    # This method is essentially identical to Semaphore.new, except that the
-    # options for +initial_count+ and +max_count+ cannot be set (since they
-    # are already set). Also, this method will raise a Semaphore::Error if
-    # the semaphore doesn't already exist.
-    #
-    # If you want "open or create" semantics, then use Semaphore.new.
-    #
-    def self.open(name, inherit=true, &block)
-      if name && name.encoding.to_s != 'UTF-16LE'
-        name = name + 0.chr
-        name.encode!('UTF-16LE')
-      end
-
-      begin
-        # The OpenSemaphore() call here is strictly to force an error if the
-        # user tries to open a semaphore that doesn't already exist.
-        handle = OpenSemaphoreW(SEMAPHORE_ALL_ACCESS, inherit, name)
-
-        if handle == 0 || handle == INVALID_HANDLE_VALUE
-          raise SystemCallError.new("OpenSemaphore", FFI.errno)
-        end
-      ensure
-        CloseHandle(handle)
-      end
-
-      self.new(0, 1, name, inherit, &block)
-    end
-
-    # Increases the count of the specified semaphore object by +amount+.
-    # The default is 1. Returns the previous count of the semaphore if
-    # successful. If the +amount+ exceeds the +max_count+ specified when
-    # the semaphore was created then an error is raised.
-    #
-    def release(amount = 1)
-      pcount = FFI::MemoryPointer.new(:long)
-
-      # Ruby doesn't translate error 298, so we treat it as an EINVAL
-      unless ReleaseSemaphore(@handle, amount, pcount)
-        errno = FFI.errno
-        errno = 22 if errno == 298 # 22 is EINVAL
-        raise SystemCallError.new("ReleaseSemaphore", errno)
-      end
-
-      pcount.read_long
-    end
-
-    # Returns whether or not the object was opened such that a process
-    # created by the CreateProcess() function (a Windows API function) can
-    # inherit the handle. The default is true.
-    #
-    def inheritable?
-      @inherit
-    end
-  end
-end
+require 'win32/ipc'
+
+# The Win32 module serves as a namespace only.
+module Win32
+
+  # The Semaphore class encapsulates semaphore objects on Windows.
+  class Semaphore < Ipc
+    typedef :ulong, :dword
+    typedef :uintptr_t, :handle
+
+    ffi_lib :kernel32
+
+    private
+
+    class SecurityAttributes < FFI::Struct
+      layout(
+        :nLength, :dword,
+        :lpSecurityDescriptor, :pointer,
+        :bInheritHandle, :bool
+      )
+    end
+
+    attach_function :CreateSemaphoreW, [:pointer, :long, :long, :buffer_in], :handle
+    attach_function :OpenSemaphoreW, [:dword, :int, :buffer_in], :handle
+    attach_function :ReleaseSemaphore, [:handle, :long, :pointer], :bool
+
+    private_class_method :CreateSemaphoreW, :OpenSemaphoreW, :ReleaseSemaphore
+
+    SEMAPHORE_ALL_ACCESS = 0x1F0003
+    INVALID_HANDLE_VALUE = FFI::Pointer.new(-1).address
+
+    public
+
+    # The version of the win32-semaphore library
+    VERSION = '0.4.3'
+
+    # The initial count for the semaphore object. This value must be greater
+    # than or equal to zero and less than or equal to +max_count+. The state
+    # of a semaphore is signaled when its count is greater than zero and
+    # nonsignaled when it is zero. The count is decreased by one whenever
+    # a wait function releases a thread that was waiting for the semaphore.
+    # The count is increased by a specified amount by calling
+    # Semaphore#release method.
+    #
+    attr_reader :initial_count
+
+    # The maximum count for the semaphore object. This value must be
+    # greater than zero.
+    #
+    attr_reader :max_count
+
+    # The name of the Semaphore object.
+    #
+    attr_reader :name
+
+    # Creates and returns new Semaphore object. If +name+ is omitted, the
+    # Semaphore object is created without a name, i.e. it's anonymous.
+    #
+    # If +name+ is provided and it already exists, then it is opened
+    # instead, and the +initial_count+ and +max_count+ parameters are
+    # ignored.
+    #
+    # The +initial_count+ and +max_count+ parameters set the initial count
+    # and maximum count for the Semaphore object, respectively. See the
+    # documentation for the corresponding accessor for more information.
+    #
+    # The +inherit+ attribute determines whether or not the semaphore can
+    # be inherited by child processes.
+    #
+    def initialize(initial_count, max_count, name=nil, inherit=true)
+      @initial_count = initial_count
+      @max_count = max_count
+      @name      = name
+      @inherit   = inherit
+
+      if name && name.encoding.to_s != 'UTF-16LE'
+        name = name + 0.chr
+        name.encode!('UTF-16LE')
+      end
+
+      if inherit
+        sec = SecurityAttributes.new
+        sec[:nLength] = SecurityAttributes.size
+        sec[:bInheritHandle] = true
+      else
+        sec = nil
+      end
+
+      handle = CreateSemaphoreW(sec, initial_count, max_count, name)
+
+      if handle == 0 || handle == INVALID_HANDLE_VALUE
+        raise SystemCallError.new("CreateSemaphore", FFI.errno)
+      end
+
+      super(handle)
+
+      if block_given?
+        begin
+          yield self
+        ensure
+          close
+        end
+      end
+    end
+
+    # Open an existing Semaphore by +name+. The +inherit+ argument sets
+    # whether or not the object was opened such that a process created by the
+    # CreateProcess() function (a Windows API function) can inherit the
+    # handle. The default is true.
+    #
+    # This method is essentially identical to Semaphore.new, except that the
+    # options for +initial_count+ and +max_count+ cannot be set (since they
+    # are already set). Also, this method will raise a Semaphore::Error if
+    # the semaphore doesn't already exist.
+    #
+    # If you want "open or create" semantics, then use Semaphore.new.
+    #
+    def self.open(name, inherit=true, &block)
+      if name && name.encoding.to_s != 'UTF-16LE'
+        name = name + 0.chr
+        name.encode!('UTF-16LE')
+      end
+
+      inherit = inherit ? 1 : 0
+
+      begin
+        # The OpenSemaphore() call here is strictly to force an error if the
+        # user tries to open a semaphore that doesn't already exist.
+        handle = OpenSemaphoreW(SEMAPHORE_ALL_ACCESS, inherit, name)
+
+        if handle == 0 || handle == INVALID_HANDLE_VALUE
+          raise SystemCallError.new("OpenSemaphore", FFI.errno)
+        end
+      ensure
+        CloseHandle(handle)
+      end
+
+      self.new(0, 1, name, inherit, &block)
+    end
+
+    # Increases the count of the specified semaphore object by +amount+.
+    # The default is 1. Returns the previous count of the semaphore if
+    # successful. If the +amount+ exceeds the +max_count+ specified when
+    # the semaphore was created then an error is raised.
+    #
+    def release(amount = 1)
+      pcount = FFI::MemoryPointer.new(:long)
+
+      # Ruby doesn't translate error 298, so we treat it as an EINVAL
+      unless ReleaseSemaphore(@handle, amount, pcount)
+        errno = FFI.errno
+        errno = 22 if errno == 298 # 22 is EINVAL
+        raise SystemCallError.new("ReleaseSemaphore", errno)
+      end
+
+      pcount.read_long
+    end
+
+    # Returns whether or not the object was opened such that a process
+    # created by the CreateProcess() function (a Windows API function) can
+    # inherit the handle. The default is true.
+    #
+    def inheritable?
+      @inherit
+    end
+  end
+end

data/test/test_win32_semaphore.rb

@@ -1,126 +1,126 @@
-################################################################
-# test_win32_semaphore.rb
-#
-# Test suite for the win32-semaphore package. This test should
-# be run via the 'rake test' task.
-################################################################
-require 'win32/semaphore'
-require 'test-unit'
-include Win32
-
-class TC_Semaphore < Test::Unit::TestCase
-  def setup
-    @sem = Semaphore.new(1, 3, 'test')
-  end
-
-  test "version is set to expected value" do
-    assert_equal('0.4.2', Semaphore::VERSION)
-  end
-
-  test "initial_count basic functionality" do
-    assert_respond_to(@sem, :initial_count)
-  end
-
-  test "initial count is set to value passed to constructor" do
-    assert_equal(1, @sem.initial_count)
-  end
-
-  test "max_count basic functionality" do
-    assert_respond_to(@sem, :max_count)
-  end
-
-  test "max_count is set to value passed to constructor" do
-    assert_equal(3, @sem.max_count)
-  end
-
-  test "name method basic functionality" do
-    assert_respond_to(@sem, :name)
-  end
-
-  test "name returns value passed in constructor" do
-    assert_equal('test', @sem.name)
-  end
-
-  test "default name is nil" do
-    sem = Semaphore.new(0,1)
-    assert_nil(sem.name)
-    sem.close
-  end
-
-  test "inheritable? method is defined and true by default" do
-    assert_respond_to(@sem, :inheritable?)
-    assert_true(@sem.inheritable?)
-  end
-
-  test "inheritable? method returns value passed to constructor" do
-    sem = Semaphore.new(0,1,nil,false)
-    assert_false(sem.inheritable?)
-    sem.close
-  end
-
-  test "release method basic functionality" do
-    assert_respond_to(@sem, :release)
-    assert_kind_of(Fixnum, @sem.release)
-  end
-
-  test "release accepts an optional amount" do
-    assert_equal(1, @sem.release(1))
-  end
-
-  test "release returns the total number of releases" do
-    assert_equal(1, @sem.release(1))
-    assert_equal(2, @sem.release(1))
-  end
-
-  test "attempting to release more than the total count raises an error" do
-    assert_raise(Errno::EINVAL){ @sem.release(99) }
-  end
-
-  test "release only accepts one argument" do
-    assert_raise(ArgumentError){ @sem.release(1,2) }
-  end
-
-  test "open method basic functionality" do
-    assert_respond_to(Semaphore, :open)
-    assert_nothing_raised{ Semaphore.open('test'){} }
-  end
-
-  test "open method fails is semaphore name is invalid" do
-    assert_raise(Errno::ENOENT){ Semaphore.open('bogus'){} }
-  end
-
-  test "wait method was inherited" do
-    assert_respond_to(@sem, :wait)
-  end
-
-  test "wait_any method was inherited" do
-    assert_respond_to(@sem, :wait_any)
-  end
-
-  test "wait_all method was inherited" do
-    assert_respond_to(@sem, :wait_all)
-  end
-
-  test "first argument to constructor must be a number" do
-    assert_raise(TypeError){ Semaphore.new('foo', 1){} }
-  end
-
-  test "second argument to constructor must be a number" do
-    assert_raise(TypeError){ Semaphore.new(1, 'bar'){} }
-  end
-
-  test "constructor accepts a maximum of four arguments" do
-    assert_raise(ArgumentError){ Semaphore.new(1, 2, 'test', true, 1){} }
-  end
-
-  test "ffi functions are private" do
-    assert_not_respond_to(Semaphore, :CreateSemaphoreW)
-    assert_not_respond_to(Semaphore, :OpenSemaphoreW)
-    assert_not_respond_to(Semaphore, :ReleaseSemaphore)
-  end
-
-  def teardown
-    @sem.close if @sem
-    @sem = nil
-  end
-end
+################################################################
+# test_win32_semaphore.rb
+#
+# Test suite for the win32-semaphore package. This test should
+# be run via the 'rake test' task.
+################################################################
+require 'win32/semaphore'
+require 'test-unit'
+include Win32
+
+class TC_Semaphore < Test::Unit::TestCase
+  def setup
+    @sem = Semaphore.new(1, 3, 'test')
+  end
+
+  test "version is set to expected value" do
+    assert_equal('0.4.3', Semaphore::VERSION)
+  end
+
+  test "initial_count basic functionality" do
+    assert_respond_to(@sem, :initial_count)
+  end
+
+  test "initial count is set to value passed to constructor" do
+    assert_equal(1, @sem.initial_count)
+  end
+
+  test "max_count basic functionality" do
+    assert_respond_to(@sem, :max_count)
+  end
+
+  test "max_count is set to value passed to constructor" do
+    assert_equal(3, @sem.max_count)
+  end
+
+  test "name method basic functionality" do
+    assert_respond_to(@sem, :name)
+  end
+
+  test "name returns value passed in constructor" do
+    assert_equal('test', @sem.name)
+  end
+
+  test "default name is nil" do
+    sem = Semaphore.new(0,1)
+    assert_nil(sem.name)
+    sem.close
+  end
+
+  test "inheritable? method is defined and true by default" do
+    assert_respond_to(@sem, :inheritable?)
+    assert_true(@sem.inheritable?)
+  end
+
+  test "inheritable? method returns value passed to constructor" do
+    sem = Semaphore.new(0,1,nil,false)
+    assert_false(sem.inheritable?)
+    sem.close
+  end
+
+  test "release method basic functionality" do
+    assert_respond_to(@sem, :release)
+    assert_kind_of(Fixnum, @sem.release)
+  end
+
+  test "release accepts an optional amount" do
+    assert_equal(1, @sem.release(1))
+  end
+
+  test "release returns the total number of releases" do
+    assert_equal(1, @sem.release(1))
+    assert_equal(2, @sem.release(1))
+  end
+
+  test "attempting to release more than the total count raises an error" do
+    assert_raise(Errno::EINVAL){ @sem.release(99) }
+  end
+
+  test "release only accepts one argument" do
+    assert_raise(ArgumentError){ @sem.release(1,2) }
+  end
+
+  test "open method basic functionality" do
+    assert_respond_to(Semaphore, :open)
+    assert_nothing_raised{ Semaphore.open('test'){} }
+  end
+
+  test "open method fails is semaphore name is invalid" do
+    assert_raise(Errno::ENOENT){ Semaphore.open('bogus'){} }
+  end
+
+  test "wait method was inherited" do
+    assert_respond_to(@sem, :wait)
+  end
+
+  test "wait_any method was inherited" do
+    assert_respond_to(@sem, :wait_any)
+  end
+
+  test "wait_all method was inherited" do
+    assert_respond_to(@sem, :wait_all)
+  end
+
+  test "first argument to constructor must be a number" do
+    assert_raise(TypeError){ Semaphore.new('foo', 1){} }
+  end
+
+  test "second argument to constructor must be a number" do
+    assert_raise(TypeError){ Semaphore.new(1, 'bar'){} }
+  end
+
+  test "constructor accepts a maximum of four arguments" do
+    assert_raise(ArgumentError){ Semaphore.new(1, 2, 'test', true, 1){} }
+  end
+
+  test "ffi functions are private" do
+    assert_not_respond_to(Semaphore, :CreateSemaphoreW)
+    assert_not_respond_to(Semaphore, :OpenSemaphoreW)
+    assert_not_respond_to(Semaphore, :ReleaseSemaphore)
+  end
+
+  def teardown
+    @sem.close if @sem
+    @sem = nil
+  end
+end

data/win32-semaphore.gemspec

@@ -1,29 +1,29 @@
-require 'rubygems'
-
-Gem::Specification.new do |spec|
-  spec.name        = 'win32-semaphore'
-  spec.version     = '0.4.2'
-  spec.author      = 'Daniel J. Berger'
-  spec.license     = 'Artistic 2.0'
-  spec.email       = 'djberg96@gmail.com'
-  spec.homepage    = 'http://www.github.com/djberg96/win32-semaphore'
-  spec.summary     = 'Interface to MS Windows Semaphore objects.'
-  spec.test_file   = 'test/test_win32_semaphore.rb'
-  spec.files       = Dir['**/*'].reject{ |f| f.include?('git') }
-
-  spec.rubyforge_project = 'win32utils'
-  spec.extra_rdoc_files  = ['README', 'CHANGES', 'MANIFEST']
-  spec.required_ruby_version = '> 1.9.0'
-
-  spec.add_dependency('win32-ipc')
-
-  spec.add_development_dependency('rake')
-  spec.add_development_dependency('test-unit')
-
-  spec.description = <<-EOF
-    The win32-semaphore library provides an interface to semaphore objects
-    on MS Windows. A semaphore is a kernel object used for resource counting.
-    This allows threads to query the number of resources available, and wait
-    if there aren't any available.
-  EOF
-end
+require 'rubygems'
+
+Gem::Specification.new do |spec|
+  spec.name        = 'win32-semaphore'
+  spec.version     = '0.4.3'
+  spec.author      = 'Daniel J. Berger'
+  spec.license     = 'Artistic 2.0'
+  spec.email       = 'djberg96@gmail.com'
+  spec.homepage    = 'http://www.github.com/djberg96/win32-semaphore'
+  spec.summary     = 'Interface to MS Windows Semaphore objects.'
+  spec.test_file   = 'test/test_win32_semaphore.rb'
+  spec.files       = Dir['**/*'].reject{ |f| f.include?('git') }
+  spec.cert_chain  = Dir['certs/*']
+
+  spec.extra_rdoc_files  = ['README', 'CHANGES', 'MANIFEST']
+  spec.required_ruby_version = '> 1.9.0'
+
+  spec.add_dependency('win32-ipc')
+
+  spec.add_development_dependency('rake')
+  spec.add_development_dependency('test-unit')
+
+  spec.description = <<-EOF
+    The win32-semaphore library provides an interface to semaphore objects
+    on MS Windows. A semaphore is a kernel object used for resource counting.
+    This allows threads to query the number of resources available, and wait
+    if there aren't any available.
+  EOF
+end

metadata

@@ -1,55 +1,77 @@
 --- !ruby/object:Gem::Specification
 name: win32-semaphore
 version: !ruby/object:Gem::Version
-  version: 0.4.2
+  version: 0.4.3
 platform: ruby
 authors:
 - Daniel J. Berger
 autorequire: 
 bindir: bin
-cert_chain: []
-date: 2013-10-21 00:00:00.000000000 Z
+cert_chain:
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIDcDCCAligAwIBAgIBATANBgkqhkiG9w0BAQUFADA/MREwDwYDVQQDDAhkamJl
+  cmc5NjEVMBMGCgmSJomT8ixkARkWBWdtYWlsMRMwEQYKCZImiZPyLGQBGRYDY29t
+  MB4XDTE1MDkwMjIwNDkxOFoXDTE2MDkwMTIwNDkxOFowPzERMA8GA1UEAwwIZGpi
+  ZXJnOTYxFTATBgoJkiaJk/IsZAEZFgVnbWFpbDETMBEGCgmSJomT8ixkARkWA2Nv
+  bTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAMyTkvXqRp6hLs9eoJOS
+  Hmi8kRYbq9Vkf15/hMxJpotYMgJVHHWrmDcC5Dye2PbnXjTkKf266Zw0PtT9h+lI
+  S3ts9HO+vaCFSMwFFZmnWJSpQ3CNw2RcHxjWkk9yF7imEM8Kz9ojhiDXzBetdV6M
+  gr0lV/alUr7TNVBDngbXEfTWscyXh1qd7xZ4EcOdsDktCe5G45N/o3662tPQvJsi
+  FOF0CM/KuBsa/HL1/eoEmF4B3EKIRfTHrQ3hu20Kv3RJ88QM4ec2+0dd97uX693O
+  zv6981fyEg+aXLkxrkViM/tz2qR2ZE0jPhHTREPYeMEgptRkTmWSKAuLVWrJEfgl
+  DtkCAwEAAaN3MHUwCQYDVR0TBAIwADALBgNVHQ8EBAMCBLAwHQYDVR0OBBYEFEwe
+  nn6bfJADmuIDiMSOzedOrL+xMB0GA1UdEQQWMBSBEmRqYmVyZzk2QGdtYWlsLmNv
+  bTAdBgNVHRIEFjAUgRJkamJlcmc5NkBnbWFpbC5jb20wDQYJKoZIhvcNAQEFBQAD
+  ggEBAHmNOCWoDVD75zHFueY0viwGDVP1BNGFC+yXcb7u2GlK+nEMCORqzURbYPf7
+  tL+/hzmePIRz7i30UM//64GI1NLv9jl7nIwjhPpXpf7/lu2I9hOTsvwSumb5UiKC
+  /sqBxI3sfj9pr79Wpv4MuikX1XPik7Ncb7NPsJPw06Lvyc3Hkg5X2XpPtLtS+Gr2
+  wKJnmzb5rIPS1cmsqv0M9LPWflzfwoZ/SpnmhagP+g05p8bRNKjZSA2iImM/GyYZ
+  EJYzxdPOrx2n6NYR3Hk+vHP0U7UBSveI6+qx+ndQYaeyCn+GRX2PKS9h66YF/Q1V
+  tGSHgAmcLlkdGgan182qsE/4kKM=
+  -----END CERTIFICATE-----
+date: 2015-11-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: win32-ipc
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: test-unit
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 description: |2
@@ -65,12 +87,19 @@ extra_rdoc_files:
 - CHANGES
 - MANIFEST
 files:
+- certs
+- certs/djberg96_pub.pem
 - CHANGES
+- examples
 - examples/example_semaphore.rb
+- lib
+- lib/win32
 - lib/win32/semaphore.rb
+- lib/win32-semaphore.rb
 - MANIFEST
 - Rakefile
 - README
+- test
 - test/test_win32_semaphore.rb
 - win32-semaphore.gemspec
 homepage: http://www.github.com/djberg96/win32-semaphore
@@ -83,17 +112,17 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>'
+  - - ">"
     - !ruby/object:Gem::Version
       version: 1.9.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: win32utils
-rubygems_version: 2.1.9
+rubyforge_project: 
+rubygems_version: 2.4.8
 signing_key: 
 specification_version: 4
 summary: Interface to MS Windows Semaphore objects.