модуль Fiddle

# File ext/fiddle/lib/fiddle.rb, line 46
def dlopen library
  Fiddle::Handle.new library
end

Создаёт новый обработчик, открывающий library, и возвращает экземпляр Fiddle::Handle.

Если nil указано для library, используется Fiddle::Handle::DEFAULT, что эквивалентно RTLD_DEFAULT. См. man 3 dlopen для получения дополнительной информации.

lib = Fiddle.dlopen(nil)

По умолчанию зависит от ОС и предоставляет обработчик для всех уже загруженных библиотек. Например, в большинстве случаев это можно использовать для доступа к libc функциям или функциям Ruby, таким как rb_str_new.

См. Fiddle::Handle.new для получения дополнительной информации.

VALUE
rb_fiddle_ptr2value(VALUE self, VALUE addr)
{
    return (VALUE)NUM2PTR(addr);
}

Возвращает шестнадцатеричное представление адреса указателя памяти addr.

Пример:

lib = Fiddle.dlopen('/lib64/libc-2.15.so')
=> #<Fiddle::Handle:0x00000001342460>

lib['strcpy'].to_s(16)
=> "7f59de6dd240"

Fiddle.dlunwrap(Fiddle.dlwrap(lib['strcpy'].to_s(16)))
=> "7f59de6dd240"

static VALUE
rb_fiddle_value2ptr(VALUE self, VALUE val)
{
    return PTR2NUM((void*)val);
}

Возвращает указатель памяти на адрес функции в шестнадцатеричном формате val.

Пример:

lib = Fiddle.dlopen('/lib64/libc-2.15.so')
=> #<Fiddle::Handle:0x00000001342460>

Fiddle.dlwrap(lib['strcpy'].to_s(16))
=> 25522520

VALUE
rb_fiddle_free(VALUE self, VALUE addr)
{
    void *ptr = NUM2PTR(addr);

    ruby_xfree(ptr);
    return Qnil;
}

Освобождает память по адресу addr.

# File ext/fiddle/lib/fiddle.rb, line 21
def self.last_error
  Thread.current[:__FIDDLE_LAST_ERROR__]
end

Возвращает последнюю Error текущего выполняемого Thread или nil, если нет.

# File ext/fiddle/lib/fiddle.rb, line 26
def self.last_error= error
  Thread.current[:__DL2_LAST_ERROR__] = error
  Thread.current[:__FIDDLE_LAST_ERROR__] = error
end

Устанавливает последнюю Error текущего выполняемого Thread на error.

static VALUE
rb_fiddle_malloc(VALUE self, VALUE size)
{
    void *ptr;

    ptr = (void*)ruby_xmalloc(NUM2SIZET(size));
    return PTR2NUM(ptr);
}

Выделяет size байта памяти и возвращает целочисленный адрес выделенной памяти.

static VALUE
rb_fiddle_realloc(VALUE self, VALUE addr, VALUE size)
{
    void *ptr = NUM2PTR(addr);

    ptr = (void*)ruby_xrealloc(ptr, NUM2SIZET(size));
    return PTR2NUM(ptr);
}

Изменяет размер памяти, выделенной по адресу addr, на size байт. Возвращает адрес перевыделенной памяти, который может отличаться от переданного адреса.

# File ext/fiddle/lib/fiddle.rb, line 10
def self.win32_last_error
  Thread.current[:__FIDDLE_WIN32_LAST_ERROR__]
end

Возвращает последнюю win32 Error текущего выполняемого Thread или nil, если нет.

# File ext/fiddle/lib/fiddle.rb, line 15
def self.win32_last_error= error
  Thread.current[:__FIDDLE_WIN32_LAST_ERROR__] = error
end

Устанавливает последнюю win32 Error текущего выполняемого Thread на error.

# File ext/fiddle/lib/fiddle.rb, line 46
def dlopen library
  Fiddle::Handle.new library
end

Создаёт новый обработчик, который открывает library, и возвращает экземпляр Fiddle::Handle.

Если nil задано для library, используется Fiddle::Handle::DEFAULT, что эквивалентно RTLD_DEFAULT. Смотрите man 3 dlopen для более подробной информации.

lib = Fiddle.dlopen(nil)

Значение по умолчанию зависит от ОС и предоставляет обработчик для всех уже загруженных библиотек. Например, в большинстве случаев это позволяет получить доступ к libc функциям или к рубиевским функциям, таким как rb_str_new.

См. Fiddle::Handle.new для более подробной информации.