zydis

Bibliothèque de génération rapide et légère x86 / x86-64.

Caractéristiques

• Prend en charge toutes les instructions et extensions X86 et X86-64 (AMD64)
• Optimisé pour les performances élevées
• Aucune allocation de mémoire dynamique ("Malloc")
• Filetage par conception
• Très petite surface de taille par rapport à d'autres bibliothèques de désassembleur communes
• Documentation complète du doxygen
• Considéré par de nombreux projets d'Open-source majeurs
  • Les exemples incluent X64DBG, Mozilla Firefox et WebKit
• Absolument pas de dépendances tierces - pas même LIBC
  • Devrait compiler sur n'importe quelle plate-forme avec un compilateur C11 fonctionnel
  • Testé sur Windows, MacOS, FreeBSD, Linux et UEFI, en mode utilisateur et noyau

Exemples

Désassembleur

Le programme d'exemple suivant utilise ZYDIS pour démonter un tampon de mémoire donné et imprime la sortie de la console.

Zydis / Exemples / DésassementImple.c

Lignes 38 à 63 en 214536a

	Données zyanu8 [] =
	{
	0x51 , 0x8d , 0x45 , 0xff , 0x50 , 0xff , 0x75 , 0x0c , 0xff , 0x75 ,
	0x08 , 0xff , 0x15 , 0xa0 , 0xa5 , 0x48 , 0x76 , 0x85 , 0xc0 , 0x0f ,
	0x88 , 0xfc , 0xda , 0x02 , 0x00
	};
	// L'adresse d'exécution (pointeur d'instruction) a été choisie arbitrairement ici afin de mieux
	// visualiser l'adressage relatif. Dans votre programme réel, définissez-le sur la même chose
	// que le code en cours de démonstration a été lu.
	Zyanu64 runtime_address = 0x007fffffff400000 ;
	// Boucle sur les instructions de notre tampon.
	Zyanusize offset = 0 ;
	Instruction de ZydisDisassembledInstruction ;
	tandis que ( zyan_success ( zydisdisassembleintel (
	/ * machine_mode: * / zydis_machine_mode_long_64 ,
	/ * runtime_address: * / runtime_address ,
	/ * Buffer: * / Data + Offset ,
	/ * longueur: * / sizeof ( data ) - décalage ,
	/ * Instruction: * / & instruction
	))) {
	printf ( "% 016" Prix64 "% s n" , runtime_address , instruction . text );
	Offset + = instruction . Info . longueur ;
	runtime_address + = instruction . Info . longueur ;
	}

Le programme d'exemple ci-dessus génère la sortie suivante:

 007FFFFFFF400000   push rcx
007FFFFFFF400001   lea eax , [ rbp - 0x01 ]
007FFFFFFF400004   push rax
007FFFFFFF400005   push qword ptr [ rbp + 0x0C ]
007FFFFFFF400008   push qword ptr [ rbp + 0x08 ]
007FFFFFFF40000B   call [ 0x008000007588A5B1 ]
007FFFFFFF400011   test eax , eax
007FFFFFFF400013   js 0x007FFFFFFF42DB15

Encodeur

Zydis / Exemples / EncodeMov.c

Lignes 39 à 62 en B37076E

	ZyDisEncoderRequest Req ;
	memset ( & req , 0 , sizeof ( req ));
	req . mnemonic = zydis_mnemonic_mov ;
	req . machine_mode = zydis_machine_mode_long_64 ;
	req . operand_count = 2 ;
	req . Opérandes [ 0 ]. type = zydis_operand_type_register ;
	req . Opérandes [ 0 ]. Reg . valeur = zydis_register_rax ;
	req . Opérandes [ 1 ]. type = zydis_operand_type_immediate ;
	req . Opérandes [ 1 ]. Imm . u = 0x1337 ;
	Zyanu8 codé_instruction [ zydis_max_instruction_length ];
	Zyanusize codé_length = sizeof ( encodé_instruction );
	if ( zyan_failed ( zyDisEncodeRencodeInstruction ( & req , encoded_instruction , & encoded_length ))))
	{
	put ( "Échec de l'enseignement de l'instruction" );
	retour 1 ;
	}
	pour ( zyanusize i = 0 ; i < encodé_length ; ++ i )
	{
	printf ( "% 02x" , encodé_instruction [ i ]);
	}

Le programme d'exemple ci-dessus génère la sortie suivante:

 48 C7 C0 37 13 00 00

Plus d'exemples

Plus d'exemples peuvent être trouvés dans le répertoire des exemples de ce référentiel.

Construire

Il existe de nombreuses façons de rendre les Zydis disponibles sur votre système. La liste des sous-sections suivantes a utilisé des options couramment utilisées.

Cmake Build

Plateformes: Windows, MacOS, Linux, BSDS

Vous pouvez utiliser CMake pour construire des Zydis sur toutes les plates-formes prises en charge. Des instructions sur la façon d'installer Cmake peuvent être trouvées ici.

git clone --recursive ' https://github.com/zyantific/zydis.git '
cd zydis
cmake -B build
cmake --build build -j4

