Struct falcon::il::Function

pub struct Function { /* private fields */ }

A function for Falcon IL. Provides location and context in a Program to a ControlFlowGraph.

Implementations

impl Function

pub fn new(address: u64, control_flow_graph: ControlFlowGraph) -> Function

Create a new Function

Parameters

• address - The address where we recovered this function.
• control_flow_graph - A ControlFlowGraph capturing the semantics of this function.

pub fn locations(&self) -> Vec<RefFunctionLocation<'_>>

Create a Vec of every RefFunctionLocation for this function.

Convenient for analyses where we need to check every location in a function

pub fn address(&self) -> u64

Get the address of this Function.

The address returned will be the address set when this Function was created, which should be the virtual address where this Function was found.

pub fn block(&self, index: usize) -> Result<&Block, Error>

Return a Block from this Function’s ControlFlowGraph by index.

pub fn block_mut(&mut self, index: usize) -> Result<&mut Block, Error>

Return a mutable reference to a Block in this Function

pub fn blocks(&self) -> Vec<&Block>

Return a Vec of all Block in this Function

pub fn blocks_mut(&mut self) -> Vec<&mut Block>

Return a Vec of mutable references to all Block in this Function

pub fn edge(&self, head: usize, tail: usize) -> Result<&Edge, Error>

Return an Edge from this Function’s ControlFlowGraph by index.

pub fn edges(&self) -> Vec<&Edge>

Return a vec of all Edge in this Function

pub fn control_flow_graph(&self) -> &ControlFlowGraph

Return the ControlFlowGraph for this Function.

pub fn control_flow_graph_mut(&mut self) -> &mut ControlFlowGraph

Return a mutable reference to the ControlFlowGraph for this Function.

pub fn name(&self) -> String

Return the name of this Function.

pub fn set_name(&mut self, name: Option<String>)

Set this Function’s name.

pub fn index(&self) -> Option<usize>

Return the index of this Function. A Function will have an index if it is added to a Program.

pub fn set_index(&mut self, index: Option<usize>)

Trait Implementations

impl Clone for Function

fn clone(&self) -> Function

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Function

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Function

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Hash for Function

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq<Function> for Function

fn eq(&self, other: &Function) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Function

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for Function

impl StructuralEq for Function

impl StructuralPartialEq for Function