module Cradare2

Defined in:

Constant Summary

VERSION = "0.2.30"

Class Method Summary

.attach(pid : Int32 | Int64, flags : Array(String) = [] of String, r2_path : String | Nil = nil, timeout : Time::Span | Nil = nil) : Client
Attaches radare2 in debug mode to a running process by PID.
.attach(pid : Int32 | Int64, flags : Array(String) = [] of String, r2_path : String | Nil = nil, timeout : Time::Span | Nil = nil, &block : Client -> U) : U forall U
Attaches radare2 in debug mode to a running process by PID and yields client to block.
.doctor : Util::Doctor
Runs toolchain and environment diagnostics.
.elf_bridge(client : Client, binary_path : String = "binary.elf", &block : Bridge::ElfBridge -> Nil) : Tuple(Array(Bridge::DisassembledSymbol), Bridge::ElfTelemetry)
Tier 2: Declarative Builder DSL
.gdb(host : String = "127.0.0.1", port : Int32 = 1234, arch : String | Nil = nil, bits : Int32 | Nil = nil, cpu : String | Nil = nil, timeout : Time::Span | Nil = nil, &block : Client -> U) : U forall U
Connects radare2 to a remote GDB stub (e.g.
.mock(default_handler = nil) : Client
Creates a client backed by a MockTransport for testing and offline development.
.mock(default_handler = nil, &block : Client -> U) : U forall U
Creates a mock client and yields it to the block.
.open(options : Options) : Client
Opens a radare2 session using an Options struct.
.open(options : Options, &block : Client -> U) : U forall U
Opens a radare2 session with Options and yields it to a block, ensuring cleanup.
.open(target : String | Nil = nil, flags : Array(String) = [] of String, debug : Bool = false, write : Bool = false, r2_path : String | Nil = nil, timeout : Time::Span | Nil = nil) : Client
Opens a radare2 session configured with individual parameters.
.open(target : String | Nil = nil, flags : Array(String) = [] of String, debug : Bool = false, write : Bool = false, r2_path : String | Nil = nil, timeout : Time::Span | Nil = nil, &block : Client -> U) : U forall U
Opens a radare2 session and yields it to the block, ensuring the session is automatically closed when the block exits.
.open_bytes(bytes : Bytes, arch : String | Nil = nil, bits : Int32 | Nil = nil, cpu : String | Nil = nil, flags : Array(String) = [] of String, &block : Client -> U) : U forall U
Analyzes an in-memory byte slice using radare2, automatically handling temporary file lifecycle.

Class Method Detail

def self.attach(pid : Int32 | Int64, flags : Array(String) = [] of String, r2_path : String | Nil = nil, timeout : Time::Span | Nil = nil) : Client #

Attaches radare2 in debug mode to a running process by PID.

[View source]

def self.attach(pid : Int32 | Int64, flags : Array(String) = [] of String, r2_path : String | Nil = nil, timeout : Time::Span | Nil = nil, &block : Client -> U) : U forall U #

Attaches radare2 in debug mode to a running process by PID and yields client to block.

[View source]

def self.doctor : Util::Doctor #

Runs toolchain and environment diagnostics.

[View source]

def self.elf_bridge(client : Client, binary_path : String = "binary.elf", &block : Bridge::ElfBridge -> Nil) : Tuple(Array(Bridge::DisassembledSymbol), Bridge::ElfTelemetry) #

Tier 2: Declarative Builder DSL

[View source]

def self.gdb(host : String = "127.0.0.1", port : Int32 = 1234, arch : String | Nil = nil, bits : Int32 | Nil = nil, cpu : String | Nil = nil, timeout : Time::Span | Nil = nil, &block : Client -> U) : U forall U #

Connects radare2 to a remote GDB stub (e.g. PCSX2, QEMU, gdbserver).

[View source]

def self.mock(default_handler = nil) : Client #

Creates a client backed by a MockTransport for testing and offline development.

[View source]

def self.mock(default_handler = nil, &block : Client -> U) : U forall U #

Creates a mock client and yields it to the block.

[View source]

def self.open(options : Options) : Client #

Opens a radare2 session using an Options struct.

[View source]

def self.open(options : Options, &block : Client -> U) : U forall U #

Opens a radare2 session with Options and yields it to a block, ensuring cleanup.

[View source]

def self.open(target : String | Nil = nil, flags : Array(String) = [] of String, debug : Bool = false, write : Bool = false, r2_path : String | Nil = nil, timeout : Time::Span | Nil = nil) : Client #

Opens a radare2 session configured with individual parameters.

Target options:

nil / "" / "#!pipe" : Connects to current radare2 in-session pipe (when run via #!pipe)
"http://..." or "https://..." : Connects to remote radare2 HTTP server
"tcp://..." : Connects to remote radare2 TCP socket server
File path or URI (e.g. "game.dll", "malloc://1024") : Spawns a local radare2 -q0 process

[View source]

def self.open(target : String | Nil = nil, flags : Array(String) = [] of String, debug : Bool = false, write : Bool = false, r2_path : String | Nil = nil, timeout : Time::Span | Nil = nil, &block : Client -> U) : U forall U #

Opens a radare2 session and yields it to the block, ensuring the session is automatically closed when the block exits.

[View source]

def self.open_bytes(bytes : Bytes, arch : String | Nil = nil, bits : Int32 | Nil = nil, cpu : String | Nil = nil, flags : Array(String) = [] of String, &block : Client -> U) : U forall U #

Analyzes an in-memory byte slice using radare2, automatically handling temporary file lifecycle.

[View source]

cradare2

module Cradare2

Defined in:

Constant Summary

Class Method Summary

Class Method Detail