Struct elfbin::Builder

pub struct Builder<W: Write + Seek> { /* fields omitted */ }

Represents an ELF file under construction.

Implementations

impl<W> Builder<W> where
    W: Write + Seek, 

pub fn new(hdr: Header, target: W) -> Result<Self>

Begin constructing a new ELF file with the given header information in the given writer.

The header information also serves to select which specific ELF variant the builder will generate, by choosing a class and an encoding.

pub fn add_symbol<S: Into<String>, R: Read>(
    &mut self,
    name: S,
    src: R
) -> Result<Symbol>

Define a new symbol in the output file, using the contents of a given reader as the symbol contents.

add_symbol will read the given reader to completion and copy all of its data into the output file.

add_symbol doesn’t check if you define the same symbol name more than once, but doing so will create a confusing object file that may not be accepted by an ELF linker.

pub fn close(self) -> Result<W>

Finalizes the ELF metadata in the underlying file and then returns that file.

If you don’t call close then the file will be left in a state where it contains any symbol data written previously but it lacks the necessary metadata for an ELF linker to find that data, and thus the object file will appear to have no symbols at all.