lldb 0.1.0 → 0.3.0

data/lib/lldb/target.rb

@@ -4,19 +4,24 @@
 
 module LLDB
   class Target
+    prepend NativeLifecycle
+
     # @rbs return: Debugger
     attr_reader :debugger
 
     # @rbs ptr: FFI::Pointer
     # @rbs debugger: Debugger
     # @rbs return: void
-    def initialize(ptr, debugger:)
-      @ptr = ptr # : FFI::Pointer
+    def initialize(ptr, debugger:, context: debugger.context)
       @debugger = debugger
       @breakpoints = [] # : Array[Breakpoint]
       @watchpoints = [] # : Array[Watchpoint]
       @process = nil # : Process?
-      ObjectSpace.define_finalizer(self, self.class.release(@ptr))
+      initialize_native_object(
+        ptr,
+        release: ->(released) { FFIBindings.lldb_target_destroy(released) },
+        context: context
+      )
     end
 
     # @rbs ptr: FFI::Pointer
@@ -33,38 +38,16 @@ module LLDB
     # @rbs args: Array[String]?
     # @rbs env: Hash[String, String]?
     # @rbs working_dir: String?
+    # @rbs launch_flags: Integer?
     # @rbs return: Process
-    def launch(args: nil, env: nil, working_dir: nil)
+    def launch(args: nil, env: nil, working_dir: nil, launch_flags: nil)
       raise InvalidObjectError, 'Target is not valid' unless valid?
 
-      # Use LaunchInfo with STOP_AT_ENTRY flag for reliable cross-platform behavior
-      launch_info = LaunchInfo.new(args)
-      launch_info.launch_flags = LaunchFlags::STOP_AT_ENTRY
+      launch_info = LaunchInfo.new(args, context: context)
+      launch_info.launch_flags = launch_flags unless launch_flags.nil?
       launch_info.working_directory = working_dir if working_dir
       launch_info.set_environment(env) if env
-
-      error = Error.new
-      process_ptr = FFIBindings.lldb_target_launch(@ptr, launch_info.to_ptr, error.to_ptr)
-
-      error.raise_if_error!
-      raise LaunchError, 'Failed to launch process' if process_ptr.nil? || process_ptr.null?
-
-      @process = Process.new(process_ptr, target: self)
-
-      # Wait for process to stop when in synchronous mode
-      # On some platforms (Linux), the process may not be immediately stopped
-      unless @debugger.async?
-        wait_for_process_stop(@process)
-
-        # STOP_AT_ENTRY stops at the program entry point, not at breakpoints.
-        # If there are breakpoints set, continue to let the process run to the first breakpoint.
-        if num_breakpoints > 0 && @process.state == State::STOPPED && @process.valid?
-          @process.continue
-          wait_for_process_stop(@process)
-        end
-      end
-
-      @process
+      launch_with_info(launch_info)
     end
 
     # @rbs launch_info: LaunchInfo
@@ -76,10 +59,10 @@ module LLDB
       error = Error.new
       process_ptr = FFIBindings.lldb_target_launch(@ptr, launch_info.to_ptr, error.to_ptr)
 
-      error.raise_if_error!
+      error.raise_if_error!('target.launch')
       raise LaunchError, 'Failed to launch process' if process_ptr.nil? || process_ptr.null?
 
-      @process = Process.new(process_ptr, target: self)
+      @process = Process.new(process_ptr, target: self, context: context)
     end
 
     # @rbs pid: Integer
@@ -93,7 +76,22 @@ module LLDB
       error.raise_if_error!
       raise AttachError, "Failed to attach to process #{pid}" if process_ptr.nil? || process_ptr.null?
 
-      @process = Process.new(process_ptr, target: self)
+      @process = Process.new(process_ptr, target: self, context: context)
+    end
+
+    # @rbs attach_info: AttachInfo
+    # @rbs return: Process
+    def attach_with_info(attach_info)
+      raise InvalidObjectError, 'Target is not valid' unless valid?
+      raise ArgumentError, 'attach_info is required' unless attach_info.is_a?(AttachInfo)
+
+      error = Error.new
+      process_ptr = FFIBindings.lldb_target_attach_with_info(@ptr, attach_info.to_ptr, error.to_ptr)
+
+      error.raise_if_error!('target.attach')
+      raise AttachError, 'Failed to attach using attach info' if process_ptr.nil? || process_ptr.null?
+
+      @process = Process.new(process_ptr, target: self, context: context)
     end
 
     # @rbs symbol_name: String
