модуль Fiddle

Обёртка libffi для Ruby.

Описание

Fiddle является расширением для перевода интерфейса внешних функций (FFI) с ruby.

Он обёртку libffi, популярной C библиотеки, которая предоставляет портативный интерфейс, позволяющий коду, написанному на одном языке, вызывать код, написанный на другом языке.

Пример

Здесь мы будем использовать Fiddle::Function для обёртки floor(3) из libm

require 'fiddle'

libm = Fiddle.dlopen('/lib/libm.so.6')

floor = Fiddle::Function.new(
  libm['floor'],
  [Fiddle::TYPE_DOUBLE],
  Fiddle::TYPE_DOUBLE
)

puts floor.call(3.14159) #=> 3.0

Константы

ALIGN_CHAR

ALIGN_CHAR

Размер выравнивания char

ALIGN_DOUBLE

ALIGN_DOUBLE

Размер выравнивания double

ALIGN_FLOAT

ALIGN_FLOAT

Размер выравнивания float

ALIGN_INT

ALIGN_INT

Размер выравнивания int

ALIGN_INT16_T

ALIGN_INT16_T

Размер выравнивания int16_t

ALIGN_INT32_T

ALIGN_INT32_T

Размер выравнивания int32_t

ALIGN_INT64_T

ALIGN_INT64_T

Размер выравнивания int64_t

ALIGN_INT8_T

ALIGN_INT8_T

Размер выравнивания int8_t

ALIGN_INTPTR_T

ALIGN_INTPTR_T

Размер выравнивания intptr_t

ALIGN_LONG

ALIGN_LONG

Размер выравнивания long

ALIGN_LONG_LONG

ALIGN_LONG_LONG

Размер выравнивания long long

ALIGN_PTRDIFF_T

ALIGN_PTRDIFF_T

Размер выравнивания ptrdiff_t

ALIGN_SHORT

ALIGN_SHORT

Размер выравнивания short

ALIGN_SIZE_T

ALIGN_SIZE_T

Размер выравнивания size_t

ALIGN_SSIZE_T

ALIGN_SSIZE_T

Размер выравнивания ssize_t

ALIGN_UINTPTR_T

ALIGN_UINTPTR_T

Размер выравнивания uintptr_t

ALIGN_VOIDP

ALIGN_VOIDP

Размер выравнивания void*

BUILD_RUBY_PLATFORM

BUILD_RUBY_PLATFORM

Платформа, на которой был собран (например, «x86_64-linux» и т. д.)

См. также RUBY_PLATFORM

Qfalse

Qfalse

Значение Qfalse

Qnil

Qnil

Значение Qnil

Qtrue

Qtrue

Значение Qtrue

Qundef

Qundef

Значение Qundef

RUBY_FREE

RUBY_FREE

Адрес функции ruby_xfree()

SIZEOF_CHAR

SIZEOF_CHAR

размер char

SIZEOF_CONST_STRING

SIZEOF_CONST_STRING

размер const char*

SIZEOF_DOUBLE

SIZEOF_DOUBLE

размер double

SIZEOF_FLOAT

SIZEOF_FLOAT

размер float

SIZEOF_INT

SIZEOF_INT

размер int

SIZEOF_INT16_T

SIZEOF_INT16_T

размер int16_t

SIZEOF_INT32_T

SIZEOF_INT32_T

размер int32_t

SIZEOF_INT64_T

SIZEOF_INT64_T

размер int64_t

SIZEOF_INT8_T

SIZEOF_INT8_T

размер int8_t

SIZEOF_INTPTR_T

SIZEOF_INTPTR_T

размер intptr_t

SIZEOF_LONG

SIZEOF_LONG

размер long

SIZEOF_LONG_LONG

SIZEOF_LONG_LONG

размер long long

SIZEOF_PTRDIFF_T

SIZEOF_PTRDIFF_T

размер ptrdiff_t

SIZEOF_SHORT

SIZEOF_SHORT

размер short

SIZEOF_SIZE_T

SIZEOF_SIZE_T

размер size_t

SIZEOF_SSIZE_T

SIZEOF_SSIZE_T

размер ssize_t

SIZEOF_UCHAR

SIZEOF_UCHAR

