lldb 0.1.0

data/examples/breakpoints.rb

@@ -0,0 +1,72 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Breakpoint management example
+#
+# This example demonstrates:
+# - Creating different types of breakpoints
+# - Managing breakpoint properties
+# - Conditional breakpoints
+
+require_relative '../lib/lldb'
+
+PROGRAM_PATH = File.expand_path('test_program', __dir__)
+
+unless File.exist?(PROGRAM_PATH)
+  puts 'Please compile test_program.c first'
+  exit 1
+end
+
+LLDB.initialize
+
+begin
+  debugger = LLDB::Debugger.create
+  target = debugger.create_target(PROGRAM_PATH)
+
+  puts '=== Breakpoint Types ==='
+
+  # Breakpoint by function name
+  bp1 = target.breakpoint_create_by_name('main')
+  puts "Breakpoint by name 'main': ID=#{bp1.id}, locations=#{bp1.num_locations}"
+
+  # Breakpoint by source location
+  bp2 = target.breakpoint_create_by_location('test_program.c', 4)
+  puts "Breakpoint by location: ID=#{bp2.id}"
+
+  puts "\n=== Breakpoint Properties ==="
+
+  # Disable a breakpoint
+  bp1.disable
+  puts "bp1 enabled? #{bp1.enabled?}"
+
+  # Enable it again
+  bp1.enable
+  puts "bp1 enabled after enable? #{bp1.enabled?}"
+
+  # Set condition
+  bp2.condition = 'a > 5'
+  puts "bp2 condition: #{bp2.condition}"
+
+  # Set ignore count
+  bp2.ignore_count = 2
+  puts "bp2 ignore count: #{bp2.ignore_count}"
+
+  # One-shot breakpoint
+  bp2.one_shot = true
+  puts "bp2 one-shot? #{bp2.one_shot?}"
+
+  puts "\n=== All Breakpoints ==="
+  target.breakpoints.each do |bp|
+    puts bp
+  end
+
+  puts "\n=== Finding Breakpoints ==="
+  found = target.find_breakpoint_by_id(bp1.id)
+  puts "Found breakpoint #{found.id}" if found
+
+  puts "\n=== Deleting Breakpoints ==="
+  bp1.delete
+  puts "Remaining breakpoints: #{target.num_breakpoints}"
+ensure
+  LLDB.terminate
+end

data/examples/expression_eval.rb

@@ -0,0 +1,84 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Expression evaluation example
+#
+# This example demonstrates:
+# - Finding and inspecting variables
+# - Evaluating expressions
+# - Working with Value objects
+
+require_relative '../lib/lldb'
+
+PROGRAM_PATH = File.expand_path('test_program', __dir__)
+
+unless File.exist?(PROGRAM_PATH)
+  puts 'Please compile test_program.c first'
+  exit 1
+end
+
+LLDB.initialize
+
+begin
+  debugger = LLDB::Debugger.create
+  debugger.async = false
+  target = debugger.create_target(PROGRAM_PATH)
+
+  # Set breakpoint inside add function
+  target.breakpoint_create_by_name('add')
+
+  puts 'Launching process...'
+  process = target.launch
+
+  if process.stopped?
+    thread = process.selected_thread
+    frame = thread.selected_frame
+
+    puts "Stopped at: #{frame.function_name}"
+    puts "Location: #{frame.location}"
+
+    puts "\n=== Variables ==="
+
+    # Find individual variables
+    a = frame.find_variable('a')
+    b = frame.find_variable('b')
+
+    if a&.valid?
+      puts "Variable 'a':"
+      puts "  Name: #{a.name}"
+      puts "  Type: #{a.type_name}"
+      puts "  Value: #{a.value}"
+      puts "  As integer: #{a.to_i}"
+      puts "  Byte size: #{a.byte_size}"
+    end
+
+    if b&.valid?
+      puts "\nVariable 'b':"
+      puts "  #{b.inspect}"
+    end
+
+    puts "\n=== Expression Evaluation ==="
+
+    # Evaluate expressions
+    expressions = [
+      'a + b',
+      'a * b',
+      'a - b',
+      'a / 2',
+      '(a + b) * 2'
+    ]
+
+    expressions.each do |expr|
+      result = frame.evaluate_expression(expr)
+      if result&.valid?
+        puts "#{expr} = #{result.value}"
+      else
+        puts "#{expr} = (error)"
+      end
+    end
+
+    process.kill
+  end
+ensure
+  LLDB.terminate
+end