@@ -105,7 +103,7 @@ module LLDB
       bp_ptr = FFIBindings.lldb_target_breakpoint_create_by_name(@ptr, symbol_name, module_name)
       raise BreakpointError, "Failed to create breakpoint for '#{symbol_name}'" if bp_ptr.nil? || bp_ptr.null?
 
-      bp = Breakpoint.new(bp_ptr, target: self)
+      bp = Breakpoint.new(bp_ptr, target: self, context: context)
       @breakpoints << bp
       bp
     end
@@ -119,7 +117,7 @@ module LLDB
       bp_ptr = FFIBindings.lldb_target_breakpoint_create_by_location(@ptr, file, line)
       raise BreakpointError, "Failed to create breakpoint at #{file}:#{line}" if bp_ptr.nil? || bp_ptr.null?
 
-      bp = Breakpoint.new(bp_ptr, target: self)
+      bp = Breakpoint.new(bp_ptr, target: self, context: context)
       @breakpoints << bp
       bp
     end
@@ -128,6 +126,8 @@ module LLDB
     # @rbs return: Breakpoint
     def breakpoint_create_by_address(address)
       raise InvalidObjectError, 'Target is not valid' unless valid?
+      APISupport.require_method!(:lldb_target_breakpoint_create_by_address,
+                                 'breakpoint_create_by_address')
 
       bp_ptr = FFIBindings.lldb_target_breakpoint_create_by_address(@ptr, address)
       if bp_ptr.nil? || bp_ptr.null?
@@ -135,7 +135,7 @@ module LLDB
               "Failed to create breakpoint at address 0x#{address.to_s(16)}"
       end
 
-      bp = Breakpoint.new(bp_ptr, target: self)
+      bp = Breakpoint.new(bp_ptr, target: self, context: context)
       @breakpoints << bp
       bp
     end
@@ -158,7 +158,7 @@ module LLDB
       bp_ptr = FFIBindings.lldb_target_find_breakpoint_by_id(@ptr, id)
       return nil if bp_ptr.nil? || bp_ptr.null?
 
-      Breakpoint.new(bp_ptr, target: self)
+      Breakpoint.new(bp_ptr, target: self, context: context)
     end
 
     # @rbs return: Integer
@@ -176,7 +176,7 @@ module LLDB
       bp_ptr = FFIBindings.lldb_target_get_breakpoint_at_index(@ptr, index)
       return nil if bp_ptr.nil? || bp_ptr.null?
 
-      Breakpoint.new(bp_ptr, target: self)
+      Breakpoint.new(bp_ptr, target: self, context: context)
     end
 
     # @rbs return: Array[Breakpoint]
@@ -191,14 +191,24 @@ module LLDB
       process_ptr = FFIBindings.lldb_target_get_process(@ptr)
       return nil if process_ptr.nil? || process_ptr.null?
 
-      Process.new(process_ptr, target: self)
+      Process.new(process_ptr, target: self, context: context)
     end
 
     # @rbs return: String?
     def executable_path
       raise InvalidObjectError, 'Target is not valid' unless valid?
 
-      FFIBindings.lldb_target_get_executable_path(@ptr)
+      executable_file&.path
+    end
+
+    # @rbs return: FileSpec?
+    def executable_file
+      raise InvalidObjectError, 'Target is not valid' unless valid?
+
+      file_ptr = FFIBindings.lldb_target_get_executable_file(@ptr)
+      return nil if file_ptr.nil? || file_ptr.null?
+
+      FileSpec.from_ptr(file_ptr, context: context)
     end
 
     # @rbs return: Integer
@@ -216,7 +226,7 @@ module LLDB
       mod_ptr = FFIBindings.lldb_target_get_module_at_index(@ptr, index)
       return nil if mod_ptr.nil? || mod_ptr.null?
 
-      Module.new(mod_ptr, target: self)
+      Module.new(mod_ptr, target: self, context: context)
     end
 
     # @rbs return: Array[Module]
@@ -236,7 +246,7 @@ module LLDB
       error.raise_if_error!
       raise AttachError, "Failed to attach to process '#{name}'" if process_ptr.nil? || process_ptr.null?
 
-      @process = Process.new(process_ptr, target: self)
+      @process = Process.new(process_ptr, target: self, context: context)
     end
 
     # @rbs regex: String
@@ -244,11 +254,13 @@ module LLDB
     # @rbs return: Breakpoint
     def breakpoint_create_by_regex(regex, module_name: nil)
       raise InvalidObjectError, 'Target is not valid' unless valid?