размер unsigned char

SIZEOF_UINT

SIZEOF_UINT

размер unsigned int

SIZEOF_UINT16_T

SIZEOF_UINT16_T

размер uint16_t

SIZEOF_UINT32_T

SIZEOF_UINT32_T

размер uint32_t

SIZEOF_UINT64_T

SIZEOF_UINT64_T

размер uint64_t

SIZEOF_UINT8_T

SIZEOF_UINT8_T

размер uint8_t

SIZEOF_UINTPTR_T

SIZEOF_UINTPTR_T

размер uintptr_t

SIZEOF_ULONG

SIZEOF_ULONG

размер unsigned long

SIZEOF_ULONG_LONG

SIZEOF_ULONG_LONG

размер unsigned long long

SIZEOF_USHORT

SIZEOF_USHORT

размер unsigned short

SIZEOF_VOIDP

SIZEOF_VOIDP

размер void*

VERSION

WINDOWS

Возвращает булево значение, показывающее, является ли хост WIN32

END_OF_DOCUMENT_MARKER

Публичные методы класса

dlopen(library) → Fiddle::Handle Show source

# File ext/fiddle/lib/fiddle.rb, line 60
def dlopen library
  begin
    Fiddle::Handle.new(library)
  rescue DLError => error
    case RUBY_PLATFORM
    when /linux/
      case error.message
      when /\A(\/.+?): (?:invalid ELF header|file too short)/
        # This may be a linker script:
        # https://sourceware.org/binutils/docs/ld.html#Scripts
        path = $1
      else
        raise
      end
    else
      raise
    end

    File.open(path) do |input|
      input.each_line do |line|
        case line
        when /\A\s*(?:INPUT|GROUP)\s*\(\s*([^\s,\)]+)/
          # TODO: Should we support multiple files?
          return dlopen($1)
        end
      end
    end

    # Not found
    raise
  end
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 для подробностей.

dlunwrap(addr) Show source

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"

dlwrap(val) Show source

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

free(addr) Show source

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

    ruby_xfree(ptr);
    return Qnil;
}

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

last_error() Show source

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

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

last_error=(error) Show source

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

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

malloc(size) Show source

static VALUE
rb_fiddle_malloc(VALUE self, VALUE size)
{
    void *ptr;
    ptr = (void*)ruby_xcalloc(1, NUM2SIZET(size));
    return PTR2NUM(ptr);
}

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

realloc(addr, size) Show source

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 байт. Возвращает адрес памяти перераспределенной памяти, который может отличаться от переданного адреса.

win32_last_error() Show source

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

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

win32_last_error=(error) Show source

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

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

win32_last_socket_error() Show source

# File ext/fiddle/lib/fiddle.rb, line 23
def self.win32_last_socket_error
  Thread.current[:__FIDDLE_WIN32_LAST_SOCKET_ERROR__]
end

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

win32_last_socket_error=(error) Show source

# File ext/fiddle/lib/fiddle.rb, line 29
def self.win32_last_socket_error= error
  Thread.current[:__FIDDLE_WIN32_LAST_SOCKET_ERROR__] = error
end

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

Приватные методы экземпляра

dlopen(library) → Fiddle::Handle Show source

# File ext/fiddle/lib/fiddle.rb, line 60
def dlopen library
  begin
    Fiddle::Handle.new(library)
  rescue DLError => error
    case RUBY_PLATFORM
    when /linux/
      case error.message
      when /\A(\/.+?): (?:invalid ELF header|file too short)/
        # This may be a linker script:
        # https://sourceware.org/binutils/docs/ld.html#Scripts
        path = $1
      else
        raise
      end
    else
      raise
    end

    File.open(path) do |input|
      input.each_line do |line|
        case line
        when /\A\s*(?:INPUT|GROUP)\s*\(\s*([^\s,\)]+)/
          # TODO: Should we support multiple files?
          return dlopen($1)
        end
      end
    end

    # Not found
    raise
  end
end

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

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

lib = Fiddle.dlopen(nil)

См. Fiddle::Handle.new для подробностей.

Ruby Core © 1993–2022 Yukihiro Matsumoto
Licensed under the Ruby License.
Ruby Standard Library © contributors
Licensed under their own licenses.