Struct libelf::Elf

pub struct Elf<'elf> { /* private fields */ }

A handle to an ELF file.

Implementations

impl<'elf> Elf<'elf>

pub fn open<P: AsRef<Path>>(path: P) -> Result<Elf<'static>>

Open an Elf from a path.

Examples

let exe = std::env::current_exe().unwrap();
let elf = libelf::Elf::open(exe).unwrap();

pub fn from_fd<FD: AsRawFd>(fd: &'elf FD) -> Result<Elf<'elf>>

Create an Elf from an open file.

Examples

let exe = std::env::current_exe().unwrap();
let f = std::fs::File::open(exe).unwrap();
let elf = libelf::Elf::from_fd(&f).unwrap();

pub fn from_bytes(bytes: &'elf [u8]) -> Result<Elf<'elf>>

Create an Elf from a byte slice.

Examples

use std::io::Read;
let exe = std::env::current_exe().unwrap();
let mut buf = vec![];
std::fs::File::open(exe).unwrap()
    .read_to_end(&mut buf).unwrap();

let elf = libelf::Elf::from_bytes(&buf).unwrap();

// elfutils doesn't mind an empty ELF!
let empty = libelf::Elf::from_bytes(&[]).unwrap();

pub unsafe fn from_raw(elf: *mut Elf) -> Elf<'elf>

Create an Elf from a raw FFI pointer.

Safety

This function is unsafe because there is no guarantee that the given pointer is a valid libelf handle, nor whether the lifetime inferred is appropriate. This does not take ownership of the underlying object, so the caller must ensure it outlives the returned Elf wrapper.

pub fn as_ptr(&self) -> *mut Elf

Get a raw FFI pointer

Examples

let ptr = elf.as_ptr();
assert!(!ptr.is_null());
let base = unsafe { libelf::raw::elf_getbase(ptr) };
assert!(base >= 0);

Trait Implementations

impl<'elf> Debug for Elf<'elf>

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

Formats the value using the given formatter.

impl<'elf> Drop for Elf<'elf>

fn drop(&mut self)

Executes the destructor for this type.