+      APISupport.require_method!(:lldb_target_breakpoint_create_by_regex,
+                                 'breakpoint_create_by_regex')
 
       bp_ptr = FFIBindings.lldb_target_breakpoint_create_by_regex(@ptr, regex, module_name)
       raise BreakpointError, "Failed to create breakpoint for regex '#{regex}'" if bp_ptr.nil? || bp_ptr.null?
 
-      bp = Breakpoint.new(bp_ptr, target: self)
+      bp = Breakpoint.new(bp_ptr, target: self, context: context)
       @breakpoints << bp
       bp
     end
@@ -262,7 +274,7 @@ module LLDB
       bp_ptr = FFIBindings.lldb_target_breakpoint_create_by_source_regex(@ptr, regex, source_file)
       raise BreakpointError, "Failed to create breakpoint for source regex '#{regex}'" if bp_ptr.nil? || bp_ptr.null?
 
-      bp = Breakpoint.new(bp_ptr, target: self)
+      bp = Breakpoint.new(bp_ptr, target: self, context: context)
       @breakpoints << bp
       bp
     end
@@ -291,14 +303,25 @@ module LLDB
     end
 
     # @rbs expression: String
+    # @rbs options: ExpressionOptions?
     # @rbs return: Value?
-    def evaluate_expression(expression)
+    def evaluate_expression(expression, options: nil)
       raise InvalidObjectError, 'Target is not valid' unless valid?
 
-      value_ptr = FFIBindings.lldb_target_evaluate_expression(@ptr, expression)
+      value_ptr = if options
+                    unless options.is_a?(ExpressionOptions)
+                      raise ArgumentError, 'options must be an ExpressionOptions'
+                    end
+
+                    FFIBindings.lldb_target_evaluate_expression_with_options(
+                      @ptr, expression, options.to_ptr
+                    )
+                  else
+                    FFIBindings.lldb_target_evaluate_expression(@ptr, expression)
+                  end
       return nil if value_ptr.nil? || value_ptr.null?
 
-      Value.new(value_ptr, parent: self)
+      Value.new(value_ptr, parent: self, context: context)
     end
 
     # @rbs address: Integer
@@ -343,7 +366,7 @@ module LLDB
       error.raise_if_error!
       raise LLDBError, "Failed to create watchpoint at address 0x#{address.to_s(16)}" if wp_ptr.nil? || wp_ptr.null?
 
-      wp = Watchpoint.new(wp_ptr, target: self)
+      wp = Watchpoint.new(wp_ptr, target: self, context: context)
       @watchpoints << wp
       wp
     end
@@ -375,7 +398,7 @@ module LLDB
       wp_ptr = FFIBindings.lldb_target_find_watchpoint_by_id(@ptr, id)
       return nil if wp_ptr.nil? || wp_ptr.null?
 
-      Watchpoint.new(wp_ptr, target: self)
+      Watchpoint.new(wp_ptr, target: self, context: context)
     end
 
     # @rbs return: Integer
@@ -393,7 +416,7 @@ module LLDB
       wp_ptr = FFIBindings.lldb_target_get_watchpoint_at_index(@ptr, index)
       return nil if wp_ptr.nil? || wp_ptr.null?
 
-      Watchpoint.new(wp_ptr, target: self)
+      Watchpoint.new(wp_ptr, target: self, context: context)
     end
 
     # @rbs return: Array[Watchpoint]
@@ -406,22 +429,5 @@ module LLDB
       @ptr
     end
 
-    private
-
-    # @rbs process: Process
-    # @rbs timeout: Float
-    # @rbs return: void
-    def wait_for_process_stop(process, timeout: 10.0)
-      require 'timeout'
-
-      Timeout.timeout(timeout, LaunchError, "Process failed to stop within #{timeout} seconds") do
-        loop do
-          state = process.state
-          break if state == State::STOPPED || state == State::EXITED || state == State::CRASHED
-
-          sleep(0.01)
-        end
-      end
-    end
   end
 end

data/lib/lldb/thread.rb

@@ -4,16 +4,21 @@
 
 module LLDB
   class Thread
+    prepend NativeLifecycle
+
     # @rbs return: Process
     attr_reader :process
 
     # @rbs ptr: FFI::Pointer
     # @rbs process: Process
     # @rbs return: void
-    def initialize(ptr, process:)
-      @ptr = ptr # : FFI::Pointer
+    def initialize(ptr, process:, context: process.context)
       @process = process
