Provide lief-patchelf: a LIEF-based implementation of NixOS's patchelf

Related: NixOS/patchelf#568
Support: NixOS/patchelf#596

Author: romainthomas

.gitignore

@@ -8,4 +8,5 @@ lief.egg-info/
 dist/
 api/rust/cargo/target/*
 api/rust/examples/target/*
+tools/target/*
 plugins/ghidra/bin/

api/python/lief/ART/__init__.pyi

@@ -22,7 +22,7 @@ def parse(filename: str) -> Optional[File]: ...
 def parse(raw: Sequence[int], name: str = '') -> Optional[File]: ...
 
 @overload
-def parse(obj: Union[io.IOBase | os.PathLike | bytes | list[int]], name: str = '') -> Optional[File]: ...
+def parse(obj: Union[str | io.IOBase | os.PathLike | bytes | list[int]], name: str = '') -> Optional[File]: ...
 
 class File(lief.Object):
     @property

api/python/lief/COFF/__init__.pyi

@@ -137,7 +137,7 @@ class ParserConfig:
 
     default_conf: ParserConfig = ...
 
-def parse(obj: Union[io.IOBase | os.PathLike | bytes | list[int]], config: ParserConfig = ...) -> Optional[Binary]: ...
+def parse(obj: Union[str | io.IOBase | os.PathLike | bytes | list[int]], config: ParserConfig = ...) -> Optional[Binary]: ...
 
 class String:
     string: str

api/python/lief/DEX/__init__.pyi

@@ -55,7 +55,7 @@ def parse(filename: str) -> Optional[File]: ...
 def parse(raw: Sequence[int], name: str = '') -> Optional[File]: ...
 
 @overload
-def parse(obj: Union[io.IOBase | os.PathLike | bytes | list[int]], name: str = '') -> Optional[File]: ...
+def parse(obj: Union[str | io.IOBase | os.PathLike | bytes | list[int]], name: str = '') -> Optional[File]: ...
 
 class File(lief.Object):
     class it_classes:

api/python/lief/ELF/__init__.pyi

@@ -414,7 +414,7 @@ class ParserConfig:
 
     all: ParserConfig = ...
 
-def parse(obj: Union[io.IOBase | os.PathLike | bytes | list[int]], config: ParserConfig = ...) -> Optional[Binary]: ...
+def parse(obj: Union[str | io.IOBase | os.PathLike | bytes | list[int]], config: ParserConfig = ...) -> Optional[Binary]: ...
 
 class SymbolVersion(lief.Object):
     @overload
@@ -853,6 +853,10 @@ class Binary(lief.Binary):
 
     def get_relocated_dynamic_array(self, array_tag: DynamicEntry.TAG) -> list[int]: ...
 
+    def find_version_requirement(self, libname: str) -> SymbolVersionRequirement: ...
+
+    def remove_version_requirement(self, libname: str) -> bool: ...
+
     @overload
     def __iadd__(self, arg: Segment, /) -> Binary: ...
 
@@ -4776,13 +4780,19 @@ class SysvHash(lief.Object):
     def __str__(self) -> str: ...
 
 class Builder:
-    def __init__(self, elf_binary: Binary) -> None: ...
+    @overload
+    def __init__(self, elf: Binary) -> None: ...
+
+    @overload
+    def __init__(self, elf: Binary, config: Builder.config_t) -> None: ...
 
     class config_t:
         def __init__(self) -> None: ...
 
         force_relocate: bool
 
+        skip_dynamic: bool
+
         dt_hash: bool
 
         dyn_str: bool
@@ -4819,9 +4829,12 @@ class Builder:
 
         coredump_notes: bool
 
+        keep_empty_version_requirement: bool
+
     def build(self) -> None: ...
 
-    config: Builder.config_t
+    @property
+    def config(self) -> Builder.config_t: ...
 
     def write(self, output: str) -> None: ...
 

api/python/lief/MachO/__init__.pyi

@@ -265,7 +265,7 @@ class ParserConfig:
 
 def parse_from_memory(address: int, config: ParserConfig = ...) -> Optional[FatBinary]: ...
 
-def parse(obj: Union[io.IOBase | os.PathLike | bytes | list[int]], config: ParserConfig = ...) -> Optional[FatBinary]: ...
+def parse(obj: Union[str | io.IOBase | os.PathLike | bytes | list[int]], config: ParserConfig = ...) -> Optional[FatBinary]: ...
 
 class ChainedPointerAnalysis:
     class dyld_chained_ptr_arm64e_rebase_t:

api/python/lief/OAT/__init__.pyi

@@ -105,7 +105,7 @@ def parse(oat_file: str, vdex_file: str) -> Optional[Binary]: ...
 def parse(raw: Sequence[int]) -> Optional[Binary]: ...
 
 @overload
-def parse(obj: Union[io.IOBase | os.PathLike | bytes | list[int]]) -> Optional[Binary]: ...
+def parse(obj: Union[str | io.IOBase | os.PathLike | bytes | list[int]]) -> Optional[Binary]: ...
 
 class Binary(lief.ELF.Binary):
     class it_dex_files:

api/python/lief/PE/__init__.pyi

@@ -100,7 +100,7 @@ class ParserConfig:
 
     def __str__(self) -> str: ...
 
-def parse(obj: Union[io.IOBase | os.PathLike | bytes | list[int]], config: ParserConfig = ...) -> Optional[Binary]: ...
+def parse(obj: Union[str | io.IOBase | os.PathLike | bytes | list[int]], config: ParserConfig = ...) -> Optional[Binary]: ...
 
 class DosHeader(lief.Object):
     @staticmethod

api/python/lief/VDEX/__init__.pyi

@@ -12,7 +12,7 @@ import lief.OAT
 def parse(filename: str) -> Optional[File]: ...
 
 @overload
-def parse(obj: Union[io.IOBase | os.PathLike | bytes | list[int]], name: str = '') -> Optional[File]: ...
+def parse(obj: Union[str | io.IOBase | os.PathLike | bytes | list[int]], name: str = '') -> Optional[File]: ...
 
 class File(lief.Object):
     @property

api/python/lief/__init__.pyi

@@ -466,7 +466,7 @@ class Symbol(Object):
 
     def __str__(self) -> str: ...
 
-def parse(obj: Union[io.IOBase | os.PathLike | bytes | list[int]]) -> PE.Binary | OAT.Binary | ELF.Binary | MachO.Binary | COFF.Binary | None: ...
+def parse(obj: Union[str | io.IOBase | os.PathLike | bytes | list[int]]) -> PE.Binary | OAT.Binary | ELF.Binary | MachO.Binary | COFF.Binary | None: ...
 
 class Relocation(Object):
     address: int