lief 0.17.3__cp38-cp38-musllinux_1_2_x86_64.whl

lief/assembly/x86/operands/__init__.pyi

@@ -0,0 +1,32 @@
+from typing import Iterator, Optional, Union
+
+import lief.assembly.x86
+
+
+class Immediate(lief.assembly.x86.Operand):
+    @property
+    def value(self) -> int: ...
+
+class Register(lief.assembly.x86.Operand):
+    @property
+    def value(self) -> lief.assembly.x86.REG: ...
+
+class Memory(lief.assembly.x86.Operand):
+    @property
+    def base(self) -> lief.assembly.x86.REG: ...
+
+    @property
+    def scaled_register(self) -> lief.assembly.x86.REG: ...
+
+    @property
+    def segment_register(self) -> lief.assembly.x86.REG: ...
+
+    @property
+    def scale(self) -> int: ...
+
+    @property
+    def displacement(self) -> int: ...
+
+class PCRelative(lief.assembly.x86.Operand):
+    @property
+    def value(self) -> int: ...

lief/dsc/__init__.pyi

@@ -0,0 +1,226 @@
+from collections.abc import Sequence
+import enum
+import os
+from typing import Iterator, Optional, Union, overload
+
+import lief
+import lief.MachO
+import lief.assembly
+
+
+@overload
+def enable_cache() -> bool: ...
+
+@overload
+def enable_cache(target_cache_dir: Union[str | os.PathLike]) -> bool: ...
+
+class DyldSharedCache:
+    class VERSION(enum.Enum):
+        UNKNOWN = 0
+
+        DYLD_95_3 = 1
+
+        DYLD_195_5 = 2
+
+        DYLD_239_3 = 3
+
+        DYLD_360_14 = 4
+
+        DYLD_421_1 = 5
+
+        DYLD_832_7_1 = 6
+
+        DYLD_940 = 7
+
+        DYLD_1042_1 = 8
+
+        DYLD_1231_3 = 9
+
+        DYLD_1284_13 = 10
+
+        UNRELEASED = 11
+
+    class PLATFORM(enum.Enum):
+        UNKNOWN = 0
+
+        MACOS = 1
+
+        IOS = 2
+
+        TVOS = 3
+
+        WATCHOS = 4
+
+        BRIDGEOS = 5
+
+        IOSMAC = 6
+
+        IOS_SIMULATOR = 7
+
+        TVOS_SIMULATOR = 8
+
+        WATCHOS_SIMULATOR = 9
+
+        DRIVERKIT = 10
+
+        VISIONOS = 11
+
+        VISIONOS_SIMULATOR = 12
+
+        FIRMWARE = 13
+
+        SEPOS = 14
+
+        ANY = 4294967295
+
+    class ARCH(enum.Enum):
+        UNKNOWN = 0
+
+        I386 = 1
+
+        X86_64 = 2
+
+        X86_64H = 3
+
+        ARMV5 = 4
+
+        ARMV6 = 5
+
+        ARMV7 = 6
+
+        ARM64 = 7
+
+        ARM64E = 8
+
+    @staticmethod
+    def from_path(path: str, arch: str = '') -> Optional[DyldSharedCache]: ...
+
+    @staticmethod
+    def from_files(files: Sequence[str]) -> Optional[DyldSharedCache]: ...
+
+    @property
+    def filename(self) -> str: ...
+
+    @property
+    def version(self) -> DyldSharedCache.VERSION: ...
+
+    @property
+    def filepath(self) -> str: ...
+
+    @property
+    def load_address(self) -> int: ...
+
+    @property
+    def arch_name(self) -> str: ...
+
+    @property
+    def platform(self) -> DyldSharedCache.PLATFORM: ...
+
+    @property
+    def arch(self) -> DyldSharedCache.ARCH: ...
+
+    @property
+    def has_subcaches(self) -> bool: ...
+
+    def find_lib_from_va(self, virtual_address: int) -> Optional[Dylib]: ...
+
+    def find_lib_from_path(self, path: str) -> Optional[Dylib]: ...
+
+    def find_lib_from_name(self, name: str) -> Optional[Dylib]: ...
+
+    @property
+    def libraries(self) -> Sequence[Optional[Dylib]]: ...
+
+    @property
+    def mapping_info(self) -> Sequence[Optional[MappingInfo]]: ...
+
+    @property
+    def subcaches(self) -> Sequence[Optional[SubCache]]: ...
+
+    def get_content_from_va(self, addr: int, size: int) -> bytes: ...
+
+    def cache_for_address(self, address: int) -> Optional[DyldSharedCache]: ...
+
+    @property
+    def main_cache(self) -> Optional[DyldSharedCache]: ...
+
+    def find_subcache(self, filename: str) -> Optional[DyldSharedCache]: ...
+
+    def va_to_offset(self, virtual_address: int) -> Union[int, lief.lief_errors]: ...
+
+    def disassemble(self, arg: int, /) -> Iterator[Optional[lief.assembly.Instruction]]: ...
+
+    def enable_caching(self, target_dir: str) -> None: ...
+
+    def flush_cache(self) -> None: ...
+
+@overload
+def load(files: Sequence[str]) -> Optional[DyldSharedCache]: ...
+
+@overload
+def load(path: Union[str | os.PathLike], arch: str = '') -> Optional[DyldSharedCache]: ...
+
+class Dylib:
+    class extract_opt_t:
+        def __init__(self) -> None: ...
+
+        pack: bool
+
+        fix_branches: bool
+
+        fix_memory: bool
+
+        fix_relocations: bool
+
+        fix_objc: bool
+
+        create_dyld_chained_fixup_cmd: bool
+
+    @property
+    def path(self) -> str: ...
+
+    @property
+    def address(self) -> int: ...
+
+    @property
+    def modtime(self) -> int: ...
+
+    @property
+    def inode(self) -> int: ...
+
+    @property
+    def padding(self) -> int: ...
+
+    def get(self, opt: Dylib.extract_opt_t = ...) -> Optional[lief.MachO.Binary]: ...
+
+class SubCache:
+    @property
+    def uuid(self) -> list[int]: ...
+
+    @property
+    def vm_offset(self) -> int: ...
+
+    @property
+    def suffix(self) -> str: ...
+
+    @property
+    def cache(self) -> Optional[DyldSharedCache]: ...
+
+class MappingInfo:
+    @property
+    def address(self) -> int: ...
+
+    @property
+    def size(self) -> int: ...
+
+    @property
+    def end_address(self) -> int: ...
+
+    @property
+    def file_offset(self) -> int: ...
+
+    @property
+    def max_prot(self) -> int: ...
+
+    @property
+    def init_prot(self) -> int: ...