data/examples/test_program.c

@@ -0,0 +1,14 @@
+#include <stdio.h>
+
+int add(int a, int b) {
+    int result = a + b;
+    return result;
+}
+
+int main(int argc, char** argv) {
+    int x = 10;
+    int y = 20;
+    int sum = add(x, y);
+    printf("Sum: %d\n", sum);
+    return 0;
+}

data/ext/lldb/Makefile

@@ -0,0 +1,24 @@
+CXX = clang++
+CXXFLAGS = -fdeclspec -std=c++17 -I/opt/homebrew/opt/llvm/include -fPIC
+LDFLAGS = -L. -fstack-protector-strong -L/opt/homebrew/Cellar/gmp/6.3.0/lib -L/opt/homebrew/opt/llvm/lib -llldb -Wl,-rpath,/opt/homebrew/opt/llvm/lib -lc++ -L/opt/homebrew/Cellar/gmp/6.3.0/lib -Wl,-undefined,dynamic_lookup -dynamiclib
+
+TARGET = liblldb_wrapper.dylib
+SRCS = lldb_wrapper.cpp
+OBJS = lldb_wrapper.o
+
+all: $(TARGET)
+
+$(TARGET): $(OBJS)
+	$(CXX) $(LDFLAGS) -o $@ $(OBJS)
+
+%.o: %.cpp
+	$(CXX) $(CXXFLAGS) -c -o $@ $<
+
+install: $(TARGET)
+	mkdir -p $(DESTDIR)/Users/yudai.takada/.rbenv/versions/4.0.0/lib/ruby/site_ruby/4.0.0/lldb
+	cp $(TARGET) $(DESTDIR)/Users/yudai.takada/.rbenv/versions/4.0.0/lib/ruby/site_ruby/4.0.0/lldb/
+
+clean:
+	rm -f $(OBJS) $(TARGET)
+
+.PHONY: all install clean

data/ext/lldb/extconf.rb

