Скачать zydis - загрузка исходного кода zydis

zydis

Исходный код С#

v4.1.0

Скачать

Быстрый и легкий x86/x86-64 Дизассемблер и библиотека генерации кодов.

Функции

Поддерживает все инструкции и расширения x86 и x86-64 (AMD64)
Оптимизированный для высокой производительности
Нет динамического распределения памяти ("malloc")
Потока безопасна по дизайну
Очень маленькие накладные расходы размером с файлов по сравнению с другими общими библиотеками разборки
Завершите документацию Doxygen
Доверяют многие крупные проекты с открытым исходным кодом
- Примеры включают X64DBG, Mozilla Firefox и Webkit
Абсолютно никаких сторонних зависимостей - даже LIBC
- Соберите на любую платформу с рабочим компилятором C11
- Протестировано в Windows, MacOS, FreeBSD, Linux и UEFI, как пользователь, и режим ядра

Примеры

Дизассемблер

В следующем примере программы используется Zydis для разобравания данного буфера памяти и печатает вывод на консоли.

Zydis/Примеры/DisassemblesImple.c

Строки от 38 до 63 в 214536а

 Zyanu8 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 
 }; 
 // Адрес времени выполнения (указатель инструкции) был выбран здесь произвольно, чтобы лучше 
 // визуализировать относительную адресацию. В вашей реальной программе установите это на адрес памяти 
 // что разборка кода был прочитал от. 
 Zyanu64 runtime_address = 0x007fffffff400000 ; 
 // Перециры над инструкциями в нашем буфере. 
 Zyanusize offset = 0 ; 
 Zydisdisassembledinstruction Инструкция ; 
 в то время как ( zyan_success ( zydisdisassembleintel ( 
 / * machine_mode: */ zydis_machine_mode_long_64 , 
 / * runtime_address: */ runtime_address , 
 / * буфер: */ data + offset , 
 / * Длина: */ sizeof ( data ) - смещено , 
 / * Инструкция: */ и инструкция 
 ))) { 
 printf ( " %016" prix64 " %s  n" , runtime_address , инструкция . Текст ); 
 Offset += Инструкция . информация длина ; 
 runtime_address += инструкция . информация длина ; 
 }

Приведенный выше пример программы генерирует следующий выход:

 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

Энкодер

Zydis/Примеры/Encodemov.c

Линии от 39 до 62 в 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 . операнды [ 0 ]. type = zydis_operand_type_register ; 
 req . операнды [ 0 ]. рег . value = zydis_register_rax ; 
 req . операнды [ 1 ]. type = zydis_operand_type_immediate ; 
 req . операнды [ 1 ]. Импс . u = 0x1337 ; 
 Zyanu8 oncoded_instruction [ zydis_max_instruction_length ]; 
 Zyanusize oncoded_length = sizeof ( oncoded_instruction ); 
 if ( zyan_failed ( zydisencoderencodeinstruction ( & req , oncoded_instruction , & oncoded_length ))))))) 
 { 
 Puts ( «не удалось кодировать инструкцию» ); 
 возврат 1 ; 
 } 
 для ( zyanusize i = 0 ; i < oncoded_length ; ++ i ) 
 { 
 printf ( "%02x" , кодировка_инструкция [ i ]); 
 }

Приведенный выше пример программы генерирует следующий выход:

 48 C7 C0 37 13 00 00

Больше примеров

Больше примеров можно найти в каталоге примеров этого репозитория.

Строить

Есть много способов сделать Zydis доступными в вашей системе. В следующих подразделениях приведены широко используемые параметры.

Cmake Build

Платформы: Windows, MacOS, Linux, BSDS

Вы можете использовать Cmake для создания Zydis на всех поддерживаемых платформах. Инструкции о том, как установить Cmake, можно найти здесь.

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

Visual Studio 2022 Project

Платформы: Windows

Мы вручную поддерживаем проект Visual Studio 2022 в дополнение к логике сборки Cmake.

Cmake сгенерированный против проекта

Платформы: Windows