-      ObjectSpace.define_finalizer(self, self.class.release(@ptr))
+      initialize_native_object(
+        ptr,
+        release: ->(released) { FFIBindings.lldb_thread_destroy(released) },
+        context: context
+      )
     end
 
     # @rbs ptr: FFI::Pointer
@@ -27,33 +32,59 @@ module LLDB
       !@ptr.null? && FFIBindings.lldb_thread_is_valid(@ptr) != 0
     end
 
-    # @rbs return: bool
-    def step_over
+    # @rbs run_mode: Integer
+    # @rbs return: true
+    def step_over(run_mode: RunMode::ONLY_DURING_STEPPING)
       raise InvalidObjectError, 'Thread is not valid' unless valid?
+      APISupport.require_method!(:lldb_thread_step_over, 'step_over')
 
-      FFIBindings.lldb_thread_step_over(@ptr) != 0
+      error = Error.new
+      status = FFIBindings.lldb_thread_step_over(@ptr, run_mode, error.to_ptr)
+      Native.check_status!(status, 'thread.step_over', error)
+      true
     end
 
-    # @rbs return: bool
-    def step_into
+    # @rbs target_name: String?
+    # @rbs end_line: Integer
+    # @rbs run_mode: Integer
+    # @rbs return: true
+    def step_into(target_name: nil, end_line: INVALID_LINE_NUMBER, run_mode: RunMode::ONLY_DURING_STEPPING)
       raise InvalidObjectError, 'Thread is not valid' unless valid?
-
-      FFIBindings.lldb_thread_step_into(@ptr) != 0
+      APISupport.require_method!(:lldb_thread_step_into, 'step_into')
+
+      error = Error.new
+      status = FFIBindings.lldb_thread_step_into(
+        @ptr,
+        target_name,
+        end_line,
+        run_mode,
+        error.to_ptr
+      )
+      Native.check_status!(status, 'thread.step_into', error)
+      true
     end
 
-    # @rbs return: bool
+    # @rbs return: true
     def step_out
       raise InvalidObjectError, 'Thread is not valid' unless valid?
+      APISupport.require_method!(:lldb_thread_step_out, 'step_out')
 
-      FFIBindings.lldb_thread_step_out(@ptr) != 0
+      error = Error.new
+      status = FFIBindings.lldb_thread_step_out(@ptr, error.to_ptr)
+      Native.check_status!(status, 'thread.step_out', error)
+      true
     end
 
     # @rbs step_over: bool
-    # @rbs return: bool
+    # @rbs return: true
     def step_instruction(step_over: false)
       raise InvalidObjectError, 'Thread is not valid' unless valid?
+      APISupport.require_method!(:lldb_thread_step_instruction, 'step_instruction')
 
-      FFIBindings.lldb_thread_step_instruction(@ptr, step_over ? 1 : 0) != 0
+      error = Error.new
+      status = FFIBindings.lldb_thread_step_instruction(@ptr, step_over ? 1 : 0, error.to_ptr)
+      Native.check_status!(status, 'thread.step_instruction', error)
+      true
     end
 
     # @rbs return: Integer
@@ -71,7 +102,7 @@ module LLDB
       frame_ptr = FFIBindings.lldb_thread_get_frame_at_index(@ptr, index)
       return nil if frame_ptr.nil? || frame_ptr.null?
 
-      Frame.new(frame_ptr, thread: self)
+      Frame.new(frame_ptr, thread: self, context: context)
     end
 
     # @rbs return: Frame?
@@ -81,7 +112,7 @@ module LLDB
       frame_ptr = FFIBindings.lldb_thread_get_selected_frame(@ptr)
       return nil if frame_ptr.nil? || frame_ptr.null?
 
-      Frame.new(frame_ptr, thread: self)
+      Frame.new(frame_ptr, thread: self, context: context)
     end
 
     # @rbs index: Integer
@@ -155,7 +186,10 @@ module LLDB
     def run_to_address(address)
       raise InvalidObjectError, 'Thread is not valid' unless valid?
 
-      FFIBindings.lldb_thread_run_to_address(@ptr, address) != 0
+      error = Error.new
+      status = FFIBindings.lldb_thread_run_to_address(@ptr, address, error.to_ptr)
+      Native.check_status!(status, 'thread.run_to_address', error)
+      true
     end
 
     # @rbs return: Integer
@@ -176,8 +210,11 @@ module LLDB
     # @rbs return: String?
     def stop_description(max_size = 256)
       return nil unless valid?
