diff options
Diffstat (limited to 'plugins/pe/pe_def.h')
| -rw-r--r-- | plugins/pe/pe_def.h | 343 |
1 files changed, 343 insertions, 0 deletions
diff --git a/plugins/pe/pe_def.h b/plugins/pe/pe_def.h new file mode 100644 index 0000000..62d8afc --- /dev/null +++ b/plugins/pe/pe_def.h @@ -0,0 +1,343 @@ + +/* Chrysalide - Outil d'analyse de fichiers binaires + * pe_def.h - liste des structures et constantes utilisées par le format PE + * + * Copyright (C) 2010-2017 Cyrille Bagard + * + * This file is part of Chrysalide. + * + * Chrysalide is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License as published by + * the Free Software Foundation; either version 3 of the License, or + * (at your option) any later version. + * + * Chrysalide is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with Chrysalide. If not, see <http://www.gnu.org/licenses/>. + */ + + +#ifndef _FORMAT_PE_PE_DEF_H +#define _FORMAT_PE_PE_DEF_H + + +#include <stdint.h> + + + + + +/* ---------------------------- DESCRIPTION DU FORMAT PE ---------------------------- */ + + +/* En-tête DOS */ +typedef struct _image_dos_header +{ + uint16_t e_magic; /* Numéro magique */ + uint16_t e_cblp; /* Octets de la dernière page */ + uint16_t e_cp; /* Pages dans le fichier */ + uint16_t e_crlc; /* Relocalisations */ + uint16_t e_cparhdr; /* Taille en paragraphes */ + uint16_t e_minalloc; /* Nb min de paragraphes requis*/ + uint16_t e_maxalloc; /* Nb max de paragraphes requis*/ + uint16_t e_ss; /* Valeur (relative) SS init. */ + uint16_t e_sp; /* Valeur SP initiale */ + uint16_t e_csum; /* Empreinte */ + uint16_t e_ip; /* Valeur IP initiale */ + uint16_t e_cs; /* Valeur (relative) CS init. */ + uint16_t e_lfarlc; /* Position de table de reloc. */ + uint16_t e_ovno; /* Nombre d'overlay */ + uint16_t e_res[4]; /* Mots réservés */ + uint16_t e_oemid; /* Identifiant OEM */ + uint16_t e_oeminfo; /* Infos OEM pour e_oemid */ + uint16_t e_res2[10]; /* Mots réservés */ + uint32_t e_lfanew; /* Décalage de bon en-tête */ + +} image_dos_header; + +/* Archtecture supportées */ +#define IMAGE_FILE_MACHINE_I386 0x014c /* x86 */ +#define IMAGE_FILE_MACHINE_IA64 0x0200 /* Intel IPF */ +#define IMAGE_FILE_MACHINE_AMD64 0x8664 /* x64 */ + +/* Caractéristiques de l'image */ +#define IMAGE_FILE_RELOCS_STRIPPED 0x0001 /* Pas de relocalisation */ +#define IMAGE_FILE_EXECUTABLE_IMAGE 0x0002 /* Fichier exécutable */ +#define IMAGE_FILE_LINE_NUMS_STRIPPED 0x0004 /* Pas de ligne COFF */ +#define IMAGE_FILE_LOCAL_SYMS_STRIPPED 0x0008 /* Pas de table de symboles COFF */ +#define IMAGE_FILE_AGGRESIVE_WS_TRIM 0x0010 /* Aggressively trim the working set. This value is obsolete as of Windows 2000. */ +#define IMAGE_FILE_LARGE_ADDRESS_AWARE 0x0020 /* Adressage > 2 Go */ +#define IMAGE_FILE_BYTES_REVERSED_LO 0x0080 /* Octets inv. ; obsolète */ +#define IMAGE_FILE_32BIT_MACHINE 0x0100 /* Machine 32 bits */ +#define IMAGE_FILE_DEBUG_STRIPPED 0x0200 /* Pas d'infos de débogage */ +#define IMAGE_FILE_REMOVABLE_RUN_FROM_SWAP 0x0400 /* ...support amovible */ +#define IMAGE_FILE_NET_RUN_FROM_SWAP 0x0800 /* Ficher issu du réseau */ +#define IMAGE_FILE_SYSTEM 0x1000 /* Fichier système */ +#define IMAGE_FILE_DLL 0x2000 /* Fichier DLL */ +#define IMAGE_FILE_UP_SYSTEM_ONLY 0x4000 /* Mono-proc. seulement */ +#define IMAGE_FILE_BYTES_REVERSED_HI 0x8000 /* Octets inv. ; obsolète */ + +/* Première en-tête du "vrai" format */ +typedef struct _image_file_header +{ + uint16_t machine; /* Type de machine visée */ + uint16_t number_of_sections; /* Nombre de sections */ + uint32_t time_date_stamp; /* Date de la liaison */ + uint32_t pointer_to_symbol_table; /* Position de ladite table */ + uint32_t number_of_symbols; /* Nombre de symboles */ + uint16_t size_of_optional_header; /* Taille de l'en-tête n°2 */ + uint16_t characteristics; /* Propriétés de l'image */ + +} image_file_header; + + + + + + + + + + +/* -------------------------- EN-TETE EVOLUEE DU FORMAT PE -------------------------- */ + + +/** + * cf. http://msdn.microsoft.com/en-us/library/ms680305(VS.85).aspx + */ + +/* Zone de données Windows */ +typedef struct _image_data_directory +{ + uint32_t virtual_address; /* Adresse de la table */ + uint32_t size; /* Taille de la table */ + +} image_data_directory; + +// Directory Entries +#define IMAGE_DIRECTORY_ENTRY_EXPORT 0 // Export Directory +#define IMAGE_DIRECTORY_ENTRY_IMPORT 1 // Import Directory +#define IMAGE_DIRECTORY_ENTRY_RESOURCE 2 // Resource Directory +#define IMAGE_DIRECTORY_ENTRY_EXCEPTION 3 // Exception Directory +#define IMAGE_DIRECTORY_ENTRY_SECURITY 4 // Security Directory +#define IMAGE_DIRECTORY_ENTRY_BASERELOC 5 // Base Relocation Table +#define IMAGE_DIRECTORY_ENTRY_DEBUG 6 // Debug Directory +// IMAGE_DIRECTORY_ENTRY_COPYRIGHT 7 // (X86 usage) +#define IMAGE_DIRECTORY_ENTRY_ARCHITECTURE 7 // Architecture Specific Data +#define IMAGE_DIRECTORY_ENTRY_GLOBALPTR 8 // RVA of GP +#define IMAGE_DIRECTORY_ENTRY_TLS 9 // TLS Directory +#define IMAGE_DIRECTORY_ENTRY_LOAD_CONFIG 10 // Load Configuration Directory +#define IMAGE_DIRECTORY_ENTRY_BOUND_IMPORT 11 // Bound Import Directory in headers +#define IMAGE_DIRECTORY_ENTRY_IAT 12 // Import Address Table +#define IMAGE_DIRECTORY_ENTRY_DELAY_IMPORT 13 // Delay Load Import Descriptors +#define IMAGE_DIRECTORY_ENTRY_COM_DESCRIPTOR 14 // COM Runtime descriptor + + +/** + * cf. http://msdn.microsoft.com/en-us/library/ms680339(VS.85).aspx + */ + +#define IMAGE_NUMBEROF_DIRECTORY_ENTRIES 16 + +/* Seconde en-tête, optionnelle */ +typedef struct _image_optional_header +{ + uint16_t magic; /* Type de binaire manipulé */ + uint8_t major_linker_version; /* Version majeure du linker */ + uint8_t minor_linker_version; /* Version mineure du linker */ + uint32_t size_of_code; /* Taille de tout le code */ + uint32_t size_of_initialized_data; /* Taille des données init. */ + uint32_t size_of_uninitialized_data; /* Taille des données non init.*/ + uint32_t address_of_entry_point; /* Point d'entrée pour un exe. */ + uint32_t base_of_code; /* Adresse relative du code */ + uint32_t base_of_data; /* Adresse relative des données*/ + uint32_t image_base; /* Adresse souhaitée en mémoire*/ + uint32_t section_alignment; /* Alignement des sections */ + uint32_t file_alignment; /* Alignement des données */ + uint16_t major_operating_system_version;/* Numéro majeur d'OS requis */ + uint16_t minor_operating_system_version;/* Numéro mineur d'OS requis */ + uint16_t major_image_version; /* Numéro majeur du binaire */ + uint16_t minor_image_version; /* Numéro mineur du binaire */ + uint16_t major_subsystem_version; /* Numéro majeur du sous-sys. */ + uint16_t minor_subsystem_version; /* Numéro mineur du sous-sys. */ + uint32_t win32_version_value; /* Réservé (-> 0) */ + uint32_t size_of_image; /* Taille de l'image */ + uint32_t size_of_headers; /* Taille de l'en-tête */ + uint32_t checksum; /* Somme de contrôle */ + uint16_t subsystem; /* Sous-système visé */ + uint16_t dll_characteristics; /* Propriétés de la DLL */ + uint32_t size_of_stack_reserve; /* Taille de pile reservée */ + uint32_t size_of_stack_commit; /* Taille de pile au démarrage */ + uint32_t size_of_heap_reserve; /* Taille de tas reservée */ + uint32_t size_of_heap_commit; /* Taille de tas au démarrage */ + uint32_t loader_flags; /* Champ obslète */ + uint32_t number_of_rva_and_sizes; /* Nombre d'entrées suivantes */ + image_data_directory data_directory[IMAGE_NUMBEROF_DIRECTORY_ENTRIES]; + +} image_optional_header; + +/* Valeurs pour le champ 'magic' */ +#define IMAGE_NT_OPTIONAL_HDR32_MAGIC 0x10b /* Exécutable 32 bits */ +#define IMAGE_NT_OPTIONAL_HDR64_MAGIC 0x20b /* Exécutable 64 bits */ +#define IMAGE_ROM_OPTIONAL_HDR_MAGIC 0x107 /* Image ROM */ + +/* Sous-système attendu (champ 'subsystem') */ +#define IMAGE_SUBSYSTEM_UNKNOWN 0 /* Inconnu */ +#define IMAGE_SUBSYSTEM_NATIVE 1 /* Rien de requis */ +#define IMAGE_SUBSYSTEM_WINDOWS_GUI 2 /* Windows GUI */ +#define IMAGE_SUBSYSTEM_WINDOWS_CUI 3 /* Windows CUI */ +#define IMAGE_SUBSYSTEM_OS2_CUI 5 /* OS/2 CUI */ +#define IMAGE_SUBSYSTEM_POSIX_CUI 7 /* Posix CUI */ +#define IMAGE_SUBSYSTEM_WINDOWS_CE_GUI 9 /* Windows CE */ +#define IMAGE_SUBSYSTEM_EFI_APPLICATION 10 /* Application EFI */ +#define IMAGE_SUBSYSTEM_EFI_BOOT_SERVICE_DRIVER 11 /* Pilote EFI + boot */ +#define IMAGE_SUBSYSTEM_EFI_RUNTIME_DRIVER 12 /* Pilote EFI + serv. */ +#define IMAGE_SUBSYSTEM_EFI_ROM 13 /* Image ROM EFI */ +#define IMAGE_SUBSYSTEM_XBOX 14 /* Xbox */ +#define IMAGE_SUBSYSTEM_WINDOWS_BOOT_APPLICATION 16 /* Application de boot */ + +/* Détails pour le champ 'dll_characteristics' */ +#define IMAGE_DLLCHARACTERISTICS_UNKNOW_0 0x0001 /* Réservé */ +#define IMAGE_DLLCHARACTERISTICS_UNKNOW_1 0x0002 /* Réservé */ +#define IMAGE_DLLCHARACTERISTICS_UNKNOW_2 0x0004 /* Réservé */ +#define IMAGE_DLLCHARACTERISTICS_UNKNOW_3 0x0008 /* Réservé */ +#define IMAGE_DLLCHARACTERISTICS_DYNAMIC_BASE 0x0040/* Reloc. possible */ +#define IMAGE_DLLCHARACTERISTICS_FORCE_INTEGRITY 0x0080 /* Vérif. forcées */ +#define IMAGE_DLLCHARACTERISTICS_NX_COMPAT 0x0100 /* Compatible DEP */ +#define IMAGE_DLLCHARACTERISTICS_NO_ISOLATION 0x0200/* Pas d'isolation */ +#define IMAGE_DLLCHARACTERISTICS_NO_SEH 0x0400 /* Pas de SEH */ +#define IMAGE_DLLCHARACTERISTICS_NO_BIND 0x0800 /* Ne pas lier */ +#define IMAGE_DLLCHARACTERISTICS_UNKNOW_4 0x1000 /* Réservé */ +#define IMAGE_DLLCHARACTERISTICS_WDM_DRIVER 0x2000 /* Pilote WDM */ +#define IMAGE_DLLCHARACTERISTICS_UNKNOW_5 0x4000 /* Réservé */ +#define IMAGE_DLLCHARACTERISTICS_TERMINAL_SERVER_AWARE 0x8000 /* Support */ + + +/* Résumé global */ +typedef struct _image_nt_headers +{ + uint32_t signature; /* Numéro magique */ + image_file_header file_header; /* En-tête n°1 */ + image_optional_header optional_header; /* En-tête n°2 */ + +} image_nt_headers; + + + +/* --------------------------- SECTIONS POUR LE FORMAT PE --------------------------- */ + +/** + * cf. http://msdn.microsoft.com/en-us/library/ms680341(VS.85).aspx + */ + +/* Taille maximale d'un nom, avec ou sans '\0' final */ +#define IMAGE_SIZEOF_SHORT_NAME 8 + +/* Description d'une section */ +typedef struct _image_section_header +{ + char name[IMAGE_SIZEOF_SHORT_NAME]; /* Nom de la section */ + + union + { + uint32_t physical_address; /* Adresse physique */ + uint32_t virtual_size; /* Taille en mémoire */ + } misc; + + uint32_t virtual_address; /* Adresse en mémoire */ + uint32_t size_of_raw_data; /* Taille de données non init. */ + uint32_t pointer_to_raw_data; /* Position de ces données */ + uint32_t pointer_to_relocations; /* Position des relocalisations*/ + uint32_t pointer_to_line_numbers; /* Position de numéros de ligne*/ + uint16_t number_of_relocations; /* Quantité de relocalisations */ + uint16_t number_of_line_numbers; /* Quantité de numéros de ligne*/ + uint32_t characteristics; /* Caractéristiques */ + +} image_section_header; + +/* Détails des caractéristiques d'une image (champ 'characteristics') */ +#define IMAGE_SCN_UNKNOWN_0 0x00000000 /* Réservé */ +#define IMAGE_SCN_UNKNOWN_1 0x00000001 /* Réservé */ +#define IMAGE_SCN_UNKNOWN_2 0x00000002 /* Réservé */ +#define IMAGE_SCN_UNKNOWN_3 0x00000004 /* Réservé */ +#define IMAGE_SCN_TYPE_NO_PAD 0x00000008 /* Pas de complément (obs) */ +#define IMAGE_SCN_UNKNOWN_4 0x00000010 /* Réservé */ +#define IMAGE_SCN_CNT_CODE 0x00000020 /* Code exécutable */ +#define IMAGE_SCN_CNT_INITIALIZED_DATA 0x00000040 /* Données intialisées */ +#define IMAGE_SCN_CNT_UNINITIALIZED_DATA 0x00000080 /* Données non init. */ +#define IMAGE_SCN_LNK_OTHER 0x00000100 /* Réservé */ +#define IMAGE_SCN_LNK_INFO 0x00000200 /* Commentaires ou autres */ +#define IMAGE_SCN_UNKNOWN_5 0x00000400 /* Réservé */ +#define IMAGE_SCN_LNK_REMOVE 0x00000800 /* A ne pas intégrer */ +#define IMAGE_SCN_LNK_COMDAT 0x00001000 /* Données COMDAT */ +#define IMAGE_SCN_UNKNOWN_6 0x00002000 /* Réservé */ +#define IMAGE_SCN_NO_DEFER_SPEC_EXC 0x00004000 /* Reset des exceptions */ +#define IMAGE_SCN_GPREL 0x00008000 /* Références globales */ +#define IMAGE_SCN_UNKNOWN_7 0x00010000 /* Réservé */ +#define IMAGE_SCN_MEM_PURGEABLE 0x00020000 /* Réservé */ +#define IMAGE_SCN_MEM_LOCKED 0x00040000 /* Réservé */ +#define IMAGE_SCN_MEM_PRELOAD 0x00080000 /* Réservé */ +#define IMAGE_SCN_ALIGN_1BYTES 0x00100000 /* Alignement sur 1 octet */ +#define IMAGE_SCN_ALIGN_2BYTES 0x00200000 /* Alignement sur 2 octets */ +#define IMAGE_SCN_ALIGN_4BYTES 0x00300000 /* Alignement sur 4 octets */ +#define IMAGE_SCN_ALIGN_8BYTES 0x00400000 /* Alignement sur 8 octets */ +#define IMAGE_SCN_ALIGN_16BYTES 0x00500000 /* Alignement de 16 octets */ +#define IMAGE_SCN_ALIGN_32BYTES 0x00600000 /* Alignement de 32 octets */ +#define IMAGE_SCN_ALIGN_64BYTES 0x00700000 /* Alignement de 64 octets */ +#define IMAGE_SCN_ALIGN_128BYTES 0x00800000 /* Alignement de 128 octets*/ +#define IMAGE_SCN_ALIGN_256BYTES 0x00900000 /* Alignement de 256 octets*/ +#define IMAGE_SCN_ALIGN_512BYTES 0x00a00000 /* Alignement de 512 octets*/ +#define IMAGE_SCN_ALIGN_1024BYTES 0x00b00000 /* Alignement sur 1 ko */ +#define IMAGE_SCN_ALIGN_2048BYTES 0x00c00000 /* Alignement sur 2 ko */ +#define IMAGE_SCN_ALIGN_4096BYTES 0x00d00000 /* Alignement sur 4 ko */ +#define IMAGE_SCN_ALIGN_8192BYTES 0x00e00000 /* Alignement sur 8 ko */ +#define IMAGE_SCN_LNK_NRELOC_OVFL 0x01000000 /* Trop de Relocalisations */ +#define IMAGE_SCN_MEM_DISCARDABLE 0x02000000 /* Section abandonnable */ +#define IMAGE_SCN_MEM_NOT_CACHED 0x04000000 /* Section non cachable */ +#define IMAGE_SCN_MEM_NOT_PAGED 0x08000000 /* Section non paginable */ +#define IMAGE_SCN_MEM_SHARED 0x10000000 /* Section partageable */ +#define IMAGE_SCN_MEM_EXECUTE 0x20000000 /* Section exécutable */ +#define IMAGE_SCN_MEM_READ 0x40000000 /* Section lisible */ +#define IMAGE_SCN_MEM_WRITE 0x80000000 /* Section modifiable */ + + + +/* --------------------------- IDENTIFICATION DE SYMBOLES --------------------------- */ + +/** + * cf. http://msdn.microsoft.com/en-us/library/ms809762.aspx + * http://sandsprite.com/CodeStuff/Understanding_imports.html + * http://olance.developpez.com/articles/windows/pe-iczelion/import-table/ + */ + +/* Point de départ de la chaîne des importations */ +typedef struct _image_import_descriptor +{ + uint32_t original_first_thunk; + uint32_t time_date_stamp; + uint32_t forwarder_chain; + uint32_t module_name; + uint32_t first_thunk; + +} image_import_descriptor; + + + + +/* Désignation de fonction importée */ +typedef struct _image_import_by_name +{ + uint16_t hint; + char *name; + +} image_import_by_name; + + + + + +#endif /* _FORMAT_PE_PE_DEF_H */ |