dlloader 0.1.0

A cross-platform dynamic library loader
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83

use std::ffi::NulError;
use std::{io, path::PathBuf};

#[derive(Debug, thiserror::Error)]
pub enum LoaderError {
    #[error("library not found: {path}")]
    LibraryNotFound { path: PathBuf },

    #[error("failed to open library `{path}`: {source}")]
    OpenLibrary {
        path: PathBuf,
        #[source]
        source: io::Error,
    },

    #[error("failed to create temporary directory: {source}")]
    CreateTempDir {
        #[source]
        source: io::Error,
    },

    #[error("failed to write temporary library file `{path}`: {source}")]
    WriteTempLibrary {
        path: PathBuf,
        #[source]
        source: io::Error,
    },

    #[error("failed to load symbol: {source}")]
    SymbolGetting {
        #[source]
        source: io::Error,
    },

    #[error("symbol name contains a null byte")]
    NullCharacter {
        #[from]
        source: NulError,
    },

    #[error("symbol pointer was null")]
    NullSymbol,

    #[error("address could not be matched to a dynamic library: {source}")]
    AddrNotMatchingDll {
        #[source]
        source: io::Error,
    },

    #[error("dynamic library error: {source}")]
    Dlopen {
        #[source]
        source: dlopen2::Error,
    },
}

impl LoaderError {
    pub fn from_open_error(path: PathBuf, error: dlopen2::Error) -> Self {
        match error {
            dlopen2::Error::OpeningLibraryError(source) => Self::OpenLibrary { path, source },
            source => Self::Dlopen { source },
        }
    }
}

impl From<dlopen2::Error> for LoaderError {
    fn from(error: dlopen2::Error) -> Self {
        match error {
            dlopen2::Error::NullCharacter(source) => Self::NullCharacter { source },

            dlopen2::Error::OpeningLibraryError(source) => Self::OpenLibrary {
                path: PathBuf::new(),
                source,
            },

            dlopen2::Error::SymbolGettingError(source) => Self::SymbolGetting { source },

            dlopen2::Error::NullSymbol => Self::NullSymbol,

            dlopen2::Error::AddrNotMatchingDll(source) => Self::AddrNotMatchingDll { source },
        }
    }
}