Struct Executable

pub struct Executable<C>
where
    C: ContextObject,
{ /* private fields */ }

Elf loader/relocator

Implementations

impl<C> Executable<C>

where C: ContextObject,

pub fn get_config(&self) -> &Config

Get the configuration settings

pub fn get_sbpf_version(&self) -> &SBPFVersion

Get the executable sbpf_version

pub fn get_text_bytes(&self) -> (u64, &[u8])

Get the .text section virtual address and bytes

pub fn get_ro_section(&self) -> &[u8]

Get the concatenated read-only sections (including the text section)

pub fn get_ro_region(&self) -> MemoryRegion

Get a memory region that can be used to access the merged readonly section

pub fn get_entrypoint_instruction_offset(&self) -> usize

Get the entry point offset into the text section

pub fn get_loader(&self) -> &Arc<BuiltinProgram<C>>

Get the loader built-in program

pub fn get_compiled_program(&self) -> Option<&JitProgram>

Get the JIT compiled program

pub fn verify<V>(&self) -> Result<(), EbpfError>

where V: Verifier,

Verify the executable

pub fn jit_compile(&mut self) -> Result<(), EbpfError>

JIT compile the executable

pub fn get_function_registry(&self) -> &FunctionRegistry<usize>

Get the function registry

pub fn new_from_text_bytes( text_bytes: &[u8], loader: Arc<BuiltinProgram<C>>, sbpf_version: SBPFVersion, function_registry: FunctionRegistry<usize>, ) -> Result<Executable<C>, ElfError>

Create from raw text section bytes (list of instructions)

pub fn load( bytes: &[u8], loader: Arc<BuiltinProgram<C>>, ) -> Result<Executable<C>, ElfError>

Fully loads an ELF, including validation and relocation

pub fn mem_size(&self) -> usize

Calculate the total memory size of the executable

pub fn validate<'a, P>( config: &Config, elf: &'a P, elf_bytes: &[u8], ) -> Result<(), ElfError>

where P: ElfParser<'a>,

Validates the ELF

impl<C> Executable<C>

where C: ContextObject,

Static constructors for Executable

pub fn from_elf( elf_bytes: &[u8], loader: Arc<BuiltinProgram<C>>, ) -> Result<Executable<C>, EbpfError>

Creates an executable from an ELF file

pub fn from_text_bytes( text_bytes: &[u8], loader: Arc<BuiltinProgram<C>>, sbpf_version: SBPFVersion, function_registry: FunctionRegistry<usize>, ) -> Result<Executable<C>, EbpfError>

Creates an executable from machine code

Trait Implementations

impl<C> Debug for Executable<C>

where C: Debug + ContextObject,

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

Formats the value using the given formatter.

impl<C> PartialEq for Executable<C>

where C: PartialEq + ContextObject,

fn eq(&self, other: &Executable<C>) -> 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<C> StructuralPartialEq for Executable<C>

where C: ContextObject,