From 307388ea19f5c9d1c8c417d1979c40d970b420a2 Mon Sep 17 00:00:00 2001 From: Aaron Patterson Date: Sun, 2 Aug 2020 14:26:40 -0700 Subject: [ruby/fiddle] Add a "pinning" reference (#44) * Add a "pinning" reference A `Fiddle::Pinned` objects will prevent the objects they point to from moving. This is useful in the case where you need to pass a reference to a C extension that keeps the address in a global and needs the address to be stable. For example: ```ruby class Foo A = "hi" # this is an embedded string some_c_function A # A might move! end ``` If `A` moves, then the underlying string buffer may also move. `Fiddle::Pinned` will prevent the object from moving: ```ruby class Foo A = "hi" # this is an embedded string A_pinner = Fiddle::Pinned.new(A) # :nodoc: some_c_function A # A can't move because of `Fiddle::Pinned` end ``` This is a similar strategy to what Graal uses: https://www.graalvm.org/sdk/javadoc/org/graalvm/nativeimage/PinnedObject.html#getObject-- * rename global to match exception name * Introduce generic Fiddle::Error and rearrange error classes Fiddle::Error is the generic exception base class for Fiddle exceptions. This commit introduces the class and rearranges Fiddle exceptions to inherit from it. https://github.com/ruby/fiddle/commit/ac52d00223 --- ext/fiddle/fiddle.gemspec | 1 + 1 file changed, 1 insertion(+) (limited to 'ext/fiddle/fiddle.gemspec') diff --git a/ext/fiddle/fiddle.gemspec b/ext/fiddle/fiddle.gemspec index a92955ccec..850b12d0b8 100644 --- a/ext/fiddle/fiddle.gemspec +++ b/ext/fiddle/fiddle.gemspec @@ -39,6 +39,7 @@ Gem::Specification.new do |spec| "ext/fiddle/function.c", "ext/fiddle/function.h", "ext/fiddle/handle.c", + "ext/fiddle/pinned.c", "ext/fiddle/pointer.c", "ext/fiddle/win32/fficonfig.h", "ext/fiddle/win32/libffi-3.2.1-mswin.patch", -- cgit v1.2.3