lief/dwarf/__init__.pyi

@@ -0,0 +1,306 @@
+import enum
+import os
+from typing import Iterator, Optional, Union, overload
+
+from . import (
+    editor as editor,
+    parameters as parameters,
+    types as types
+)
+import lief
+import lief.assembly
+
+
+def load(path: Union[str | os.PathLike]) -> Optional[DebugInfo]: ...
+
+class Scope:
+    class TYPE(enum.Enum):
+        UNKNOWN = 0
+
+        UNION = 1
+
+        CLASS = 2
+
+        STRUCT = 3
+
+        NAMESPACE = 4
+
+        FUNCTION = 5
+
+        COMPILATION_UNIT = 6
+
+    @property
+    def name(self) -> str: ...
+
+    @property
+    def parent(self) -> Optional[Scope]: ...
+
+    @property
+    def type(self) -> Scope.TYPE: ...
+
+    def chained(self, sep: str = '::') -> str: ...
+
+class Type:
+    class KIND(enum.Enum):
+        UNKNOWN = 0
+
+        UNSPECIFIED = 1
+
+        BASE = 2
+
+        CONST_KIND = 3
+
+        CLASS = 4
+
+        ARRAY = 5
+
+        POINTER = 6
+
+        STRUCT = 7
+
+        UNION = 8
+
+        TYPEDEF = 9
+
+        REF = 10
+
+        SET_TYPE = 11
+
+        STRING = 12
+
+        SUBROUTINE = 13
+
+        POINTER_MEMBER = 14
+
+        PACKED = 15
+
+        FILE = 16
+
+        THROWN = 17
+
+        VOLATILE = 18
+
+        RESTRICT = 19
+
+        INTERFACE = 20
+
+        SHARED = 21
+
+        RVALREF = 22
+
+        TEMPLATE_ALIAS = 23
+
+        COARRAY = 24
+
+        DYNAMIC = 25
+
+        ATOMIC = 26
+
+        IMMUTABLE = 27
+
+        ENUM = 28
+
+    @property
+    def kind(self) -> Type.KIND: ...
+
+    @property
+    def name(self) -> Optional[str]: ...
+
+    @property
+    def size(self) -> Optional[int]: ...
+
+    @property
+    def location(self) -> lief.debug_location_t: ...
+
+    @property
+    def is_unspecified(self) -> bool: ...
+
+    @property
+    def scope(self) -> Optional[Scope]: ...
+
+class Variable:
+    @property
+    def name(self) -> str: ...
+
+    @property
+    def linkage_name(self) -> str: ...
+
+    @property
+    def address(self) -> Optional[int]: ...
+
+    @property
+    def size(self) -> Optional[int]: ...
+
+    @property
+    def is_constexpr(self) -> bool: ...
+
+    @property
+    def debug_location(self) -> lief.debug_location_t: ...
+
+    @property
+    def type(self) -> Optional[Type]: ...
+
+    @property
+    def scope(self) -> Optional[Scope]: ...
+
+class Function:
+    @property
+    def name(self) -> str: ...
+
+    @property
+    def linkage_name(self) -> str: ...
+
+    @property
+    def address(self) -> Optional[int]: ...
+
+    @property
+    def variables(self) -> Iterator[Optional[Variable]]: ...
+
+    @property
+    def is_artificial(self) -> bool: ...
+
+    @property
+    def is_external(self) -> bool: ...
+
+    @property
+    def size(self) -> int: ...
+
+    @property
+    def ranges(self) -> list[lief.range_t]: ...
+
+    @property
+    def debug_location(self) -> lief.debug_location_t: ...
+
+    @property
+    def type(self) -> Optional[Type]: ...
+
+    @property
+    def parameters(self) -> list[Optional[Parameter]]: ...
+
+    @property
+    def thrown_types(self) -> list[Optional[Type]]: ...
+
+    @property
+    def scope(self) -> Optional[Scope]: ...
+
+    @property
+    def instructions(self) -> Iterator[Optional[lief.assembly.Instruction]]: ...
+
+class Parameter:
+    @property
+    def name(self) -> str: ...
+
+    @property
+    def type(self) -> Optional[Type]: ...
+
+class CompilationUnit:
+    class Language:
+        class LANG(enum.Enum):
+            @staticmethod
+            def from_value(arg: int, /) -> CompilationUnit.Language.LANG: ...
+
+            def __eq__(self, arg, /) -> bool: ...
+
+            def __ne__(self, arg, /) -> bool: ...
+
+            def __int__(self) -> int: ...
+
+            UNKNOWN = 0
+
+            C = 1
+
+            CPP = 2
+
+            RUST = 3
+
+            DART = 4
+
+            MODULA = 5
+
+            FORTRAN = 6
+
+            SWIFT = 7
+
+            D = 8
+
+            JAVA = 9
+
+            COBOL = 10
+
+        lang: CompilationUnit.Language.LANG
+
+        version: int
+
+    @property
+    def name(self) -> str: ...
+
+    @property
+    def producer(self) -> str: ...
+
+    @property
+    def compilation_dir(self) -> str: ...
+
+    @property
+    def language(self) -> CompilationUnit.Language: ...
+
+    @property
+    def low_address(self) -> int: ...
+
+    @property
+    def high_address(self) -> int: ...
+
+    @property
+    def size(self) -> int: ...
+
+    @property
+    def ranges(self) -> list[lief.range_t]: ...
+
+    @overload
+    def find_function(self, name: str) -> Optional[Function]: ...
+
+    @overload
+    def find_function(self, addr: int) -> Optional[Function]: ...
+
+    @overload
+    def find_variable(self, addr: int) -> Optional[Variable]: ...
+
+    @overload
+    def find_variable(self, name: str) -> Optional[Variable]: ...
+
+    @property
+    def types(self) -> Iterator[Optional[Type]]: ...
+
+    @property
+    def functions(self) -> Iterator[Optional[Function]]: ...
+
+    @property
+    def imported_functions(self) -> Iterator[Optional[Function]]: ...
+
+    @property
+    def variables(self) -> Iterator[Optional[Variable]]: ...
+
+class DebugInfo(lief.DebugInfo):
+    @overload
+    def find_function(self, name: str) -> Optional[Function]: ...
+
+    @overload
+    def find_function(self, addr: int) -> Optional[Function]: ...
+
+    @overload
+    def find_variable(self, addr: int) -> Optional[Variable]: ...
+
+    @overload
+    def find_variable(self, name: str) -> Optional[Variable]: ...
+
+    def find_type(self, name: str) -> Optional[Type]: ...
+
+    @property
+    def compilation_units(self) -> Iterator[Optional[CompilationUnit]]: ...
+
+class Editor:
+    @staticmethod
+    def from_binary(bin: lief.Binary) -> Optional[Editor]: ...
+
+    def create_compilation_unit(self) -> Optional[editor.CompilationUnit]: ...
+
+    def write(self, output: Union[str | os.PathLike]) -> None: ...

