// Copyright 2021-2024 Vector 35 Inc. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. //! Interfaces for creating and displaying pretty CFGs in Binary Ninja. use binaryninjacore_sys::*; use crate::disassembly::DisassemblyTextLine; use crate::rc::*; use std::marker::PhantomData; pub type BranchType = BNBranchType; pub type EdgePenStyle = BNEdgePenStyle; pub type ThemeColor = BNThemeColor; pub type FlowGraphOption = BNFlowGraphOption; #[repr(transparent)] pub struct EdgeStyle(pub(crate) BNEdgeStyle); impl EdgeStyle { pub fn new(style: EdgePenStyle, width: usize, color: ThemeColor) -> Self { EdgeStyle(BNEdgeStyle { style, width, color, }) } } impl Default for EdgeStyle { fn default() -> Self { EdgeStyle(BNEdgeStyle { style: EdgePenStyle::SolidLine, width: 0, color: ThemeColor::AddressColor, }) } } #[derive(PartialEq, Eq, Hash)] pub struct FlowGraphNode<'a> { pub(crate) handle: *mut BNFlowGraphNode, _data: PhantomData<&'a ()>, } impl<'a> FlowGraphNode<'a> { pub(crate) unsafe fn from_raw(raw: *mut BNFlowGraphNode) -> Self { Self { handle: raw, _data: PhantomData, } } pub fn new(graph: &FlowGraph) -> Self { unsafe { FlowGraphNode::from_raw(BNCreateFlowGraphNode(graph.handle)) } } pub fn set_disassembly_lines(&self, lines: &'a [DisassemblyTextLine]) { unsafe { BNSetFlowGraphNodeLines(self.handle, lines.as_ptr() as *mut _, lines.len()); // BNFreeDisassemblyTextLines(lines.as_ptr() as *mut _, lines.len()); // Shouldn't need...would be a double free? } } pub fn set_lines(&self, lines: Vec<&str>) { let lines = lines .iter() .map(|&line| DisassemblyTextLine::from(&vec![line])) .collect::>(); self.set_disassembly_lines(&lines); } pub fn add_outgoing_edge( &self, type_: BranchType, target: &'a FlowGraphNode, edge_style: &'a EdgeStyle, ) { unsafe { BNAddFlowGraphNodeOutgoingEdge(self.handle, type_, target.handle, edge_style.0) } } } unsafe impl<'a> RefCountable for FlowGraphNode<'a> { unsafe fn inc_ref(handle: &Self) -> Ref { Ref::new(Self { handle: BNNewFlowGraphNodeReference(handle.handle), _data: PhantomData, }) } unsafe fn dec_ref(handle: &Self) { BNFreeFlowGraphNode(handle.handle); } } impl<'a> ToOwned for FlowGraphNode<'a> { type Owned = Ref; fn to_owned(&self) -> Self::Owned { unsafe { RefCountable::inc_ref(self) } } } #[derive(PartialEq, Eq, Hash)] pub struct FlowGraph { pub(crate) handle: *mut BNFlowGraph, } impl FlowGraph { pub(crate) unsafe fn from_raw(raw: *mut BNFlowGraph) -> Self { Self { handle: raw } } pub fn new() -> Ref { unsafe { Ref::new(FlowGraph::from_raw(BNCreateFlowGraph())) } } pub fn append(&self, node: &FlowGraphNode) -> usize { unsafe { BNAddFlowGraphNode(self.handle, node.handle) } } pub fn set_option(&self, option: FlowGraphOption, value: bool) { unsafe { BNSetFlowGraphOption(self.handle, option, value) } } pub fn is_option_set(&self, option: FlowGraphOption) -> bool { unsafe { BNIsFlowGraphOptionSet(self.handle, option) } } } unsafe impl RefCountable for FlowGraph { unsafe fn inc_ref(handle: &Self) -> Ref { Ref::new(Self { handle: BNNewFlowGraphReference(handle.handle), }) } unsafe fn dec_ref(handle: &Self) { BNFreeFlowGraph(handle.handle); } } impl ToOwned for FlowGraph { type Owned = Ref; fn to_owned(&self) -> Self::Owned { unsafe { RefCountable::inc_ref(self) } } }