Cmake может быть проинструктирован создать проект Visual Studio практически для любой версии VS. Видеоид, описывающий, как использовать графический интерфейс Cmake для генерации таких файлов проекта, доступен здесь. Не путайте явное использование MacOS в видео: Windows просто работает на виртуальной машине.

Объединенное распределение

Платформы: любая платформа с рабочим компилятором C11

Мы предоставляем автозапрессованный вариант одного заголовка и единого исходного файла Zydis. Чтобы использовать этот вариант Zydis в вашем проекте, все, что вам нужно сделать, это скопировать эти два файла в свой проект. Объединенные сборки можно найти на нашей странице релиза как zydis-amalgamated.tar.gz .

Эти файлы генерируются с помощью скрипта amalgamate.py .

Управляющие пакетами

Платформы: Windows, MacOS, Linux, FreeBSD

Предварительно построенные заголовки, общие библиотеки и исполнители доступны через различные менеджеры пакетов.

Zydis версия в различных репозиториях пакетов

Репозиторий	Установить команду
Arch Linux	`pacman -S zydis`
Дебюн	`apt-get install libzydis-dev zydis-tools`
Домашний	`brew install zydis`
Никсос	`nix-shell -p zydis`
Ubuntu	`apt-get install libzydis-dev zydis-tools`
VCPKG	`vcpkg install zydis`

Использование Zydis в проекте Cmake

Пример того, как использовать Zydis в вашем собственном проекте на основе Cmake, можно найти в этом репо.

`ZydisInfo` инструмент

Инструмент командной строки ZydisInfo может использоваться для проверки практически всей информации, которую Zydis предоставляет о инструкции.

Zydisinfo

Привязки

Официальные привязки существуют для выбора языков:

Ржавчина
Питон 3

Асмджит в стиле C ++ Фронт

Если вы ищете фронт-энд ассемблера в стиле ASMJIT для энкодера, посмотрите Zasm. Zasm также обеспечивает идиоматическую обертку C ++ вокруг интерфейса декодера и форматета.

Версии

Схема

Версии следуют схеме семантической версий. Все гарантии стабильности применяются только к API. Стабильность ABI обеспечивается только между версиями патчей.

Филиалы и теги

master держит код кровотечения в следующей невыпущенной версии Zydis. Увеличение количества ошибок и проблем необходимо ожидать, а стабильность API не гарантируется вне помеченных коммитов.
Стабильные и предварительные версии аннотируются с тегами GIT
- Бета и другие предварительные версии имеют суффиксы -beta , -rc и т. Д.
maintenance/v4 указывает на код последнего выпуска V4
- V4 - последняя стабильная крупная версия и получает обновления функций
maintenance/v3 указывает на код последнего выпуска V3
- v3 не получит никаких обновлений функций, но получит обновления безопасности до 2025 года
maintenance/v2 указывает на код последнего наследия V2
- V2 достиг конечного срока службы и не получит никаких обновлений безопасности

Кредиты