@@ -0,0 +1,160 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'mkmf'
+
+# Enable C++17
+$CXXFLAGS ||= ''
+$CXXFLAGS << ' -std=c++17'
+
+# Common LLDB search paths
+lldb_search_paths = [
+  # macOS Xcode
+  '/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr',
+  '/Library/Developer/CommandLineTools/usr',
+  # Homebrew LLVM on macOS (Apple Silicon)
+  '/opt/homebrew/opt/llvm',
+  # Homebrew LLVM on macOS (Intel)
+  '/usr/local/opt/llvm',
+  # Linux system paths
+  '/usr',
+  '/usr/local'
+]
+
+# Find LLDB version-specific paths on Linux
+Dir.glob('/usr/lib/llvm-*').each do |path|
+  lldb_search_paths << path
+end
+
+lldb_lib_dir = nil
+lldb_include_dir = nil
+
+# Try to find LLDB using lldb-config or llvm-config
+llvm_config = find_executable('llvm-config') ||
+              find_executable('llvm-config-18') ||
+              find_executable('llvm-config-17') ||
+              find_executable('llvm-config-16') ||
+              find_executable('llvm-config-15') ||
+              find_executable('llvm-config-14')
+
+if llvm_config
+  lldb_lib_dir = `#{llvm_config} --libdir`.strip
+  lldb_include_dir = `#{llvm_config} --includedir`.strip
+else
+  # Search manually
+  lldb_search_paths.each do |base_path|
+    next unless File.directory?(base_path)
+
+    lib_candidates = [
+      File.join(base_path, 'lib'),
+      File.join(base_path, 'lib64')
+    ]
+
+    lib_candidates.each do |lib_path|
+      next unless File.directory?(lib_path)
+
+      # Check for liblldb
+      has_lldb = File.exist?(File.join(lib_path, 'liblldb.so')) ||
+                 File.exist?(File.join(lib_path, 'liblldb.dylib')) ||
+                 Dir.glob(File.join(lib_path, 'liblldb.so.*')).any?
+
+      next unless has_lldb
+
+      lldb_lib_dir = lib_path
+      lldb_include_dir = File.join(base_path, 'include')
+      break
+    end
+
+    break if lldb_lib_dir
+  end
+end
+
+
+unless lldb_lib_dir
+  abort <<~MSG
+
+    *** ERROR: Could not find LLDB library ***
+
+    Please install LLDB development files:
+
+    On Ubuntu/Debian:
+      sudo apt-get install lldb-14 liblldb-14-dev
+
+    On Fedora/RHEL:
+      sudo dnf install lldb-devel
+
+    On macOS:
+      xcode-select --install
+      # or
+      brew install llvm
+
+    You can also set LLDB_DIR environment variable to point to your LLDB installation:
+      LLDB_DIR=/path/to/llvm gem install lldb
+
+  MSG
+end
+
+puts "Found LLDB library directory: #{lldb_lib_dir}"
+puts "Found LLDB include directory: #{lldb_include_dir}" if lldb_include_dir
+
+# Add include paths
+$CXXFLAGS << " -I#{lldb_include_dir}" if lldb_include_dir && File.directory?(lldb_include_dir)
+
+# Link against LLDB library
+$LDFLAGS << " -L#{lldb_lib_dir} -llldb"
+$LDFLAGS << " -Wl,-rpath,#{lldb_lib_dir}"
+
+# Check for C++ standard library
+$LDFLAGS << if RUBY_PLATFORM =~ /darwin/
+              ' -lc++'
+            else
+              ' -lstdc++'
+            end
+
+# Create the extension as a shared library, not a Ruby native extension
+# because we're using FFI to load it
+$srcs = ['lldb_wrapper.cpp']
+$objs = ['lldb_wrapper.o']
+
+# Set the target library name
+$DLDFLAGS ||= ''
+
+if RUBY_PLATFORM =~ /darwin/
+  target = 'liblldb_wrapper.dylib'
+  $DLDFLAGS << ' -dynamiclib'
+else
+  target = 'liblldb_wrapper.so'
+  $DLDFLAGS << ' -shared'
+end
+
+# Create a custom Makefile that builds a shared library
+File.open('Makefile', 'w') do |f|
+  f.puts <<~MAKEFILE
+    CXX = #{RbConfig::CONFIG['CXX'] || 'c++'}
+    CXXFLAGS = #{$CXXFLAGS} -fPIC
+    LDFLAGS = #{$LDFLAGS} #{$DLDFLAGS}
+
+    TARGET = #{target}
+    SRCS = lldb_wrapper.cpp
+    OBJS = lldb_wrapper.o
+
+    all: $(TARGET)
+
+    $(TARGET): $(OBJS)
+    \t$(CXX) $(LDFLAGS) -o $@ $(OBJS)
+
+    %.o: %.cpp
+    \t$(CXX) $(CXXFLAGS) -c -o $@ $<
+
+    install: $(TARGET)
+    \tmkdir -p $(DESTDIR)#{RbConfig::CONFIG['sitelibdir']}/lldb
+    \tcp $(TARGET) $(DESTDIR)#{RbConfig::CONFIG['sitelibdir']}/lldb/
+
+    clean:
+    \trm -f $(OBJS) $(TARGET)
+
+    .PHONY: all install clean
+  MAKEFILE
+end
+
+puts 'Makefile created successfully'