Go to file
Joel Höner 1aa5e648f1
Backported "Fixed a wrong assert condition" from future branch
Commit on future: e6dbba0bd314680dda64ef34e56cd12046ae8a2d
2018-05-21 16:00:06 +02:00
assets Removed PIN test tool 2017-11-23 22:41:29 +01:00
examples Removed non-ASCII characters 2018-02-28 18:57:04 +01:00
include/Zydis Minor doxygen improvements 2018-03-22 19:09:35 +01:00
msvc Update MSVC project files 2017-12-11 00:14:37 +01:00
src Backported "Fixed a wrong assert condition" from future branch 2018-05-21 16:00:06 +02:00
tools Minor code optimizations 2018-03-13 00:23:24 +01:00
.gitattributes Added github-linguist language override 2017-07-24 22:49:30 +02:00
.gitignore Update .gitignore with MSVC file types 2017-11-29 00:55:11 +01:00
CMakeLists.txt CMake: Fixed `ZYDIS_FEATURE_DECODER` and `ZYDIS_FEATURE_FORMATTER` options 2018-02-28 21:16:32 +01:00
Doxyfile Moved Doxyfile to root 2017-07-25 01:09:33 +02:00
LICENSE Updated license and version-info 2018-01-19 02:38:18 +01:00
README.md Fixed Discord link 2018-05-05 15:20:36 +02:00

README.md

zydis logo License: MIT Gitter Discord Build status

Fast and lightweight x86/x86-64 disassembler library.

Features

  • Supports all x86 and x86-64 (AMD64) instructions and extensions
  • Optimized for high performance
  • No dynamic memory allocation ("malloc")
  • Thread-safe by design
  • Very small file-size overhead compared to other common disassembler libraries
  • Complete doxygen documentation
  • Absolutely no dependencies — not even libc
    • Should compile on any platform with a working C99 compiler
    • Tested on Windows, macOS, FreeBSD and Linux, both user and kernel mode

Quick Example

The following example program uses Zydis to disassemble a given memory buffer and prints the output to the console.

#include <stdio.h>
#include <inttypes.h>
#include <Zydis/Zydis.h>

int main()
{
    uint8_t data[] =
    {
        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
    };

    // Initialize decoder context.
    ZydisDecoder decoder;
    ZydisDecoderInit(
        &decoder,
        ZYDIS_MACHINE_MODE_LONG_64,
        ZYDIS_ADDRESS_WIDTH_64);

    // Initialize formatter. Only required when you actually plan to
    // do instruction formatting ("disassembling"), like we do here.
    ZydisFormatter formatter;
    ZydisFormatterInit(&formatter, ZYDIS_FORMATTER_STYLE_INTEL);

    // Loop over the instructions in our buffer.
    // The IP is chosen arbitrary here in order to better visualize
    // relative addressing.
    uint64_t instructionPointer = 0x007FFFFFFF400000;
    size_t offset = 0;
    size_t length = sizeof(data);
    ZydisDecodedInstruction instruction;
    while (ZYDIS_SUCCESS(ZydisDecoderDecodeBuffer(
        &decoder, data + offset, length - offset,
        instructionPointer, &instruction)))
    {
        // Print current instruction pointer.
        printf("%016" PRIX64 "  ", instructionPointer);

        // Format & print the binary instruction
        // structure to human readable format.
        char buffer[256];
        ZydisFormatterFormatInstruction(
            &formatter, &instruction, buffer, sizeof(buffer));
        puts(buffer);

        offset += instruction.length;
        instructionPointer += instruction.length;
    }
}

Sample Output

The above example program generates the following output:

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

Build

Unix

Zydis builds cleanly on most platforms without any external dependencies. You can use CMake to generate project files for your favorite C99 compiler.

git clone 'https://github.com/zyantific/zydis.git'
cd zydis
mkdir build && cd build
cmake ..
make

Windows

Either use the Visual Studio 2017 project or build Zydis using CMake (video guide).

ZydisInfo tool

ZydisInfo

Credits

  • Intel (for open-sourcing XED, allowing for automatic comparision of our tables against theirs, improving both)
  • LLVM (for providing pretty solid instruction data as well)
  • Christian Ludloff (http://sandpile.org, insanely helpful)
  • LekoArts (for creating the project logo)
  • Our contributors on GitHub

License

Zydis is licensed under the MIT license.