Struct LoaderOptions

pub struct LoaderOptions { /* private fields */ }

Dynamic loader options.

Implementations

impl LoaderOptions

pub fn new() -> Self

Default options.

pub fn glibc<P: AsRef<Path>>(rootfs_dir: P) -> Result<Self, Error>

Glibc-specific options.

pub fn musl<P: AsRef<Path>>(rootfs_dir: P, arch: &str) -> Result<Self, Error>

Musl-specific options.

pub fn libc(self, libc: Libc) -> Self

Dynamic linker implementation that we’re emulating.

Affects library search order only.

To also set library search directories, use glibc and musl constructors.

pub fn search_dirs(self, search_dirs: Vec<PathBuf>) -> Self

Directories where to look for libraries after searching in the RUNPATH or in the RPATH.

Use the following functions to initialize this field.

• Glibc: glibc::get_search_dirs.
• Musl: musl::get_search_dirs.

pub fn search_dirs_override(self, search_dirs: Vec<PathBuf>) -> Self

Directories where to look for libraries before searching in the RUNPATH.

This list doesn’t affect RPATH-based lookup.

Use get_search_dirs_from_env to initialize this field.

pub fn page_size(self, page_size: u64) -> Self

Set page size.

Panics if the size is not a power of two.

pub fn lib(self, lib: Option<OsString>) -> Self

Set library directory name.

This value is used to substitute $LIB variable in RPATH and RUNPATH.

When not set lib is used for 32-bit arhitectures and lib64 is used for 64-bit architectures.

pub fn platform(self, platform: Option<OsString>) -> Self

Set platform directory name.

This value is used to substitute $PLATFORM variable in RPATH and RUNPATH.

When not set the platform is interpolated based on Machine (best-effort).

pub fn new_loader(self) -> DynamicLoader

Create new dynamic loader using the current options.

Trait Implementations

impl Default for LoaderOptions

fn default() -> Self

Returns the “default value” for a type.