Struct BinaryView

pub struct BinaryView {
    pub handle: *mut BNBinaryView,
}

Cleaning up

BinaryView has a cyclic relationship with the associated FileMetadata, each holds a strong reference to one another, so to properly clean up/free the BinaryView, you must manually close the file using FileMetadata::close, this is not fixable in the general case, until FileMetadata has only a weak reference to the BinaryView.

Fields

handle: *mut BNBinaryView

Implementations

impl BinaryView

pub unsafe fn from_raw(handle: *mut BNBinaryView) -> Self

pub fn from_path( meta: &mut FileMetadata, file_path: impl AsRef<Path>, ) -> Result<Ref<Self>>

pub fn from_accessor<A: Accessor>( meta: &FileMetadata, file: &mut FileAccessor<A>, ) -> Result<Ref<Self>>

pub fn from_data(meta: &FileMetadata, data: &[u8]) -> Result<Ref<Self>>

pub fn save_to_path(&self, file_path: impl AsRef<Path>) -> bool

Save the original binary file to the provided file_path along with any modifications.

WARNING: Currently there is a possibility to deadlock if the analysis has queued up a main thread action that tries to take the FileMetadata lock of the current view, and is executed while we are executing in this function.

To avoid the above issue use crate::main_thread::execute_on_main_thread_and_wait to verify there are no queued up main thread actions.

pub fn save_to_accessor<A: Accessor>(&self, file: &mut FileAccessor<A>) -> bool

Save the original binary file to the provided FileAccessor along with any modifications.

WARNING: Currently there is a possibility to deadlock if the analysis has queued up a main thread action that tries to take the FileMetadata lock of the current view, and is executed while we are executing in this function.

To avoid the above issue use crate::main_thread::execute_on_main_thread_and_wait to verify there are no queued up main thread actions.

Trait Implementations

impl AsRef<BinaryView> for BinaryView

fn as_ref(&self) -> &Self

Converts this type into a shared reference of the (usually inferred) input type.

impl BinaryViewBase for BinaryView

fn offset_valid(&self, offset: u64) -> bool

Check if the offset is valid for the current view.

NOTE: If operating within a Workflow, consider using AnalysisContext::is_offset_valid.

fn offset_readable(&self, offset: u64) -> bool

Check if the offset is readable for the current view.

NOTE: If operating within a Workflow, consider using AnalysisContext::is_offset_valid.

fn offset_writable(&self, offset: u64) -> bool

Check if the offset is writable for the current view.

NOTE: If operating within a Workflow, consider using AnalysisContext::is_offset_writable.

fn offset_executable(&self, offset: u64) -> bool

Check if the offset is executable for the current view.

NOTE: If operating within a Workflow, consider using AnalysisContext::is_offset_executable.

fn offset_backed_by_file(&self, offset: u64) -> bool

Check if the offset is backed by the original file and not added after the fact.

NOTE: If operating within a Workflow, consider using AnalysisContext::is_offset_backed_by_file.

fn next_valid_offset_after(&self, offset: u64) -> u64

Get the next valid offset after the provided offset, useful if you need to iterate over all readable offsets in the view.

NOTE: If operating within a Workflow, consider using AnalysisContext::next_valid_offset.

fn start(&self) -> u64

The lowest address in the view.

NOTE: If operating within a Workflow, consider using AnalysisContext::start.

fn len(&self) -> u64

The length of the view, lowest to highest address.

NOTE: If operating within a Workflow, consider using AnalysisContext::length.

fn read(&self, buf: &mut [u8], offset: u64) -> usize

fn write(&self, offset: u64, data: &[u8]) -> usize

fn insert(&self, offset: u64, data: &[u8]) -> usize

fn remove(&self, offset: u64, len: usize) -> usize

fn modification_status(&self, offset: u64) -> ModificationStatus

fn executable(&self) -> bool

fn relocatable(&self) -> bool

fn entry_point(&self) -> u64

fn default_endianness(&self) -> Endianness

fn address_size(&self) -> usize

fn save(&self) -> bool

impl Debug for BinaryView

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

Formats the value using the given formatter.

impl Hash for BinaryView

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 for BinaryView

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl ToOwned for BinaryView

type Owned = Ref<BinaryView>

The resulting type after obtaining ownership.

fn to_owned(&self) -> Self::Owned

Creates owned data from borrowed data, usually by cloning.

fn clone_into(&self, target: &mut Self::Owned)

Uses borrowed data to replace owned data, usually by cloning.

impl Eq for BinaryView

impl Send for BinaryView

impl StructuralPartialEq for BinaryView

impl Sync for BinaryView