Projet Visual Studio 2022

Plateformes: Windows

Nous maintenons manuellement un projet Visual Studio 2022 en plus de la logique de construction CMake.

CMake généré vs projet

Plateformes: Windows

CMake peut être chargé de générer un projet Visual Studio pour à peu près toutes les versions VS. Un guide vidéo décrivant comment utiliser l'interface graphique Cmake pour générer de tels fichiers de projet est disponible ici. Ne soyez pas confus par l'utilisation apparente de macOS dans la vidéo: Windows est simplement en cours d'exécution dans une machine virtuelle.

Distribution fusionnée

Plateformes: Toute plate-forme avec un compilateur C11 fonctionnel

Nous fournissons un en-tête unique généré automatiquement et une variante de fichiers source unique de ZYDIS. Pour utiliser cette variante de Zydis dans votre projet, il vous suffit de copier ces deux fichiers dans votre projet. Les versions fusionnées peuvent être trouvées sur notre page de sortie en tant que zydis-amalgamated.tar.gz .

Ces fichiers sont générés avec le script amalgamate.py .

Gestionnaires de package

Plateformes: Windows, MacOS, Linux, FreeBSD

Les en-têtes prédéfinis, les bibliothèques et les exécutables partagés sont disponibles via une variété de gestionnaires de packages.

Version Zydis dans divers référentiels de packages

Dépôt	Installer la commande
Arch Linux	pacman -S zydis
Debian	apt-get install libzydis-dev zydis-tools
Homebrew	brew install zydis
Nixos	nix-shell -p zydis
Ubuntu	apt-get install libzydis-dev zydis-tools
vcpkg	vcpkg install zydis

Utilisation de Zydis dans un projet CMake

Un exemple sur la façon d'utiliser les Zydis dans votre propre projet basé sur CMake peut être trouvé dans ce dépôt.

Outil ZydisInfo

L'outil de ligne de commande ZydisInfo peut être utilisé pour inspecter essentiellement toutes les informations que Zydis fournit sur une instruction.

Reliures

Les liaisons officielles existent pour une sélection de langues:

• Rouiller
• Python 3

frontal de style ASMJit C ++

Si vous cherchez un assembleur de style ASMJIT Front-end pour l'encodeur, consultez Zasm. Zasm fournit également un wrapper C ++ idiomatique autour du décodeur et de l'interface de format.

Versions

Schème

Les versions suivent le schéma de version sémantique. Toutes les garanties de stabilité s'appliquent uniquement à l'API. La stabilité ABI est fournie uniquement entre les versions du patch.

Branches et étiquettes

• master détient le code de bord de saignement de la version Zydis suivante suivante. Des quantités accrues de bogues et de problèmes doivent être attendues et la stabilité de l'API n'est pas garantie en dehors des engagements marqués.
• Les versions stables et d'aperçu sont annotées avec des balises Git
  • Beta et autres versions d'aperçu ont -beta , -rc , etc. suffixes
• maintenance/v4 pointe vers le code de la dernière version de V4
  • V4 est la dernière version majeure stable et reçoit les mises à jour des fonctionnalités
• maintenance/v3 pointe vers le code de la dernière version de V3
  • V3 n'aura aucune mise à jour de fonctionnalité mais recevra des mises à jour de sécurité avant 2025
• maintenance/v2 pointe vers le code de la dernière version héritée de V2
  • V2 est atteint en fin de vie et ne recevra aucune mise à jour de sécurité

Crédits

• Intel (pour l'ouverture ouverte XED, permettant une comparaison automatique de nos tables avec les leurs, améliorant les deux)
• LLVM (pour fournir également des données d'instructions assez solides)
• Christian Ludloff (https://sandpile.org, incroyablement utile)
• Lekoarts (pour créer le logo du projet)
• Nos contributeurs sur Github

Dépannage

-fPIC pour les versions de bibliothèque partagées

 /usr/bin/ld: ./libfoo.a(foo.c.o): relocation R_X86_64_PC32 against symbol `bar' can not be used when making a shared object; recompile with -fPIC

Dans certaines circonstances (par exemple, lorsque la création de Zydis en tant que bibliothèque statique à l'aide de CMake, puis en utilisant des makefiles, pour les lier manuellement dans une bibliothèque partagée), CMake pourrait ne pas détecter que les informations de relocalisation doivent être émises. Cela peut être forcé en passant -DCMAKE_POSITION_INDEPENDENT_CODE=ON l'invocation cmake.

Conseil et assistance commerciale

Nous offrons des services de conseil et un soutien professionnel aux entreprises pour les Zydis. Si vous avez besoin d'une extension personnalisée, avez besoin d'aide pour intégrer les Zydis dans votre produit ou si vous souhaitez simplement les mises à jour garanties contractuellement et les délais de revirement, nous sommes heureux d'aider à cela! Veuillez nous contacter à [email protected].

Dons

Les dons sont collectés et distribués à l'aide du compte de Flobernd.

Licence

Zydis est autorisé sous la licence du MIT.