Intel (для открытых источников XED, позволяя автоматическое сравнение наших таблиц с их их, улучшая оба)
LLVM (также для предоставления довольно прочных данных инструкций)
Кристиан Ладлофф (https://sandpile.org, безумно полезно)
Lekoarts (для создания логотипа проекта)
Наши участники в GitHub

Поиск неисправностей

`-fPIC` для общих библиотечных сборок

 /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

При некоторых обстоятельствах (например, при создании Zydis в качестве статической библиотеки с использованием Cmake, а затем используя Makefiles для вручную связать его в общую библиотеку), Cmake может не обнаружить, что информация о переезде должна быть излучена. Это может быть принудительно пропустить -DCMAKE_POSITION_INDEPENDENT_CODE=ON в вызов Cmake.

Консалтинг и поддержка бизнеса

Мы предлагаем консалтинговые услуги и профессиональную поддержку бизнеса для Zydis. Если вам нужно настраиваемое расширение, потребуется помощь в интеграции Zydis в ваш продукт или просто хотите, чтобы по контракту гарантировали обновления и время выполнения времени, мы рады помочь с этим! Пожалуйста, свяжитесь с нами по адресу [email protected].

Пожертвования

Пожертвования собираются и распределяются с использованием учетной записи Flobernd.

Лицензия

Zydis лицензирован по лицензии MIT.

Расширять

Дополнительная информация

Версия v4.1.0
Тип Исходный код С#
Время обновления 2025-03-17
размер 1.01MB
От Github

Связанные приложения

Питон

2009-05-24
modern embedded programming course

2025-03-18
yash

2025-03-18
Система управления питанием

2009-05-24
Система управления больницей C#

2009-05-24
libplctag

2025-03-18

zydis

Функции

Примеры

Дизассемблер

Энкодер

Больше примеров

Строить

Cmake Build

Visual Studio 2022 Project

Cmake сгенерированный против проекта

Объединенное распределение

Управляющие пакетами

Использование Zydis в проекте Cmake

`ZydisInfo` инструмент

Привязки

Асмджит в стиле C ++ Фронт

Версии

Схема

Филиалы и теги

Кредиты

Поиск неисправностей

`-fPIC` для общих библиотечных сборок

Консалтинг и поддержка бизнеса

Пожертвования

Лицензия

Питон

modern embedded programming course

yash

Система управления питанием

Система управления больницей C#

libplctag

chat.petals.dev

GPT Prompt Templates

GPTyped

Питон

modern embedded programming course

yash

Google Dorks

shepherd

mongo express

	Zyanu8 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
	};

	// Адрес времени выполнения (указатель инструкции) был выбран здесь произвольно, чтобы лучше
	// визуализировать относительную адресацию. В вашей реальной программе установите это на адрес памяти
	// что разборка кода был прочитал от.
	Zyanu64 runtime_address = 0x007fffffff400000 ;

	// Перециры над инструкциями в нашем буфере.
	Zyanusize offset = 0 ;
	Zydisdisassembledinstruction Инструкция ;
	в то время как ( zyan_success ( zydisdisassembleintel (
	/ * machine_mode: */ zydis_machine_mode_long_64 ,
	/ * runtime_address: */ runtime_address ,
	/ * буфер: */ data + offset ,
	/ * Длина: */ sizeof ( data ) - смещено ,
	/ * Инструкция: */ и инструкция
	))) {
	printf ( " %016" prix64 " %s n" , runtime_address , инструкция . Текст );
	Offset += Инструкция . информация длина ;
	runtime_address += инструкция . информация длина ;
	}

	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 . операнды [ 0 ]. type = zydis_operand_type_register ;
	req . операнды [ 0 ]. рег . value = zydis_register_rax ;
	req . операнды [ 1 ]. type = zydis_operand_type_immediate ;
	req . операнды [ 1 ]. Импс . u = 0x1337 ;

	Zyanu8 oncoded_instruction [ zydis_max_instruction_length ];
	Zyanusize oncoded_length = sizeof ( oncoded_instruction );

	if ( zyan_failed ( zydisencoderencodeinstruction ( & req , oncoded_instruction , & oncoded_length )))))))
	{
	Puts ( «не удалось кодировать инструкцию» );
	возврат 1 ;
	}

	для ( zyanusize i = 0 ; i < oncoded_length ; ++ i )
	{
	printf ( "%02x" , кодировка_инструкция [ i ]);
	}

zydis

Функции

Примеры

Дизассемблер

Энкодер

Больше примеров

Строить

Cmake Build

Visual Studio 2022 Project

Cmake сгенерированный против проекта

Объединенное распределение

Управляющие пакетами

Использование Zydis в проекте Cmake

ZydisInfo инструмент

Привязки

Асмджит в стиле C ++ Фронт

Версии

Схема

Филиалы и теги

Кредиты

Поиск неисправностей

-fPIC для общих библиотечных сборок

Консалтинг и поддержка бизнеса

Пожертвования

Лицензия

`ZydisInfo` инструмент

`-fPIC` для общих библиотечных сборок