LIEF Docs Extended Sponsor

Changelog

2.0.0 - Not Released Yet

Breaking Changes

Assembly:
ELF:

  • Fix the layout of the segments added by LIEF for the architectures that can use pages larger than 4K (#1366)

  • Fix the modification of binaries that have already been modified by LIEF. The segment table was relocated a second time which, for the non-PIE binaries, shifted the sections without shifting the segments nor the dynamic entries. It resulted in a DT_STRTAB that was no longer pointing to .dynstr (i.e. garbage DT_NEEDED/DT_RUNPATH names) and in a PT_PHDR that was not wrapped by a PT_LOAD segment (#1366).

  • lief.ELF.check_layout() LIEF::ELF::check_layout() lief::elf::check_layout
    now reports the PT_LOAD segments that can’t be mapped independently because they share the same page. It also report mismatch between .dynstr virtual address and DT_STRTAB.
COFF:

1.0.0 - July 12th, 2026

Runtime

LIEF now provides runtime features as described here: Runtime

BinaryNinja:
Ghidra:

  • Add support for generating DWARF from firmware or binaries without a precise format or architecture (#1249)

DWARF:
PDB:
ELF:
COFF:
Mach-O:
PE:
ObjC:
Assembly:
Rust:

Warning

The Minimum Supported Rust Version (MSRV) is now 1.85.0 (previously 1.74.0).

  • The Rust FFI no longer relies on autocxx and bindgen. It is now built on top of plain cxx, which simplifies the bindings and reduces the iteration time

  • The Rust bindings directory has been renamed from api/rust/cargo/ to api/rust/crates/

  • Add support for the aarch64-linux-android and x86_64-linux-android targets

C++:

  • Add LIEF_LIFETIMEBOUND annotations wrapping [[clang::lifetimebound]] to leverage Clang’s lifetime analysis. This helps detect dangling references at compile time for methods that return references or iterators tied to an object’s lifetime:

    // Clang can now warn about this dangling reference:
auto& hdr = LIEF::ELF::Parser::parse("a.out")->header();
LIEF_INFO("{}", hdr.header_size());
// /src/src/ELF/Binary.cpp:63:15: error: object whose reference is captured
// does not live long enough [-Werror,-Wlifetime-safety-use-after-scope]
//    63 |   auto& hdr = LIEF::ELF::Parser::parse("a.out")->header();
//       |               ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
// /src/src/ELF/Binary.cpp:63:47: note: destroyed here
//    63 |   auto& hdr = LIEF::ELF::Parser::parse("a.out")->header();
//       |                                               ^
// /src/src/ELF/Binary.cpp:64:19: note: later used here
//    64 |   LIEF_INFO("{}", hdr.header_size());
Dependencies:

  • Update nanobind to version v2.13.x

  • Update tl-expected to version 1.3.1

  • Update utfcpp to version 4.0.9

  • Update frozen to commit 61dce5a

  • Update spdlog to version 1.17.0

  • Update mbedtls to version 4.0.0

Extended:

  • Use LLVM 22.x

  • Add support to directly download a package from the History:

_images/lief-extended-history-link.webp
Python:

  • Python 3.8 is no longer supported

  • Add support for the free-threaded Python builds. The C++ core is now thread-safe with respect to its few static variables, and can be used when the GIL is disabled (#1255):

    from concurrent.futures import ThreadPoolExecutor
import lief

def strip(path: str) -> None:
    binary = lief.ELF.parse(path)
    binary.strip()
    binary.write(f"{path}.stripped")

with ThreadPoolExecutor() as pool:
    pool.map(strip, ["/bin/ls", "/bin/cat", "/bin/echo"])

0.17.6 - March 18th, 2026

ELF:

  • Fix alignment for PHDR/SHDR and improve TLS/RELR handling (#1315)

  • Skip NOBITS sections in layout calculations and improve index retrieval (related to #1315)

PE:

0.17.5 - March 8th, 2026

ELF:

  • Add missing segments in X86_64 coredump parser (#1278)

  • Add TLSDESC_PLT and TLSDESC_GOT to ELF dynamic tags (#1311)

  • Fix dynamic entry shifting for Android relocations (#1309)

MachO:

  • Fix DyldInfo::show_bindings integer overflow (#1313)

0.17.4 - February 21st, 2026

PE:
MachO:
COFF:

  • Resolved a compilation conflict with the Windows minwindef.h macro #define max.

CMake:

  • Fixed compiler flag issues on Windows when compiling with clang-cl (by sigewinnefish in PR #1306).

Python:

  • Bumped various Python backend build dependencies in api/python/build-requirements.txt to support Python 3.14 when compiling from sources (#1304).

0.17.3 - January 24th, 2026

PE:

  • Fixed bug with resources (#1281).

  • Fixed VA/RVA confusion in the PE builder (#1284).

0.17.2 - January 3rd, 2026

Mach-O:

  • Differentiate Mach-O FAT magic bytes and Java classes (by wangmot, #1215).

Compilation:
PE:

  • Fixed alignment issue when rebuilding PE relocations (#1261).

  • Fixed infinite loop when processing v2 dynamic relocations (by chengyongru, fixing #1273).

ELF:

  • Ensure that added DYN ELF sections are properly aligned (by schmchrt, fixing #1261).

  • Fixed GnuHash null dereference (#1277).

Mach-O:

  • Fixed major performance issue when parsing certain Mach-O files (by trevor-e, fixing #1262).

0.17.1 - October 25th, 2025

ELF:
Compilation:

  • Fixed missing visibility (#1254).

  • Fixed incorrect paging computations that occurred when only a subset of formats was enabled.

  • Fixed include issue with the COFF format.

0.17.0 - September 14th, 2025

BinaryNinja & Ghidra Plugins

LIEF-based plugins for Binary Ninja and Ghidra have been bootstrapped here:

LIEF Tools

I initiated a Tools section which aims at providing utilities based on LIEF (mostly CLI):

Assembler:
DSC:

  • Add enum for the latest dyld shared cache version introducing changes in the header layout (dyld-1284.13 - 2025-04-25)

       uint64_t    dynamicDataOffset;
   uint64_t    dynamicDataMaxSize;
   uint32_t    tproMappingsOffset;
   uint32_t    tproMappingsCount;
+  uint64_t    functionVariantInfoAddr;
+  uint64_t    functionVariantInfoSize;
+  uint64_t    prewarmingDataOffset;
+  uint64_t    prewarmingDataSize;
};

  • Add enum for the latest dyld shared cache version introducing changes in the header layout (dyld-1231.3 - 2024-09-24)

       uint64_t    dynamicDataOffset;
   uint64_t    dynamicDataMaxSize;
+  uint32_t    tproMappingsOffset;
+  uint32_t    tproMappingsCount;
};

  • Fix symbol resolution issue: #1127

PE:
COFF:
Mach-O:
ELF:
DWARF:

  • LIEF extended can now process DWARF debug info in PE binaries

  • Add support for creating DWARF: DWARF Editor (require extended version >= 0.17.0.2623)

PDB:
OAT:
import lief

# Before LIEF 0.17.0 this function returned a lief.OAT.Binary object
lief.parse("CallDeviceId.oat")

# Since LIEF 0.17.0 this function returns a lief.ELF.Binary object
lief.parse("CallDeviceId.oat")

# Return a lief.OAT.Binary object
lief.OAT.parse("CallDeviceId.oat")
Abstraction:
Extended:

  • Fix issue in the Python bindings while trying to access lief.__LIEF_MAIN_COMMIT__

  • Fix CMake issue with find_package(lief-extended)

  • Use LLVM 21.1.x

Build System:

  • LIEF is now available in vcpkg. Many thanks to luadebug for this support.

Dependencies:

  • Move to tl-expected 1.2.0

  • Move to utfcpp 4.0.6

  • Move to mbedtls 3.6.4

  • Move to spdlog 1.15.3

  • Move to nlohmann/json 3.12.0

  • Upgrade nanobind to version v2.8.x

Utilities:

0.16.7 - October 5th, 2025

Python:

  • Add wheels for Python 3.14

Mach-O:
ELF:
Other:

0.16.6 - May 29th, 2025

Compilation:
Mach-O:
Python:

  • Fix Python logger warning

Other:

0.16.5 - April 19th, 2025

ELF:

  • Relax the condition over the DT_SYMENT entry (#1177)

Mach-O:
Compilation:

  • Fix compilation issue when targeting Linux i386/i686 (#1189)

  • Better support for external fmt library

  • Fix fmt unicode issue

  • Fix missing cstdio (#1184)

Packages:

  • Add Python, Rust, SDK packages for Windows ARM64 (aarch64-pc-windows-msvc)

  • Add Python, Rust, SDK packages for Linux Musl ARM64 (aarch64-unknown-linux-musl)

  • Add Python, Rust, SDK packages for Linux Musl i686 (i686-unknown-linux-musl)

0.16.4 - February 23rd, 2025

Python:

  • Relax checks on the enum verification. As described in #1170 and #1172, an invalid enum led to an unrecoverable error. The new behavior now returns the raw int value if it can’t be converted into the given enum.

  • Upgrade nanobind to version v2.5.0

PE:

  • Fix export forwarding issue (#1168)

MachO:

  • Fix truncated nlist_t.n_type when rewriting a Mach-O binary

0.16.3 - February 1st, 2025

ELF:

  • Fix issue when parsing the dynamic table with an invalid offset (bug found by lebr0nli)

  • Fix endianness issue with IA64 binaries (#1164)

PE:

  • Fix missing original forwarded function name (#1166)

Misc:

  • Add support for spdlog compiled with SPDLOG_WCHAR_FILENAMES (#1147)

0.16.2 - January 1st, 2025

Compilation:

  • Fix broken aarch64 Python wheel which is related to a toolchain issue (#1146)

0.16.1 - December 26th, 2024

MachO:
Rust:

  • Fix min-rustc version issue (see: 75a27f0)

Compilation:

0.16.0 - December 10th, 2024

Abstraction:
MachO:
PE:

  • Fix authenticode error while reading RSA PKCS#1 1.5 padding

ELF:
Rust:
ObjC:
DWARF:
Extended:

Note

  • LIEF extended is now open to everyone

  • C++ SDK is now available

  • Rust package is now available

Python Bindings:

  • Upgrade nanobind from 1.8.0 to 2.4.0

  • *.pyi stubs are now generated by nanobind (replacing mypy’s stugen)

Dependencies:

  • Upgrade MbedTLS from 3.2.1 to 3.6.1

doc:

0.15.1 - July 23th, 2024

MachO:

  • Fix missing commit for .hwx support

0.15.0 - July 21th, 2024

Extended:

Note

See: https://extended.lief.re and What is LIEF Extended?

Repo:

  • master branch has been renamed main

Rust:

  • First (beta) release of the bindings (c.f. Rust)

ELF:
PE:
MachO:
CMake:

  • LIEFConfig.cmake is now installed in <prefix>/lib/cmake/LIEF/ instead of <prefix>/share/LIEF/cmake/

Python Bindings:

Warning

These warnings does not necessarily mean that LIEF leak objects. These warnings might happen in Cyclic garbage collection.

Documentation:

  • Add icons

  • Include inheritance diagram for Python API (e.g. lief.ELF.Note)

0.14.1 - February 11th, 2024

ELF:

  • Fix regression in Symbol Version Definition processing (#1014)

PE:
Python:

  • Fix regression in iterator’s performances

0.14.0 - January 20, 2024

ELF:

  • Add support for the GNU note properies (#975).

    Example:
    elf = lief.ELF.parse("...")
note = elf.get(lief.ELF.Note.TYPE.GNU_PROPERTY_TYPE_0)
aarch64_feat: lief.ELF.AArch64Feature = note.find(lief.ELF.NoteGnuProperty.Property.TYPE.AARCH64_FEATURES)
if lief.ELF.AArch64Feature.FEATURE.BTI in aarch64_feat.features:
    print("BTI supported")

    See:

  • Refactoring of the ELF note processing

  • Fix relocation issue when using -Wl,--emit-relocs (c.f. #897 / #898 by adamjseitz)

  • Improve the computation of the dynamic symbols thanks to adamjseitz (c.f. #922)

  • Add support for the LoongArch architecture thanks to loongson-zn (c.f. #921)

  • Add a lief.ELF.ParserConfig interface that can be used to tweak which parts of the ELF format should be parsed.

    Example:
    config = lief.ELF.ParserConfig()

# Skip parsing static and dynamic symbols
config.parse_static_symbols = False
config.parse_dyn_symbols = False

elf = lief.ELF.parse("target.elf", config)
MachO:
PE:

  • RESOURCE_SUBLANGS has been removed

  • RESOURCE_LANGS is now defined in a dedicated header: LIEF/PE/resources/langs.hpp

  • RESOURCE_TYPES is now scoped in ResourcesManager::TYPE

  • GUARD_CF_FLAGS is now scoped as IMAGE_GUARD in lief.PE.LoadConfigurationV1

  • SECTION_CHARACTERISTICS is now scoped within the Section class instead of being globally defined:

    # Before
lief.PE.SECTION_CHARACTERISTICS.CNT_CODE
# Now:
lief.PE.Section.CHARACTERISTICS.CNT_CODE

  • DATA_DIRECTORY is now scoped within the DataDirectory class instead of being globally defined:

    # Before
lief.PE.DATA_DIRECTORY.IAT
# Now:
lief.PE.DataDirectory.TYPES.IAT

  • MACHINE_TYPES and HEADER_CHARACTERISTICS are now scoped within the Header class instead of being globally defined:

    # Before
lief.PE.MACHINE_TYPES.AMD64
# Now:
lief.PE.Header.MACHINE_TYPES.AMD64

  • lief.PE.Header.characteristics now returns a list/std::vector instead of a set.

  • lief.PE.OptionalHeader.dll_characteristics_lists now returns a list/std::vector instead of a set.

  • SUBSYSTEM and DLL_CHARACTERISTICS are now scoped within the OptionalHeader class instead of being globally defined:

    # Before
lief.PE.SUBSYSTEM.NATIVE
# Now:
lief.PE.OptionalHeader.SUBSYSTEM.NATIVE

  • lief.PE.DosHeader.used_bytes_in_the_last_page has been renamed in lief.PE.DosHeader.used_bytes_in_last_page

  • Refactoring of the Debug directory processing: lief.PE.Debug is now the root class of: lief.PE.CodeView / lief.PE.CodeView, lief.PE.Pogo, lief.PE.Repro.

    The parsing logic has been cleaned and the tests updated.

  • Add a lief.PE.ParserConfig interface that can be used to tweak which parts of the PE format should be parsed (#839).

    Example:
    config = lief.PE.ParserConfig()

# Skip parsing PE authenticode
config.parse_signature = False

pe = lief.PE.parse("pe.exe", config)
Abstraction:

  • LIEF::EXE_FORMATS is now scoped in LIEF::Binary::FORMATS

  • All the Binary classes now implement classof:

    std::unique_ptr<LIEF::Binary> bin = LIEF::Parser::parse("...");
if (LIEF::PE::Binary::classof(bin.get())) {
  auto& pe_file = static_cast<LIEF::PE::Binary&>(*bin);
}
General Design:

  • Python parser functions (like: lief.PE.parse()) now accept os.PathLike arguments like pathlib.Path (#974).

  • Remove the lief.Binary.name attribute

  • LIEF is now compiled with C++17 (the API remains C++11 compliant)

  • Switch to nanobind for the Python bindings.

  • CI are now more efficient.

  • The Python documentation for properties now contains the type of the property.

0.13.2 - June 17, 2023

PE:

Fix authenticode inconsitency (#932)

ELF:

Fix missing undef (#929)

0.13.1 - May 28, 2023

PE:

  • Fix PE authenticode verification issue in the case of special characters (#912)

Misc:

  • Fix mypy stubs (#909)

  • Fix missing include (#918)

  • Fix C99 comments (#916)

  • Fix AArch64 docker image (#904)

0.13.0 - April 9, 2023

ELF:

  • Fix overflow issue in segments (c.f. #845 found by liyansong2018)

  • Fix missing relationship between symbols and sections (c.f. #841)

  • Fix coredump parsing issue (c.f. #830 found by Lan1keA)

  • Fix and (re)enable removing dynamic symbols (c.f. #828)

  • Add support for NT_GNU_BUILD_ATTRIBUTE_OPEN and NT_GNU_BUILD_ATTRIBUTE_FUNC (c.f. #816)

  • [CVE-2022-38497] Fix ELF core parsing issue (#766 found by CCWANG19)

  • [CVE-2022-38306] Fix a heap overflow found by CCWANG19 (#763)

  • aeflores fixed an issue when there are multiple versions associated with a symbol (see: #749 for the details).

  • Handle binaries compiled with the -static-pie flag correctly (see: #747)

  • Add support for modifying section-less binaries. The ELF Section objects gain the lief.ELF.Section.as_frame() method which defines the section as a framed section.

    A framed section is a section that concretely does not wraps data and can be corrupted.

    Example:
    elf = lief.parse("/bin/ssh")
text = elf.get_section(".text").as_frame()

# We can now corrupt all the fields of the section
text.offset  = 0xdeadc0de
text.size    = 0xffffff
text.address = 0x123

elf.write("/tmp/out")

  • Add API to precisely define how the segments table should be relocated. One might want to enforce a certain ELF layout while adding sections/ segments. It is now possible to call the method: relocate_phdr_table() to define how the segments table should be relocated for welcoming the new sections/segments:

    elf = lief.parse("...")
# Enforce a specific relocation type:
# The new segments table will be shift at the end
# of the file
elf.relocate_phdr_table(Binary.PHDR_RELOC.FILE_END)

# Add sections/segments
# [...]
elf.write("out.elf")

    See:

MachO:

  • Add rpaths iterator (#291)

  • Add support for parsing Mach-O in memory

  • Fix a memory issue (found by bladchan via #806)

  • [CVE-2022-40923] Fix parsing issue (#784 found by bladchan)

  • [CVE-2022-40922] Fix parsing issue (#781 found by bladchan)

  • [CVE-2022-38307] Fix a segfault when the Mach-O binary does not have segments (found by CCWANG19 via #764)

  • Enable to create exports

  • Fix the layout of the binaries modified by LIEF such as they can be (re)signed.

  • Add support for LC_DYLD_CHAINED_FIXUPS and LC_DYLD_EXPORTS_TRIE

  • Global enhancement when modifying the __LINKEDIT content

  • Add API to get a Section from a specified segment’s name and section’s name.

Example:
sec = bin.get_section("__DATA", "__objc_metadata")

  • Add API to remove a Section from a specified segment’s name and section’s name.

Example:
sec = bin.remove_section("__DATA", "__objc_metadata")

  • Add lief.MachO.Binary.page_size

PE:

  • The Python API now returns bytes objects instead of List[int]

  • Remove lief.PE.ResourceNode.sort_by_id()

  • Fix the ordering of children of ResourceNode

  • Remove deprecated functions related to PE hooking.

  • Add support for new PE LoadConfiguration structures.

DEX:

  • Fix multiple parsing issues raised by bladchan

Other:
General Design:

  • ZehMatt added the support to write LIEF binaries object through a std::ostream interface (9d55f53)

  • Remove the exceptions

  • The library contains less static initializers which should improve the loading time.

Python Bindings:

  • Move to a build system compliant with pyproject.toml

  • Provide typing stubs: #650

  • PyPI releases no longer provide source distribution (sdist)

Dependencies:

  • Move to spdlog 1.11.0

  • Move to Pybind11 - 2.10.1

  • Move to nlohmann/json 3.11.2

  • Move to MbedTLS 3.2.1

  • Move to utfcpp 3.2.1

0.12.3 - November 1, 2022

This release contains several security fixes:

  • [CVE-2022-38497] Fix ELF core parsing issue (#766 found by CCWANG19)

  • [CVE-2022-38306] Fix a heap overflow found by CCWANG19 (#763)

  • Fix a memory issue (found by bladchan via #806)

  • [CVE-2022-40923] Fix parsing issue (#784 found by bladchan)

  • [CVE-2022-40922] Fix parsing issue (#781 found by bladchan)

  • [CVE-2022-38307] Fix a segfault when the Mach-O binary does not have segments (found by CCWANG19 via #764)

0.12.1 - April 08, 2022

ELF:

  • Fix section inclusion calculations (#692)

PE:
Compilation:

0.12.0 - March 25, 2022

ELF:
MachO:

  • Change the layout of the binaries generated by LIEF such as they are compliant with codesign checks

  • The API to configure the MachO parser has been redesigned to provide a better granularity

    config = lief.MachO.ParserConfig()
config.parse_dyld_bindings = False
config.parse_dyld_exports  = True
config.parse_dyld_rebases  = False

lief.MachO.parse("/tmp/big.macho", config)

  • LucaMoroSyn added the support for the LC_FILESET_ENTRY. This command is usually found in kernel cache files

  • LIEF::MachO::Binary::get_symbol now returns a pointer (instead of a reference). If the symbol can’t be found, it returns a nullptr.

  • Add API to select a Binary from a FatBinary by its architecture. See: lief.MachO.FatBinary.take().

    fat = lief.MachO.parse("/bin/ls")
fit = fat.take(lief.MachO.CPU_TYPES.x86_64)

  • Handle the 0x0D binding opcode (see: #524)

  • xhochy fixed performances issues in the Mach-O parser (see #579)

PE:
DEX:
Abstraction:
Compilation & Integration:

  • ekilmer updated and modernized the CMake integration files through the PR: #674

  • Enable to use a pre-compiled version of spdlog. This feature aims at improving compilation time when developing on LIEF.

    One can provide path to spdlog install through:

    $ python ./setup.py --spdlog-dir=path/to/lib/cmake/spdlog [...]
# or
$ cmake -DLIEF_EXTERNAL_SPDLOG=ON -Dspdlog_DIR=path/to/lib/cmake/spdlog ...

  • Enable to feed LIEF’s dependencies externally (c.f. Third Party)

  • Replace the keywords and, or, not with &&, || and !.

Dependencies:

  • Upgrade to MbedTLS 3.1.0

  • Upgrade Catch2 to 2.13.8

  • The different dependencies can be linked externally (cf. above and Third Party)

Documentation:

  • New section about the errors handling ( Error Handling) and the upcoming deprecation of the exceptions.

  • New section about how to compile LIEF for debugging/developing. See: Debugging

General Design:
span:

LIEF now exposes Section/Segment’s data through a span interface. As std::span is available in the STL from C++20 and the LIEF public API aims at being C++11 compliant, we expose this span thanks to tcbrindle/span. This new interface enables to avoid copies of std::vector<uint8_t> which can be costly. With this new interface, the original std::vector<uint8_t> can be retrieved as follows:

auto bin = LIEF::ELF::Parser::parse("/bin/ls");

if (const auto* section = bin->get_section(".text")) {
  LIEF::span<const uint8_t> text_ref =  section->content();
  std::vector<uint8_t> copy = {std::begin(text_ref), std::end(text_ref)};
}

In Python, span are wrapped by a read-only memory view. The original list of bytes can be retrieved as follows:

bin = lief.parse("/bin/ls")
section = bin.get_section(".text")

if section is not None:
  memory_view = section.content
  list_of_bytes = list(memory_view)
Exceptions:

Warning

We started to refactor the API and the internal design to remove C++ exceptions. These changes are described a the dedicated blog (LIEF RTTI & Exceptions)

To highlighting the content of the blog for the end users, functions that returned a reference and which threw an exception in the case of a failure are now returning a pointer that is set to nullptr in the case of a failure.

If we consider this original code:

LIEF::MachO::Binary& bin = ...;

try {
  LIEF::MachO::UUIDCommand& cmd = bin.uuid();
  std::cout << cmd << "\n";
} catch (const LIEF::not_found&) {
  // ... dedicated processing
}

// Other option with has_uuid()
if (bin.has_uuid()) {
  LIEF::MachO::UUIDCommand& cmd = bin.uuid();
  std::cout << cmd << "\n";
}

It can now be written as:

LIEF::MachO::Binary& bin = ...;

if (LIEF::MachO::UUIDCommand* cmd = bin.uuid();) {
  std::cout << *cmd << "\n";
} else {
  // ... dedicated processing as it is a nullptr
}

// Other option with has_uuid()
if (bin.has_uuid()) { // It ensures that it is not a nullptr
  LIEF::MachO::UUIDCommand& cmd = *bin.uuid();
  std::cout << cmd << "\n";
}

See also

0.11.X - Patch Releases

0.11.5 - May 22, 2021

  • Remove usage of not in public headers (b8e825b)

ELF:
PE:
MachO:

0.11.4 - March 09, 2021

PE:

  • Fix missing bound check when computing the authentihash

0.11.3 - March 03, 2021

PE:

  • Add sanity check on the signature’s length that could lead to a std::bad_alloc exception

0.11.2 - February 24, 2021

PE:

  • Fix regression in the behavior of the PE section’s name. One can now access the full section’s name (with trailing bytes) through lief.PE.Section.fullname (see: #551)

0.11.1 - February 22, 2021

PE:

0.11.0 - January 19, 2021

ELF:

  • mkomet updated enums related to Android (see: 9dd641d)

  • aeflores added MIPS relocations support in the ELF parser

  • Fix extend() on a ELF section (cf. issue #477)

  • Fix issue when exporting symbols on empty-gnu-hash ELF binary (1381f9a)

  • Fix reconstruction issue when the binary is prelinked (cf. issue #466)

  • Add DF_1_PIE flag

  • Fix parsing issue of the .eh_frame section when the base address is not 0.

  • JanuszL enhanced the algorithm that computes the string table. It moves from a N^2 algorithm to a Nlog(N) (1e0c4e8).

  • Fix .eh_frame parsing issue (b57f323)

  • aeflores fixed parsing issue in ELF relocations (6c53646)

  • Add PT_GNU_PROPERTY enum

  • Bug fix in the symbols table reconstruction (ELF)

PE:

  • Enhance PE Authenticode. See PE Authenticode

  • get_imphash() can now generate the same value as pefile and Virus Total (#299)

    pe = lief.parse("example.exe")
vt_imphash = lief.PE.get_imphash(pe, lief.PE.IMPHASH_MODE.PEFILE)
lief_imphash = lief.PE.get_imphash(pe, lief.PE.IMPHASH_MODE.DEFAULT)

    See also

    lief.PE.IMPHASH_MODE and lief.PE.get_imphash()

  • Remove the padding entry (0) from the rich header

  • lief.PE.LangCodeItem.items now returns a dictionary for which the values are bytes (instead of str object). This change is related to utf-16 support.

  • kohnakagawa fixed wrong enums values: c031250, 6ee808a, cd05f34

  • kohnakagawa fixed a bug in the PE resources parser (a7254d1)

  • Handle PE forwarded exports (issue #307)

Mach-O:

  • Add API to access either LC_CODE_SIGNATURE or DYLIB_CODE_SIGN_DRS (issue #476)

  • Fix issue when parsing twice a Mach-O file (issue #479)

Dependencies:

  • Replace easyloggingpp with spdlog 1.8.1

  • Upgrade frozen to 1.0.0

  • Upgrade json to 3.7.3

  • Upgrade pybind11 to 2.6.0

  • Upgrade mbedtls to 2.16.6

Documentation:

  • aguinet updated the bin2lib tutorial with the support of the new glibc versions (7884e57)

  • Global update and enable to build the documentation out-of-tree

  • Changing the theme

Misc:

  • Add Python 3.9 support

  • FindLIEF.cmake deprecates LIEF_ROOT. You should use LIEF_DIR instead.

Logging:

We changed the logging interface. The following log levels have been removed:

  • LOG_GLOBAL

  • LOG_FATAL

  • LOG_VERBOSE

  • LOG_UNKNOWN

We also moved from an class-interface based to functions.

Example:

lief.logging.disable()
lief.logging.enable()
lief.logging.set_level(lief.logging.LEVEL.INFO)

See: lief.logging.set_level()

Note

The log functions now output on stderr instead of stdout

0.10.1 - November 29, 2019

  • Fix regression in parsing Python bytes

  • Add Python API to demangle strings: lief.demangle

0.10.0 - November 24, 2019

ELF:

  • Add build support for ELF notes

  • Add coredump support (9fc3a8a)

  • Enable to bind a relocation with a symbol (a9f3cb8)

    Example:
    relocation = "..."

symbol = lief.ELF.Symbol()
symbol.name = "printf123"
relocation.symbol = symbol

  • Add constructors (67d924a)

  • Expose ELF destructors (957384c)

  • Add remove_static_symbol (c677970)

  • Add support for static relocation writing (d1b98d6)

  • Expose function to get strings located in the .rodata section (02f4851)

  • Export ELF ABI version (8d7ec26)

PE:

  • Improve PE Authenticode parsing (535623d)

  • Fix alignment issue when removing a PE section (04dddd3)

  • Parse PE debug data directory as a list of debug entries (by 1orenz0 - fcc75dd)

  • Add support to parse POGO debug entries (by 1orenz0 - 3537440)

Mach-O:

  • Enhance Mach-O modifications by exposing an API to:

    • Add load commands

    • Add sections

    • Add segments

    See: 406115c

  • Enable write() on FAT Mach-O (1659531)

  • Introduce Mach-O Build Version command (6f96723)

  • Enable to remove Mach-O symbols (616d739)

  • Add support for adding LC_UNIXTHREAD commands in a MachO (by nezetic - 64d2597)

Abstract Layer:

  • Expose remove_section() in the abstract layer (918438c)

  • Expose write() in the abstract layer (af4d48e)

  • Expose API to list functions found in a binary (b5a0846)

Android:

  • Add partial support for Android 9 (bce9ebe)

Misc:

  • lkollar added support for Python 3.8 in CI (Linux & OSX only)

  • Update Pybind11 dependency to v2.4.3

  • Enhance Python install

  • Thanks to lkollar, Linux CI now produces manylinux1-compliant wheels

Many thanks to the contributors: recvfrom, pbrunet, mackncheesiest, wisk, nezetic, lkollar, jbremer, DaLynX, 1orenz0, breadchris, 0xbf00, unratito, strazzere, aguinetqb, mingwandroid, serge-sans-paille-qb, yrp604, majin42, KOLANICH

0.9.0 - June 11, 2018

LIEF 0.9 comes with new formats related to Android: OAT, DEX, VDEX and ART. It also fixes bugs and thanks to yd0b0N, ELF parser now supports big and little endian binaries. We also completed the JSON serialization of LIEF objects.

Features

MachO:
PE:
ELF:

  • Add support for .note.android.ident section: d13db18

  • Enable to add unlimited number of dynamic entries: a40da3e

  • Add support for PPC relocations: 08b5141

  • Endianness support: e794ac1

API

  • lief.breakp() and lief.shell()

  • lief.parse() now support io streams as input

  • Parser now returns a std::unique_ptr instead of a raw pointer: cd1cc45

Misc

  • Use frozen for some internal std::map (If C++14 is supported by the compiler)

Acknowledgements

0.8.3

  • [Mach-O] Fix typo on comparison operator - abbc264

0.8.2

  • [ELF] Increase the upper limit of relocation number - 077bc32

0.8.1 - October 18, 2017

  • Fix an alignment issue in the ELF builder. See 8db199c

  • Add assertion on the setuptools version: 62e5825

0.8.0 - October 16, 2017

LIEF 0.8.0 mainly improves the MachO parser and the ELF builder. It comes with Dockerfiles for CentOS and Android.

LibFuzzer has also been integrated in the project to enhance the parsers

Features

Abstract Layer:
ELF:

  • DT_FLAGS and DT_FLAGS_1 are now parsed into DynamicEntryFlags - 754b8af

  • Handle relocations of object files (.o) - 483b8dc

  • Global enhancement of the ELF builder:

    One can now add multiple Section or Segment into an ELF:

    elf = lief.parse("/bin/cat")

for i in range(3):
  segment = Segment()
  segment.type = SEGMENT_TYPES.LOAD
  segment.content = [i & 0xFF] * 0x1000
  elf += segment


for i in range(3):
  section = Section("lief_{:02d}".format(i))
  section.content = [i & 0xFF] * 0x1000
  elf += section

elf.write("foo")

    $ readelf -l ./foo
PHDR           0x0000000000000040 0x0000000000000040 0x0000000000000040
               0x00000000000061f8 0x00000000000061f8  R E    0x8
INTERP         0x0000000000006238 0x0000000000006238 0x0000000000006238
               0x000000000000001c 0x000000000000001c  R      0x1
    [Requesting program interpreter: /lib64/ld-linux-x86-64.so.2]
LOAD           0x0000000000000000 0x0000000000000000 0x0000000000000000
               0x000000000000d6d4 0x000000000000d6d4  R E    0x200000
LOAD           0x000000000000da90 0x000000000020da90 0x000000000020da90
               0x0000000000000630 0x00000000000007d0  RW     0x200000
LOAD           0x000000000000f000 0x000000000040f000 0x000000000040f000
               0x0000000000001000 0x0000000000001000         0x1000
LOAD           0x0000000000010000 0x0000000000810000 0x0000000000810000
               0x0000000000001000 0x0000000000001000         0x1000
LOAD           0x0000000000011000 0x0000000001011000 0x0000000001011000
               0x0000000000001000 0x0000000000001000         0x1000
....

$ readelf -S ./foo
...
[27] lief_00           PROGBITS         0000000002012000  00012000
     0000000000001000  0000000000000000           0     0     4096
[28] lief_01           PROGBITS         0000000004013000  00013000
     0000000000001000  0000000000000000           0     0     4096
[29] lief_02           PROGBITS         0000000008014000  00014000
     0000000000001000  0000000000000000           0     0     4096

    Warning

    There are issues with executables statically linked with libraries that use TLS

    See: #98

    One can now add multiple entries in the dynamic table:

    elf = lief.parse("/bin/cat")

elf.add_library("libfoo.so")
elf.add(DynamicEntryRunPath("$ORIGIN"))
elf.add(DynamicEntry(DYNAMIC_TAGS.INIT, 123))
elf.add(DynamicSharedObject("libbar.so"))

elf.write("foo")

    $ readelf -d foo
  0x0000000000000001 (NEEDED)  Shared library: [libfoo.so]
  0x0000000000000001 (NEEDED)  Shared library: [libc.so.6]
  0x000000000000000c (INIT)    0x7b
  0x000000000000000c (INIT)    0x3600
  ...
  0x000000000000001d (RUNPATH) Bibliothèque runpath:[$ORIGIN]
  0x000000000000000e (SONAME)  Bibliothèque soname: [libbar.so]

    See b94900c, 1e410e6 for details.

  • b2d3694 enables modification of the ELF interpreter without length restriction

    elf = lief.parse("/bin/cat")
elf.interpreter = "/a/very/long/path/to/another/interpreter"
elf.write("foo")

    $ readelf -l foo
Program Headers:
Type           Offset             VirtAddr           PhysAddr
               FileSiz            MemSiz              Flags  Align
PHDR           0x0000000000000040 0x0000000000000040 0x0000000000000040
               0x00000000000011f8 0x00000000000011f8  R E    0x8
INTERP         0x000000000000a000 0x000000000040a000 0x000000000040a000
               0x0000000000001000 0x0000000000001000  R      0x1
    [Requesting program interpreter: /a/very/long/path/to/another/interpreter]
....

  • Enhancement of the dynamic symbols counting - 985d124

  • Enable editing ELF’s notes:

    elf = lief.parse("/bin/ls")
build_id = elf[NOTE_TYPES.BUILD_ID]
build_id.description = [0xFF] * 20
elf.write("foo")

    $ readelf -n foo
Displaying notes found in: .note.gnu.build-id
Owner                 Data size Description
GNU                  0x00000014 NT_GNU_BUILD_ID (unique build ID bitstring)
  Build ID: ffffffffffffffffffffffffffffffffffffffff

    See commit 3be9dd0 for more details

PE:

  • Add get_imphash() and resolve_ordinals() functions - a89bc6d, dfa8e98

  • Parse the Load Config Table into LoadConfiguration (up to Windows 10 SDK 15002 with hotpatch_table_offset)

    from lief import to_json
import json
pe = lief.parse("some.exe")
loadconfig = to_json(pe.load_configuration)) # Using the lief.to_json function
pprint(json.loads(to_json(loadconfig)))

    {'characteristics': 248,
 'code_integrity': {'catalog': 0,
                    'catalog_offset': 0,
                    'flags': 0,
                    'reserved': 0},
 'critical_section_default_timeout': 0,
 'csd_version': 0,
 'editlist': 0,
 ...
 'guard_cf_check_function_pointer': 5368782848,
 'guard_cf_dispatch_function_pointer': 5368782864,
 'guard_cf_function_count': 15,
 'guard_cf_function_table': 5368778752,
 'guard_flags': 66816,
 'guard_long_jump_target_count': 0,
 'guard_long_jump_target_table': 0,
 'guard_rf_failure_routine': 5368713280,
 'guard_rf_failure_routine_function_pointer': 5368782880,
 ...

    For details, see commit: 0234e3b

MachO:

Fixes

Fix enums conflicts(#32) - 66b4cd4

Fix most of the memory leaks: 88dafa8, d9b1436, 554fa15, 3602643

ELF:

  • Bug Fix when counting dynamic symbols from the GnuHash Table - 9036a24

PE:

  • Fix nullptr dereference in resources - e90fe1b

  • Handle encoding issues in the Python API - 8c7ceaf

  • Sanitize DLL names

MachO:

  • Fix #87, #92

  • Fix memory leaks and some performance issues: #94

API

In the C++ API get_XXX() getters have been renamed into XXX() (e.g. get_header() becomes header()) - a4c69f7, e805669

Abstract:
ELF:
PE:
MachO:
Logging:

Add an API to configure the logger - 4600c2b

Example:

from lief import Logger
Logger.disable()
Logger.enable()
Logger.set_level(lief.LEVEL.INFO)

See: lief.Logger

Build system

Documentation

References:

  • recomposer, bearparser, IAT_patcher, PEframe, Manalyze, MachOView, elf-dissector

Acknowledgements

0.7.0 - July 3, 2017

Features

Abstract Layer:

  • Add bitness (32bits / 64bits) - 78d1adb

  • Add object type (Library, executable etc) - 78d1adb

  • Add mode Thumbs, 16bits etc - 78d1adb

  • Add endianness - 7ea08f7, #29

ELF:
PE:

  • Parse PE Overlay - e0634c1

  • Enable PE Hooking - 24f6b72

  • Parse and rebuilt dos stub - 3f06397

  • Add a resources manager to provide an enhanced API over the resources - 8473c8e

  • Serialize PE objects into JSON - 673f5a3, #18

  • Parse Rich Header - 0893bd9, #15

Bug Fixes

ELF:

  • Bug fix when a GNU hash has empty buckets - 21a6c30

PE:

  • Bug fix in the signature parser: #30, 4af0256

  • Bug fix in the resources parser: Infinite loop - a569cc1

  • Add more out-of-bounds checks on relocations and exports - 9364f64

  • Use min(SizeOfRawData, VirtualSize) for the section’s size and truncate the size to the file size - 61bf14b

MachO:

  • Bug fix when a binary hasn’t a LC_MAIN command - 957501f

API

Abstract Layer:
ELF:
Notes:
Hash Tables:
PE:

  • lief.PE.Symbol.has_section

  • lief.PE.Binary.hook_function()

  • lief.PE.Binary.get_content_from_virtual_address() takes either an Absolute virtual address or a Relative virtual address

  • lief.PE.Binary.section_from_virtual_address has been renamed to lief.PE.Binary.section_from_rva().

  • lief.PE.parse_from_raw has been removed. One can use lief.PE.parse().

  • lief.PE.Section.data has been removed. Please use lief.PE.Section.content

Dos Stub:
Rich Header:
Overlay:
Imports:
Resources:
MachO:
UUID:
Main Command:
Dylinker:

Documentation

References:

  • elfsteem, pelook, PortEx, elfsharp, metasm, amoco, Goblin

Tutorials:
Integration:

Acknowledgements

  • ek0: #24

  • ACSC-CyberLab: #33, #34, #37, #39

  • Hyrum Anderson who pointed bugs in the PE parser

  • My collegues for the feedbacks and suggestions (Adrien, SebK, Pierrick)

0.6.1 - April 6, 2017

Bug Fixes

ELF:

API

PE:

Documentation

Integration:

Acknowledgements

0.6.0 - March 30, 2017

First public release