+      return '' if max_size.zero?
 
-      FFIBindings.lldb_thread_get_stop_description(@ptr, max_size)
+      NativeBuffer.read_c_string(max_size: max_size) do |buffer, length|
+        FFIBindings.lldb_thread_get_stop_description(@ptr, buffer, length)
+      end
     end
 
     # @rbs return: bool
@@ -215,7 +252,7 @@ module LLDB
       process_ptr = FFIBindings.lldb_thread_get_process(@ptr)
       return nil if process_ptr.nil? || process_ptr.null?
 
-      Process.new(process_ptr, target: @process.target)
+      Process.new(process_ptr, target: @process.target, context: context)
     end
 
     # @rbs return: FFI::Pointer

data/lib/lldb/type.rb

@@ -4,11 +4,16 @@
 
 module LLDB
   class Type
+    prepend NativeLifecycle
+
     # @rbs ptr: FFI::Pointer
     # @rbs return: void
-    def initialize(ptr)
-      @ptr = ptr # : FFI::Pointer
-      ObjectSpace.define_finalizer(self, self.class.release(@ptr))
+    def initialize(ptr, context: nil)
+      initialize_native_object(
+        ptr,
+        release: ->(released) { FFIBindings.lldb_type_destroy(released) },
+        context: context
+      )
     end
 
     # @rbs ptr: FFI::Pointer
@@ -190,6 +195,24 @@ module LLDB
       FFIBindings.lldb_type_get_num_virtual_base_classes(@ptr)
     end
 
+    # @rbs index: Integer
+    # @rbs return: TypeMember?
+    def field_at_index(index)
+      member_at(index, :lldb_type_get_field_at_index)
+    end
+
+    # @rbs index: Integer
+    # @rbs return: TypeMember?
+    def direct_base_class_at_index(index)
+      member_at(index, :lldb_type_get_direct_base_class_at_index)
+    end
+
+    # @rbs index: Integer
+    # @rbs return: TypeMember?
+    def virtual_base_class_at_index(index)
+      member_at(index, :lldb_type_get_virtual_base_class_at_index)
+    end
+
     # @rbs return: Integer
     def basic_type
       return BasicType::INVALID unless valid?
@@ -211,5 +234,19 @@ module LLDB
     def to_ptr
       @ptr
     end
+
+    private
+
+    # @rbs index: Integer
+    # @rbs method_name: ::Symbol
+    # @rbs return: TypeMember?
+    def member_at(index, method_name)
+      raise InvalidObjectError, 'Type is not valid' unless valid?
+
+      member_ptr = FFIBindings.public_send(method_name, @ptr, index)
+      return nil if member_ptr.nil? || member_ptr.null?
+
+      TypeMember.new(member_ptr, context: context)
+    end
   end
 end

data/lib/lldb/type_member.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+# rbs_inline: enabled
+
+module LLDB
+  class TypeMember
+    prepend NativeLifecycle
+
+    # @rbs context: Context?
+    # @rbs return: void
+    def initialize(ptr, context: nil)
+      initialize_native_object(
+        ptr,
+        release: ->(released) { FFIBindings.lldb_type_member_destroy(released) },
+        context: context
+      )
+    end
+
+    # @rbs return: bool
+    def valid?
+      !@ptr.null? && FFIBindings.lldb_type_member_is_valid(@ptr) != 0
+    end
+
+    # @rbs return: String?
+    def name
+      return nil unless valid?
+
+      FFIBindings.lldb_type_member_get_name(@ptr)
+    end
+
+    # @rbs return: Type?
+    def type
+      return nil unless valid?
+
+      ptr = FFIBindings.lldb_type_member_get_type(@ptr)
+      return nil if ptr.nil? || ptr.null?
+
+      Type.new(ptr, context: context)
+    end
+
+    # @rbs return: Integer
+    def offset_in_bytes
+      return 0 unless valid?
+
+      FFIBindings.lldb_type_member_get_offset_in_bytes(@ptr)
+    end
+
+    # @rbs return: Integer
+    def offset_in_bits
+      return 0 unless valid?
+
+      FFIBindings.lldb_type_member_get_offset_in_bits(@ptr)
+    end
+
+    # @rbs return: Integer
+    def bitfield_size_in_bits
+      return 0 unless valid?
+
+      FFIBindings.lldb_type_member_get_bitfield_size_in_bits(@ptr)
+    end
+
+    # @rbs return: FFI::Pointer
+    def to_ptr
+      @ptr
+    end
+  end
+end