diff options
| author | Mason Reed <mason@vector35.com> | 2025-05-08 21:39:12 -0400 |
|---|---|---|
| committer | Mason Reed <35282038+emesare@users.noreply.github.com> | 2025-05-12 17:45:24 -0400 |
| commit | adbd39ab7c3d4e67e8709af43176e60f31141ba8 (patch) | |
| tree | c6c937ae1561d5b7cd8f2925ef44b5091c6a86dc /rust/src/flowgraph.rs | |
| parent | 38fa66115c00ead8dcc38ec5c5451d3ce4444ab8 (diff) | |
[Rust] Flow graph API improvements
- Fixed some misc bugs
- Added real FlowGraphEdge type
- Added accessors for node edges
- Added interaction handler to the flow graph example to dump the flow graph to stdin
- Split out the flow graph API into smaller files
Diffstat (limited to 'rust/src/flowgraph.rs')
| -rw-r--r-- | rust/src/flowgraph.rs | 177 |
1 files changed, 8 insertions, 169 deletions
diff --git a/rust/src/flowgraph.rs b/rust/src/flowgraph.rs index 976764eb..0faab0e4 100644 --- a/rust/src/flowgraph.rs +++ b/rust/src/flowgraph.rs @@ -14,17 +14,21 @@ //! Interfaces for creating and displaying pretty CFGs in Binary Ninja. -use crate::disassembly::DisassemblyTextLine; -use crate::rc::*; use binaryninjacore_sys::*; -use crate::basic_block::{BasicBlock, BlockContext}; -use crate::function::HighlightColor; use crate::high_level_il::HighLevelILFunction; use crate::low_level_il::RegularLowLevelILFunction; use crate::medium_level_il::MediumLevelILFunction; +use crate::rc::*; use crate::render_layer::CoreRenderLayer; +pub mod edge; +pub mod node; + +pub use edge::EdgeStyle; +pub use edge::FlowGraphEdge; +pub use node::FlowGraphNode; + pub type BranchType = BNBranchType; pub type EdgePenStyle = BNEdgePenStyle; pub type ThemeColor = BNThemeColor; @@ -162,168 +166,3 @@ impl ToOwned for FlowGraph { unsafe { RefCountable::inc_ref(self) } } } - -#[derive(PartialEq, Eq, Hash)] -pub struct FlowGraphNode { - pub(crate) handle: *mut BNFlowGraphNode, -} - -impl FlowGraphNode { - pub(crate) unsafe fn from_raw(raw: *mut BNFlowGraphNode) -> Self { - Self { handle: raw } - } - - pub(crate) unsafe fn ref_from_raw(raw: *mut BNFlowGraphNode) -> Ref<Self> { - Ref::new(Self { handle: raw }) - } - - pub fn new(graph: &FlowGraph) -> Ref<Self> { - unsafe { FlowGraphNode::ref_from_raw(BNCreateFlowGraphNode(graph.handle)) } - } - - pub fn basic_block<C: BlockContext>(&self, context: C) -> Option<Ref<BasicBlock<C>>> { - let block_ptr = unsafe { BNGetFlowGraphBasicBlock(self.handle) }; - if block_ptr.is_null() { - return None; - } - Some(unsafe { BasicBlock::ref_from_raw(block_ptr, context) }) - } - - pub fn set_basic_block<C: BlockContext>(&self, block: Option<&BasicBlock<C>>) { - match block { - Some(block) => unsafe { BNSetFlowGraphBasicBlock(self.handle, block.handle) }, - None => unsafe { BNSetFlowGraphBasicBlock(self.handle, std::ptr::null_mut()) }, - } - } - - pub fn lines(&self) -> Array<DisassemblyTextLine> { - let mut count = 0; - let result = unsafe { BNGetFlowGraphNodeLines(self.handle, &mut count) }; - assert!(!result.is_null()); - unsafe { Array::new(result, count, ()) } - } - - pub fn set_lines(&self, lines: impl IntoIterator<Item = DisassemblyTextLine>) { - // NOTE: This will create allocations and increment tag refs, we must call DisassemblyTextLine::free_raw - let mut raw_lines: Vec<BNDisassemblyTextLine> = lines - .into_iter() - .map(DisassemblyTextLine::into_raw) - .collect(); - unsafe { - BNSetFlowGraphNodeLines(self.handle, raw_lines.as_mut_ptr(), raw_lines.len()); - for raw_line in raw_lines { - DisassemblyTextLine::free_raw(raw_line); - } - } - } - - /// Returns the graph position of the node in X, Y form. - pub fn position(&self) -> (i32, i32) { - let pos_x = unsafe { BNGetFlowGraphNodeX(self.handle) }; - let pos_y = unsafe { BNGetFlowGraphNodeY(self.handle) }; - (pos_x, pos_y) - } - - /// Sets the graph position of the node. - pub fn set_position(&self, x: i32, y: i32) { - unsafe { BNFlowGraphNodeSetX(self.handle, x) }; - unsafe { BNFlowGraphNodeSetX(self.handle, y) }; - } - - pub fn highlight_color(&self) -> HighlightColor { - let raw = unsafe { BNGetFlowGraphNodeHighlight(self.handle) }; - HighlightColor::from(raw) - } - - pub fn set_highlight_color(&self, highlight: HighlightColor) { - unsafe { BNSetFlowGraphNodeHighlight(self.handle, highlight.into()) }; - } - - // TODO: Add getters and setters for edges - - pub fn add_outgoing_edge( - &self, - type_: BranchType, - target: &FlowGraphNode, - edge_style: EdgeStyle, - ) { - unsafe { - BNAddFlowGraphNodeOutgoingEdge(self.handle, type_, target.handle, edge_style.into()) - } - } -} - -unsafe impl RefCountable for FlowGraphNode { - unsafe fn inc_ref(handle: &Self) -> Ref<Self> { - Ref::new(Self { - handle: BNNewFlowGraphNodeReference(handle.handle), - }) - } - - unsafe fn dec_ref(handle: &Self) { - BNFreeFlowGraphNode(handle.handle); - } -} - -impl ToOwned for FlowGraphNode { - type Owned = Ref<Self>; - - fn to_owned(&self) -> Self::Owned { - unsafe { RefCountable::inc_ref(self) } - } -} - -impl CoreArrayProvider for FlowGraphNode { - type Raw = *mut BNFlowGraphNode; - type Context = (); - type Wrapped<'a> = Guard<'a, FlowGraphNode>; -} - -unsafe impl CoreArrayProviderInner for FlowGraphNode { - unsafe fn free(raw: *mut Self::Raw, count: usize, _: &Self::Context) { - BNFreeFlowGraphNodeList(raw, count); - } - - unsafe fn wrap_raw<'a>(raw: &'a Self::Raw, context: &'a Self::Context) -> Self::Wrapped<'a> { - Guard::new(Self::from_raw(*raw), context) - } -} - -#[derive(Clone, Copy, PartialEq, Eq, Hash, Debug)] -pub struct EdgeStyle { - style: EdgePenStyle, - width: usize, - color: ThemeColor, -} - -impl EdgeStyle { - pub fn new(style: EdgePenStyle, width: usize, color: ThemeColor) -> Self { - Self { - style, - width, - color, - } - } -} - -impl Default for EdgeStyle { - fn default() -> Self { - Self::new(EdgePenStyle::SolidLine, 0, ThemeColor::AddressColor) - } -} - -impl From<BNEdgeStyle> for EdgeStyle { - fn from(style: BNEdgeStyle) -> Self { - Self::new(style.style, style.width, style.color) - } -} - -impl From<EdgeStyle> for BNEdgeStyle { - fn from(style: EdgeStyle) -> Self { - Self { - style: style.style, - width: style.width, - color: style.color, - } - } -} |
