#!/usr/bin/env python # -*- coding: utf-8 -*- # # Description # ----------- # Print information about a PE file import lief from lief import PE from lief.PE import oid_to_string from lief import Logger Logger.set_level(lief.LOGGING_LEVEL.FATAL) from optparse import OptionParser import sys import traceback class exceptions_handler(object): func = None def __init__(self, exceptions, on_except_callback=None): self.exceptions = exceptions self.on_except_callback = on_except_callback def __call__(self, *args, **kwargs): if self.func is None: self.func = args[0] return self try: return self.func(*args, **kwargs) except self.exceptions as e: if self.on_except_callback is not None: self.on_except_callback(e) else: print("-" * 60) print("Exception in {}: {}".format(self.func.__name__, e)) exc_type, exc_value, exc_traceback = sys.exc_info() traceback.print_tb(exc_traceback) print("-" * 60) @exceptions_handler(Exception) def print_information(binary): print("== Information ==\n") format_str = "{:<30} {:<30}" format_hex = "{:<30} 0x{:<28x}" format_dec = "{:<30} {:<30d}" print(format_str.format("Name:", binary.name)) print(format_hex.format("Virtual size:", binary.virtual_size)) print(format_str.format("Imphash:", PE.get_imphash(binary))) print(format_str.format("PIE:", str(binary.is_pie))) print(format_str.format("NX:", str(binary.has_nx))) @exceptions_handler(Exception) def print_header(binary): dos_header = binary.dos_header header = binary.header optional_header = binary.optional_header format_str = "{:<33} {:<30}" format_hex = "{:<33} 0x{:<28x}" format_dec = "{:<33} {:<30d}" print("== Dos Header ==") print(format_str.format("Magic:", str((dos_header.magic)))) print(format_dec.format("Used bytes in the last page:", dos_header.used_bytes_in_the_last_page)) print(format_dec.format("File size in pages:", dos_header.file_size_in_pages)) print(format_dec.format("Number of relocations:", dos_header.numberof_relocation)) print(format_dec.format("Header size in paragraphs:", dos_header.header_size_in_paragraphs)) print(format_dec.format("Minimum extra paragraphs:", dos_header.minimum_extra_paragraphs)) print(format_dec.format("Maximum extra paragraphs", dos_header.maximum_extra_paragraphs)) print(format_dec.format("Initial relative SS", dos_header.initial_relative_ss)) print(format_hex.format("Initial SP:", dos_header.initial_sp)) print(format_hex.format("Checksum:", dos_header.checksum)) print(format_dec.format("Initial IP:", dos_header.initial_ip)) print(format_dec.format("Initial CS:", dos_header.initial_relative_cs)) print(format_hex.format("Address of relocation table:", dos_header.addressof_relocation_table)) print(format_dec.format("Overlay number:", dos_header.overlay_number)) print(format_dec.format("OEM ID:", dos_header.oem_id)) print(format_dec.format("OEM information", dos_header.oem_info)) print(format_hex.format("Address of optional header:", dos_header.addressof_new_exeheader)) print("") print("== Header ==") char_str = " - ".join([str(chara).split(".")[-1] for chara in header.characteristics_list]) print(format_str.format("Signature:", "".join(map(chr, header.signature)))) print(format_str.format("Machine:", str(header.machine))) print(format_dec.format("Number of sections:", header.numberof_sections)) print(format_dec.format("Time Date stamp:", header.time_date_stamps)) print(format_dec.format("Pointer to symbols:", header.pointerto_symbol_table)) print(format_dec.format("Number of symbols:", header.numberof_symbols)) print(format_dec.format("Size of optional header:", header.sizeof_optional_header)) print(format_str.format("Characteristics:", char_str)) print("") dll_char_str = " - ".join([str(chara).split(".")[-1] for chara in optional_header.dll_characteristics_lists]) subsystem_str = str(optional_header.subsystem).split(".")[-1] print("== Optional Header ==") magic = "PE32" if optional_header.magic == PE.PE_TYPE.PE32 else "PE64" print(format_str.format("Magic:", magic)) print(format_dec.format("Major linker version:", optional_header.major_linker_version)) print(format_dec.format("Minor linker version:", optional_header.minor_linker_version)) print(format_dec.format("Size of code:", optional_header.sizeof_code)) print(format_dec.format("Size of initialized data:", optional_header.sizeof_initialized_data)) print(format_dec.format("Size of uninitialized data:", optional_header.sizeof_uninitialized_data)) print(format_hex.format("Entry point:", optional_header.addressof_entrypoint)) print(format_hex.format("Base of code:", optional_header.baseof_code)) if magic == "PE32": print(format_hex.format("Base of data", optional_header.baseof_data)) print(format_hex.format("Image base:", optional_header.imagebase)) print(format_hex.format("Section alignment:", optional_header.section_alignment)) print(format_hex.format("File alignment:", optional_header.file_alignment)) print(format_dec.format("Major operating system version:", optional_header.major_operating_system_version)) print(format_dec.format("Minor operating system version:", optional_header.minor_operating_system_version)) print(format_dec.format("Major image version:", optional_header.major_image_version)) print(format_dec.format("Minor image version:", optional_header.minor_image_version)) print(format_dec.format("Major subsystem version:", optional_header.major_subsystem_version)) print(format_dec.format("Minor subsystem version:", optional_header.minor_subsystem_version)) print(format_dec.format("WIN32 version value:", optional_header.win32_version_value)) print(format_hex.format("Size of image:", optional_header.sizeof_image)) print(format_hex.format("Size of headers:", optional_header.sizeof_headers)) print(format_hex.format("Checksum:", optional_header.checksum)) print(format_str.format("Subsystem:", subsystem_str)) print(format_str.format("DLL Characteristics:", dll_char_str)) print(format_hex.format("Size of stack reserve:", optional_header.sizeof_stack_reserve)) print(format_hex.format("Size of stack commit:", optional_header.sizeof_stack_commit)) print(format_hex.format("Size of heap reserve:", optional_header.sizeof_heap_reserve)) print(format_hex.format("Size of heap commit:", optional_header.sizeof_heap_commit)) print(format_dec.format("Loader flags:", optional_header.loader_flags)) print(format_dec.format("Number of RVA and size:", optional_header.numberof_rva_and_size)) print("") @exceptions_handler(Exception) def print_data_directories(binary): data_directories = binary.data_directories print("== Data Directories ==") f_title = "|{:<24} | {:<10} | {:<10} | {:<8} |" f_value = "|{:<24} | 0x{:<8x} | 0x{:<8x} | {:<8} |" print(f_title.format("Type", "RVA", "Size", "Section")) for directory in data_directories: section_name = directory.section.name if directory.has_section else "" print(f_value.format(str(directory.type).split('.')[-1], directory.rva, directory.size, section_name)) print("") @exceptions_handler(Exception) def print_sections(binary): sections = binary.sections print("== Sections ==") f_title = "|{:<10} | {:<16} | {:<16} | {:<18} | {:<16} | {:<9} | {:<9}" f_value = "|{:<10} | 0x{:<14x} | 0x{:<14x} | 0x{:<16x} | 0x{:<14x} | {:<9.2f} | {:<9}" print(f_title.format("Name", "Offset", "Size", "Virtual Address", "Virtual size", "Entropy", "Flags")) for section in sections: flags = "" for flag in section.characteristics_lists: flags += str(flag).split(".")[-1] + " " print(f_value.format(section.name, section.offset, section.size, section.virtual_address, section.virtual_size, section.entropy, flags)) print("") @exceptions_handler(Exception) def print_symbols(binary): symbols = binary.symbols if len(symbols) > 0: print("== Symbols ==") f_title = "|{:<20} | {:<10} | {:<8} | {:<8} | {:<8} | {:<13} |" f_value = u"|{:<20} | 0x{:<8x} | {:<14} | {:<10} | {:<12} | {:<13} |" print(f_title.format("Name", "Value", "Section number", "Basic type", "Complex type", "Storage class")) for symbol in symbols: section_nb_str = "" if symbol.section_number <= 0: section_nb_str = str(PE.SYMBOL_SECTION_NUMBER(symbol.section_number)).split(".")[-1] else: try: section_nb_str = symbol.section.name except: section_nb_str = "section<{:d}>".format(symbol.section_number) print(f_value.format( symbol.name[:20], symbol.value, section_nb_str, str(symbol.base_type).split(".")[-1], str(symbol.complex_type).split(".")[-1], str(symbol.storage_class).split(".")[-1])) @exceptions_handler(Exception) def print_imports(binary, resolve=False): print("== Imports ==") imports = binary.imports for import_ in imports: if resolve: import_ = lief.PE.resolve_ordinals(import_) print(import_.name) entries = import_.entries f_value = " {:<33} 0x{:<14x} 0x{:<14x} 0x{:<16x}" for entry in entries: print(f_value.format(entry.name, entry.data, entry.iat_value, entry.hint)) print("") @exceptions_handler(Exception) def print_tls(binary): format_str = "{:<33} {:<30}" format_hex = "{:<33} 0x{:<28x}" format_dec = "{:<33} {:<30d}" print("== TLS ==") tls = binary.tls callbacks = tls.callbacks print(format_hex.format("Address of callbacks:", tls.addressof_callbacks)) if len(callbacks) > 0: print("Callbacks:") for callback in callbacks: print(" " + hex(callback)) print(format_hex.format("Address of index:", tls.addressof_index)) print(format_hex.format("Size of zero fill:", tls.sizeof_zero_fill)) print("{:<33} 0x{:<10x} 0x{:<10x}".format("Address of raw data:", tls.addressof_raw_data[0], tls.addressof_raw_data[1])) print(format_hex.format("Size of raw data:", len(tls.data_template))) print(format_hex.format("Characteristics:", tls.characteristics)) print(format_str.format("Section:", tls.section.name)) print(format_str.format("Data directory:", str(tls.directory.type))) print("") @exceptions_handler(Exception) def print_relocations(binary): relocations = binary.relocations print("== Relocations ==") for relocation in relocations: entries = relocation.entries print(hex(relocation.virtual_address)) for entry in entries: print(" 0x{:<8x} {:<8}".format(entry.position, str(entry.type).split(".")[-1])) print("") @exceptions_handler(Exception) def print_export(binary): print("== Exports ==") exports = binary.get_export() entries = exports.entries f_value = "{:<20} 0x{:<10x} 0x{:<10x} 0x{:<6x} 0x{:<6x} 0x{:<10x}" print(f_value.format(exports.name, exports.export_flags, exports.timestamp, exports.major_version, exports.minor_version, exports.ordinal_base)) for entry in entries: extern = "[EXTERN]" if entry.is_extern else "" print(" {:<20} 0x{:<6x} 0x{:<10x} {:<13}".format(entry.name[:20], entry.ordinal, entry.address, extern)) print("") @exceptions_handler(Exception) def print_debug(binary): format_str = "{:<33} {:<30}" format_hex = "{:<33} 0x{:<28x}" format_dec = "{:<33} {:<30d}" debug = binary.debug print("== Debug ==") print(format_hex.format("Characteristics:", debug.characteristics)) print(format_hex.format("Timestamp:", debug.timestamp)) print(format_dec.format("Major version:", debug.major_version)) print(format_dec.format("Minor version:", debug.minor_version)) print(format_str.format("type:", str(debug.type).split(".")[-1])) print(format_hex.format("Size of data:", debug.sizeof_data)) print(format_hex.format("Address of raw data:", debug.addressof_rawdata)) print(format_hex.format("Pointer to raw data:", debug.pointerto_rawdata)) if debug.has_code_view: code_view = debug.code_view cv_signature = code_view.cv_signature if cv_signature in (lief.PE.CODE_VIEW_SIGNATURES.PDB_70, lief.PE.CODE_VIEW_SIGNATURES.PDB_70): sig_str = " ".join(map(lambda e : "{:02x}".format(e), code_view.signature)) print(format_str.format("Code View Signature:", str(cv_signature).split(".")[-1])) print(format_str.format("Signature:", sig_str)) print(format_dec.format("Age:", code_view.age)) print(format_str.format("Filename:", code_view.filename)) print("") @exceptions_handler(Exception) def print_signature(binary): format_str = "{:<33} {:<30}" format_hex = "{:<33} 0x{:<28x}" format_dec = "{:<33} {:<30d}" signature = binary.signature print("== Signature ==") print(format_dec.format("Version:", signature.version)) print(format_str.format("Digest Algorithm:", oid_to_string(signature.digest_algorithm))) print("") print("-- Content Info --") content_info = signature.content_info print(format_str.format("Content Type:", oid_to_string(content_info.content_type))) print(format_str.format("Type:", oid_to_string(content_info.type))) print(format_str.format("Digest Algorithm:", oid_to_string(content_info.digest_algorithm))) print("") print("-- Certificates --") certificates = signature.certificates for crt in certificates: sn_str = ":".join(map(lambda e : "{:02x}".format(e), crt.serial_number)) valid_from_str = "-".join(map(str, crt.valid_from[:3])) + " " + ":".join(map(str, crt.valid_from[3:])) valid_to_str = "-".join(map(str, crt.valid_to[:3])) + " " + ":".join(map(str, crt.valid_to[3:])) print(format_dec.format("Version:", crt.version)) print(format_str.format("Serial Number:", sn_str)) print(format_str.format("Signature Algorithm:", oid_to_string(crt.signature_algorithm))) print(format_str.format("Valid from:", valid_from_str)) print(format_str.format("Valid to:", valid_to_str)) print(format_str.format("Issuer:", crt.issuer)) print(format_str.format("Subject:", crt.subject)) print("") print("-- Signer Info --") signer_info = signature.signer_info issuer_str = " ".join(map(lambda e : oid_to_string(e[0]) + " = " + e[1], signer_info.issuer[0])) print(format_dec.format("Version:", signer_info.version)) print(format_str.format("Issuer:", issuer_str)) print(format_str.format("Digest Algorithm:", oid_to_string(signer_info.digest_algorithm))) print(format_str.format("Signature algorithm:", oid_to_string(signer_info.signature_algorithm))) print(format_str.format("Program name:", signer_info.authenticated_attributes.program_name)) print(format_str.format("Url:", signer_info.authenticated_attributes.more_info)) print("") @exceptions_handler(Exception) def print_rich_header(binary): print("== Rich Header ==") header = binary.rich_header print("Key: 0x{:08x}".format(header.key)) for entry in header.entries: print(" - ID: {:04x} Build ID: {:04x} Count: {:d}".format(entry.id, entry.build_id, entry.count)) print("") @exceptions_handler(Exception) def print_resources(binary): print("== Resources ==") manager = binary.resources_manager print(manager) print("") @exceptions_handler(Exception) def print_load_configuration(binary): format_str = "{:<45} {:<30}" format_hex = "{:<45} 0x{:<28x}" format_dec = "{:<45} {:<30d}" print("== Load Configuration ==") config = binary.load_configuration print(format_str.format("Version:", str(config.version).split(".")[-1])) print(format_dec.format("Characteristics:", config.characteristics)) print(format_dec.format("Timedatestamp:", config.timedatestamp)) print(format_dec.format("Major version:", config.major_version)) print(format_dec.format("Minor version:", config.minor_version)) print(format_hex.format("Global flags clear:", config.global_flags_clear)) print(format_hex.format("Global flags set:", config.global_flags_set)) print(format_dec.format("Critical section default timeout:", config.critical_section_default_timeout)) print(format_hex.format("Decommit free block threshold:", config.decommit_free_block_threshold)) print(format_hex.format("Decommit total free threshold:", config.decommit_total_free_threshold)) print(format_hex.format("Lock prefix table:", config.lock_prefix_table)) print(format_hex.format("Maximum allocation size:", config.maximum_allocation_size)) print(format_hex.format("Virtual memory threshold:", config.virtual_memory_threshold)) print(format_hex.format("Process affinity mask:", config.process_affinity_mask)) print(format_hex.format("Process heap flags:", config.process_heap_flags)) print(format_hex.format("CSD Version:", config.csd_version)) print(format_hex.format("Reserved 1:", config.reserved1)) print(format_hex.format("Edit list:", config.editlist)) print(format_hex.format("Security cookie:", config.security_cookie)) if isinstance(config, lief.PE.LoadConfigurationV0): print(format_hex.format("SE handler table:", config.se_handler_table)) print(format_dec.format("SE handler count:", config.se_handler_count)) if isinstance(config, lief.PE.LoadConfigurationV1): flags_str = " - ".join(map(lambda e : str(e).split(".")[-1], config.guard_cf_flags_list)) print(format_hex.format("GCF check function pointer:", config.guard_cf_check_function_pointer)) print(format_hex.format("GCF dispatch function pointer:", config.guard_cf_dispatch_function_pointer)) print(format_hex.format("GCF function table :", config.guard_cf_function_table)) print(format_dec.format("GCF Function count :", config.guard_cf_function_count)) print("{:<45} {} (0x{:x})".format("Guard flags:", flags_str, int(config.guard_flags))) if isinstance(config, lief.PE.LoadConfigurationV2): code_integrity = config.code_integrity print("Code Integrity:") print(format_dec.format(" " * 3 + "Flags:", code_integrity.flags)) print(format_dec.format(" " * 3 + "Catalog:", code_integrity.catalog)) print(format_hex.format(" " * 3 + "Catalog offset:", code_integrity.catalog_offset)) print(format_dec.format(" " * 3 + "Reserved:", code_integrity.reserved)) if isinstance(config, lief.PE.LoadConfigurationV3): print(format_hex.format("Guard address taken iat entry table:", config.guard_address_taken_iat_entry_table)) print(format_hex.format("Guard address taken iat entry count:", config.guard_address_taken_iat_entry_count)) print(format_hex.format("Guard long jump target table:", config.guard_long_jump_target_table)) print(format_hex.format("Guard long jump target count:", config.guard_long_jump_target_count)) if isinstance(config, lief.PE.LoadConfigurationV4): print(format_hex.format("Dynamic value relocation table:", config.dynamic_value_reloc_table)) print(format_hex.format("Hybrid metadata pointer:", config.hybrid_metadata_pointer)) if isinstance(config, lief.PE.LoadConfigurationV5): print(format_hex.format("GRF failure routine:", config.guard_rf_failure_routine)) print(format_hex.format("GRF failure routine function pointer:", config.guard_rf_failure_routine_function_pointer)) print(format_hex.format("Dynamic value reloctable offset:", config.dynamic_value_reloctable_offset)) print(format_hex.format("Dynamic value reloctable section:", config.dynamic_value_reloctable_section)) if isinstance(config, lief.PE.LoadConfigurationV6): print(format_hex.format("GRF verify stackpointer function pointer:", config.guard_rf_verify_stackpointer_function_pointer)) print(format_hex.format("Hotpatch table offset:", config.hotpatch_table_offset)) if isinstance(config, lief.PE.LoadConfigurationV7): print(format_hex.format("Reserved 3:", config.reserved3)) print("") @exceptions_handler(Exception) def print_ctor(binary): print("== Constructors ==\n") print("Functions: ({:d})".format(len(binary.ctor_functions))) for idx, address in enumerate(binary.ctor_functions): print(" [{:d}] 0x{:x}".format(idx, address)) def main(): optparser = OptionParser( usage='Usage: %prog [options] ', add_help_option = True, prog=sys.argv[0]) optparser.add_option('-a', '--all', action='store_true', dest='show_all', help='Show all informations') optparser.add_option('-d', '--data-directories', action='store_true', dest='show_data_directories', help='Display data directories') optparser.add_option('--debug', action='store_true', dest='show_debug', help='Display debug directory') optparser.add_option('-g', '--signature', action='store_true', dest='show_signature', help="Display the binary's signature if any") optparser.add_option('-H', '--header', action='store_true', dest='show_headers', help='Display headers') optparser.add_option('-i', '--import', action='store_true', dest='show_imports', help='Display imported functions and libraries') optparser.add_option('--resolve-ordinals', action='store_true', dest='resolve_ordinals', help="When used with --import, it attempts to resolve names of ordinal imports") optparser.add_option('-r', '--relocs', action='store_true', dest='show_relocs', help='Display the relocations (if present)') optparser.add_option('-R', '--rich-header', action='store_true', dest='show_richheader', help='Display the Rich Header') optparser.add_option('--resources', '--rsrc', action='store_true', dest='show_resources', help='Display the resources (if present)') optparser.add_option('-S', '--section-headers', '--sections', action='store_true', dest='show_section_header', help="Display the sections' headers") optparser.add_option('-s', '--symbols', '--syms', action='store_true', dest='show_symbols', help='Display symbols') optparser.add_option('-t', '--tls', action='store_true', dest='show_tls', help='Display TLS informations') optparser.add_option('-x', '--export', action='store_true', dest='show_export', help='Display exported functions/libraries') optparser.add_option('--load-config', action='store_true', dest='show_loadconfig', help='Display load configuration') optparser.add_option('--ctor', action='store_true', dest='show_ctor', help='Constructor functions') options, args = optparser.parse_args() if len(args) == 0: optparser.print_help() sys.exit(1) binary = None try: binary = PE.parse(args[0]) except lief.exception as e: print(e) sys.exit(1) print_information(binary) if options.show_data_directories or options.show_all: print_data_directories(binary) if options.show_headers or options.show_all: print_header(binary) if (options.show_imports or options.show_all) and binary.has_imports: print_imports(binary, resolve=options.resolve_ordinals) if (options.show_relocs or options.show_all) and binary.has_relocations: print_relocations(binary) if options.show_section_header or options.show_all: print_sections(binary) if options.show_symbols or options.show_all: print_symbols(binary) if (options.show_tls or options.show_all) and binary.has_tls: print_tls(binary) if (options.show_export or options.show_all) and binary.has_exports: print_export(binary) if (options.show_debug or options.show_all) and binary.has_debug: print_debug(binary) if (options.show_signature or options.show_all) and binary.has_signature: print_signature(binary) if (options.show_richheader or options.show_all) and binary.has_rich_header: print_rich_header(binary) if (options.show_resources or options.show_all) and binary.has_resources: print_resources(binary) if (options.show_loadconfig or options.show_all) and binary.has_configuration: print_load_configuration(binary) if options.show_ctor or options.show_all: print_ctor(binary) if __name__ == "__main__": main()