lief/dwarf/editor/__init__.pyi

@@ -0,0 +1,138 @@
+from collections.abc import Sequence
+import enum
+from typing import Iterator, Optional, Union, overload
+
+
+class Type:
+    def pointer_to(self) -> Optional[PointerType]: ...
+
+class PointerType(Type):
+    pass
+
+class EnumType(Type):
+    class Value:
+        pass
+
+    def set_size(self, size: int) -> EnumType: ...
+
+    def add_value(self, name: str, value: int) -> Optional[EnumType.Value]: ...
+
+class BaseType(Type):
+    class ENCODING(enum.Enum):
+        NONE = 0
+
+        ADDRESS = 1
+
+        SIGNED = 2
+
+        SIGNED_CHAR = 3
+
+        UNSIGNED = 4
+
+        UNSIGNED_CHAR = 5
+
+        BOOLEAN = 6
+
+        FLOAT = 7
+
+class ArrayType(Type):
+    pass
+
+class FunctionType(Type):
+    class Parameter:
+        pass
+
+    def set_return_type(self, type: Type) -> FunctionType: ...
+
+    def add_parameter(self, type: Type) -> Optional[FunctionType.Parameter]: ...
+
+class TypeDef(Type):
+    pass
+
+class StructType(Type):
+    class TYPE(enum.Enum):
+        CLASS = 0
+
+        STRUCT = 1
+
+        UNION = 2
+
+    class Member:
+        pass
+
+    def set_size(self, size: int) -> StructType: ...
+
+    def add_member(self, name: str, type: Type, offset: int = -1) -> Optional[StructType.Member]: ...
+
+class Function:
+    class range_t:
+        @overload
+        def __init__(self) -> None: ...
+
+        @overload
+        def __init__(self, start: int, end: int) -> None: ...
+
+        start: int
+
+        end: int
+
+    class Parameter:
+        pass
+
+    class LexicalBlock:
+        pass
+
+    class Label:
+        pass
+
+    def set_address(self, addr: int) -> Function: ...
+
+    def set_low_high(self, low: int, high: int) -> Function: ...
+
+    def set_ranges(self, ranges: Sequence[Function.range_t]) -> Function: ...
+
+    def set_external(self) -> Function: ...
+
+    def set_return_type(self, type: Type) -> Function: ...
+
+    def add_parameter(self, name: str, type: Type) -> Optional[Function.Parameter]: ...
+
+    def create_stack_variable(self, name: str) -> Optional[Variable]: ...
+
+    def add_lexical_block(self, start: int, end: int) -> Optional[Function.LexicalBlock]: ...
+
+    def add_label(self, addr: int, label: str) -> Optional[Function.Label]: ...
+
+class Variable:
+    def set_addr(self, addr: int) -> Variable: ...
+
+    def set_stack_offset(self, offset: int) -> Variable: ...
+
+    def set_external(self) -> Variable: ...
+
+    def set_type(self, type: Type) -> Variable: ...
+
+class CompilationUnit:
+    def set_producer(self, arg: str, /) -> CompilationUnit: ...
+
+    def create_function(self, name: str) -> Optional[Function]: ...
+
+    def create_variable(self, name: str) -> Optional[Variable]: ...
+
+    def create_generic_type(self, name: str) -> Optional[Type]: ...
+
+    def create_enum(self, name: str) -> Optional[EnumType]: ...
+
+    def create_typedef(self, name: str, ty: Type) -> Optional[TypeDef]: ...
+
+    def create_structure(self, name: str, kind: StructType.TYPE = StructType.TYPE.STRUCT) -> Optional[StructType]: ...
+
+    def create_base_type(self, name: str, size: int, encoding: BaseType.ENCODING = BaseType.ENCODING.NONE) -> Optional[BaseType]: ...
+
+    def create_function_type(self, name: str) -> Optional[FunctionType]: ...
+
+    def create_pointer_type(self, ty: Type) -> Optional[PointerType]: ...
+
+    def create_void_type(self) -> Optional[Type]: ...
+
+    def create_array(self, name: str, ty: Type, count: int) -> Optional[ArrayType]: ...

lief/dwarf/parameters/__init__.pyi

@@ -0,0 +1,14 @@
+from typing import Iterator, Optional, Union
+
+import lief.dwarf
+
+
+class Formal(lief.dwarf.Parameter):
+    @property
+    def type(self) -> Optional[lief.dwarf.Type]: ...
+
+class TemplateValue(lief.dwarf.Parameter):
+    pass
+
+class TemplateType(lief.dwarf.Parameter):
+    pass