module DL
A bridge to the dlopen() or dynamic library linker function.
Example¶ ↑
bash $> cat > sum.c <<EOF double sum(double *arry, int len) { double ret = 0; int i; for(i = 0; i < len; i++){ ret = ret + arry[i]; } return ret; } double split(double num) { double ret = 0; ret = num / 2; return ret; } EOF bash $> gcc -o libsum.so -shared sum.c bash $> cat > sum.rb <<EOF require 'dl' require 'dl/import' module LibSum extend DL::Importer dlload './libsum.so' extern 'double sum(double*, int)' extern 'double split(double)' end a = [2.0, 3.0, 4.0] sum = LibSum.sum(a.pack("d*"), a.count) p LibSum.split(sum) EOF bash $> ruby sum.rb 4.5
WIN! :-)
Constants
- ALIGN_CHAR
-
The alignment size of a char
- ALIGN_DOUBLE
-
The alignment size of a double
- ALIGN_FLOAT
-
The alignment size of a float
- ALIGN_INT
-
The alignment size of an int
- ALIGN_INTPTR_T
-
The alignment size of a intptr_t
- ALIGN_LONG
-
The alignment size of a long
- ALIGN_LONG_LONG
-
The alignment size of a long long
- ALIGN_PTRDIFF_T
-
The alignment size of a ptrdiff_t
- ALIGN_SHORT
-
The alignment size of a short
- ALIGN_SIZE_T
-
The alignment size of a size_t
- ALIGN_SSIZE_T
-
The alignment size of a ssize_t
- ALIGN_UINTPTR_T
-
The alignment size of a uintptr_t
- ALIGN_VOIDP
-
The alignment size of a void*
- BUILD_RUBY_PLATFORM
-
Platform built against (i.e. “x86_64-linux”, etc.)
See also RUBY_PLATFORM
- BUILD_RUBY_VERSION
-
Ruby Version built. (i.e. “1.9.3”)
See also RUBY_VERSION
- DLSTACK_SIZE
-
Dynamic linker stack size
- MAX_CALLBACK
-
Maximum number of callbacks
- RTLD_GLOBAL
-
rtld DL::Handle flag.
The symbols defined by this library will be made available for symbol resolution of subsequently loaded libraries.
- RTLD_LAZY
-
rtld DL::Handle flag.
Perform lazy binding. Only resolve symbols as the code that references them is executed. If the symbol is never referenced, then it is never resolved. (Lazy binding is only performed for function references; references to variables are always immediately bound when the library is loaded.)
- RTLD_NOW
-
rtld DL::Handle flag.
If this value is specified or the environment variable LD_BIND_NOW is set to a nonempty string, all undefined symbols in the library are resolved before dlopen() returns. If this cannot be done an error is returned.
- RUBY_FREE
-
Address of the ruby_xfree() function
- SIZEOF_CHAR
-
size of a char
- SIZEOF_DOUBLE
-
size of a double
- SIZEOF_FLOAT
-
size of a float
- SIZEOF_INT
-
size of an int
- SIZEOF_INTPTR_T
-
size of a intptr_t
- SIZEOF_LONG
-
size of a long
- SIZEOF_LONG_LONG
-
size of a long long
- SIZEOF_PTRDIFF_T
-
size of a ptrdiff_t
- SIZEOF_SHORT
-
size of a short
- SIZEOF_SIZE_T
-
size of a size_t
- SIZEOF_SSIZE_T
-
size of a ssize_t
- SIZEOF_UINTPTR_T
-
size of a uintptr_t
- SIZEOF_VOIDP
-
size of a void*
- TYPE_CHAR
-
DL::CFunc type - char
- TYPE_DOUBLE
-
DL::CFunc type - double
- TYPE_FLOAT
-
DL::CFunc type - float
- TYPE_INT
-
DL::CFunc type - int
- TYPE_INTPTR_T
-
DL::CFunc type - intptr_t
- TYPE_LONG
-
DL::CFunc type - long
- TYPE_LONG_LONG
-
DL::CFunc type - long long
- TYPE_PTRDIFF_T
-
DL::CFunc type - ptrdiff_t
- TYPE_SHORT
-
DL::CFunc type - short
- TYPE_SIZE_T
-
DL::CFunc type - size_t
- TYPE_SSIZE_T
-
DL::CFunc type - ssize_t
- TYPE_UINTPTR_T
-
DL::CFunc type - uintptr_t
- TYPE_VOID
-
DL::CFunc type - void
- TYPE_VOIDP
-
DL::CFunc type - void*
Public Class Methods
An interface to the dynamic linking loader
This is a shortcut to DL::Handle.new and takes the same arguments.
Example:
libc_so = "/lib64/libc.so.6" => "/lib64/libc.so.6" libc = DL.dlopen(libc_so) => #<DL::Handle:0x00000000e05b00>
VALUE rb_dl_dlopen(int argc, VALUE argv[], VALUE self) { return rb_class_new_instance(argc, argv, rb_cDLHandle); }
Returns the hexadecimal representation of a memory pointer address
addr
Example:
lib = DL.dlopen('/lib64/libc-2.15.so') => #<DL::Handle:0x00000001342460> lib['strcpy'].to_s(16) => "7f59de6dd240" DL.dlunwrap(DL.dlwrap(lib['strcpy'].to_s(16))) => "7f59de6dd240"
VALUE rb_dl_ptr2value(VALUE self, VALUE addr) { return (VALUE)NUM2PTR(addr); }
Returns a memory pointer of a function's hexadecimal address location
val
Example:
lib = DL.dlopen('/lib64/libc-2.15.so') => #<DL::Handle:0x00000001342460> DL.dlwrap(lib['strcpy'].to_s(16)) => 25522520
VALUE rb_dl_value2ptr(VALUE self, VALUE val) { return PTR2NUM((void*)val); }
Free the memory at address addr
VALUE rb_dl_free(VALUE self, VALUE addr) { void *ptr = NUM2PTR(addr); ruby_xfree(ptr); return Qnil; }
Allocate size
bytes of memory and return the integer memory
address for the allocated memory.
VALUE rb_dl_malloc(VALUE self, VALUE size) { void *ptr; ptr = (void*)ruby_xmalloc(NUM2INT(size)); return PTR2NUM(ptr); }
Change the size of the memory allocated at the memory location
addr
to size
bytes. Returns the memory address
of the reallocated memory, which may be different than the address passed
in.
VALUE rb_dl_realloc(VALUE self, VALUE addr, VALUE size) { void *ptr = NUM2PTR(addr); ptr = (void*)ruby_xrealloc(ptr, NUM2INT(size)); return PTR2NUM(ptr); }
Public Instance Methods
# File ext/dl/lib/dl/callback.rb, line 70 def remove_callback_internal(proc_entry, addr_entry, addr, ctype = nil) if DL.fiddle? addr = addr.to_i return false unless proc_entry.key?(addr) proc_entry.delete(addr) true else index = nil if( ctype ) addr_entry[ctype].each_with_index{|xaddr, idx| if( xaddr == addr ) index = idx end } else addr_entry.each{|ty,entry| entry.each_with_index{|xaddr, idx| if( xaddr == addr ) index = idx end } } end if( index and proc_entry[ctype][index] ) proc_entry[ctype][index] = nil return true else return false end end end
# File ext/dl/lib/dl/callback.rb, line 102 def remove_cdecl_callback(addr, ctype = nil) remove_callback_internal(CdeclCallbackProcs, CdeclCallbackAddrs, addr, ctype) end
# File ext/dl/lib/dl/callback.rb, line 106 def remove_stdcall_callback(addr, ctype = nil) remove_callback_internal(StdcallCallbackProcs, StdcallCallbackAddrs, addr, ctype) end
# File ext/dl/lib/dl/callback.rb, line 30 def set_callback_internal(proc_entry, addr_entry, argc, ty, abi = nil, &cbp) if( argc < 0 ) raise(ArgumentError, "arity should not be less than 0.") end addr = nil if DL.fiddle? abi ||= Fiddle::Function::DEFAULT closure = Fiddle::Closure::BlockCaller.new(ty, [TYPE_VOIDP] * argc, abi, &cbp) proc_entry[closure.to_i] = closure addr = closure.to_i else SEM.synchronize{ ary = proc_entry[ty] (0...MAX_CALLBACK).each{|n| idx = (n * DLSTACK_SIZE) + argc if( ary[idx].nil? ) ary[idx] = cbp addr = addr_entry[ty][idx] break end } } end addr end
# File ext/dl/lib/dl/callback.rb, line 58 def set_cdecl_callback(ty, argc, &cbp) set_callback_internal(CdeclCallbackProcs, CdeclCallbackAddrs, argc, ty, &cbp) end
# File ext/dl/lib/dl/callback.rb, line 62 def set_stdcall_callback(ty, argc, &cbp) if DL.fiddle? set_callback_internal(StdcallCallbackProcs, StdcallCallbackAddrs, argc, ty, Fiddle::Function::STDCALL, &cbp) else set_callback_internal(StdcallCallbackProcs, StdcallCallbackAddrs, argc, ty, &cbp) end end