zydis

Velozes e leves x86/x86-64 desmontador e biblioteca de geração de código.

Características

• Suporta todas as instruções e extensões X86 e X86-64 (AMD64)
• Otimizado para alto desempenho
• Nenhuma alocação de memória dinâmica ("malloc")
• Seguro de threads por design
• Overhead de tamanho de arquivo muito pequeno em comparação com outras bibliotecas de desmontagem comuns
• Documentação completa do doxygen
• Confiável por muitos grandes projetos de código aberto
  • Exemplos incluem x64dbg, mozilla firefox e webkit
• Absolutamente nenhuma dependência de terceiros - nem mesmo libc
  • Deve compilar em qualquer plataforma com um compilador C11 funcionando
  • Testado no Windows, MacOS, FreeBSD, Linux e UEFI, modo de usuário e kernel

Exemplos

Desmontador

O programa de exemplo a seguir usa o ZYDIS para desmontar um determinado buffer de memória e imprime a saída no console.

zydis/exemplos/desmontosimple.c

Linhas 38 a 63 em 214536a

	Dados 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
	};
	// O endereço de tempo de execução (ponteiro de instrução) foi escolhido arbitrariamente aqui para melhorar
	// Visualize o endereçamento relativo. No seu programa real, defina -o para o endereço de memória
	// que o código que está sendo desmontado foi lido.
	Zyanu64 runtime_address = 0x007fffffff400000 ;
	// Faça um loop sobre as instruções em nosso buffer.
	Zyanusize offset = 0 ;
	ZyDisDisAssembledInstruction Instruction ;
	while ( zyan_success ( zydisdisassembleintel (
	/ * Machine_mode: */ zydis_machine_mode_long_64 ,
	/ * RUNTIME_ADDRESS: */ RUNTIME_ADDRESS ,
	/ * buffer: */ dados + deslocamento ,
	/ * Comprimento: */ sizeof ( dados ) - deslocamento ,
	/ * Instrução: */ & Instrução
	))) {
	printf ( " %016" prix64 " %s n" , runtime_address , instrução . texto );
	deslocamento += instrução . informações . comprimento ;
	RUNTime_Address += Instrução . informações . comprimento ;
	}

O programa de exemplo acima gera a seguinte saída:

 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

Codificador

zydis/exemplos/codemov.c

Linhas 39 a 62 em B37076E

	ZydisencoderRequest Req ;
	Memset ( & req , 0 , sizeof ( req ));
	Req . mnemonic = zydis_mnemonic_mov ;
	Req . máquina_mode = zydis_machine_mode_long_64 ;
	Req . operand_count = 2 ;
	Req . operando [ 0 ]. type = zydis_operand_type_register ;
	Req . operando [ 0 ]. Reg . valor = zydis_register_rax ;
	Req . operando [ 1 ]. type = zydis_operand_type_immediate ;
	Req . operando [ 1 ]. im . u = 0x1337 ;
	Zyanu8 coded_instruction [ zydis_max_instruction_length ];
	Zyanusize coded_length = sizeof ( coded_instruction );
	if ( zyan_failed ( zydisencoderencodeInstruction ( & req , coded_instruction , & coded_length )))))
	{
	puts ( "Falha ao codificar instruções" );
	retornar 1 ;
	}
	for ( zyanusize i = 0 ; i < coded_length ; ++ i )
	{
	printf ( "%02x" , coded_instruction [ i ]);
	}

O programa de exemplo acima gera a seguinte saída:

 48 C7 C0 37 13 00 00

Mais exemplos

Mais exemplos podem ser encontrados no diretório de exemplos deste repositório.

Construir

Existem muitas maneiras de disponibilizar Zydis em seu sistema. A lista de subseções a seguir comumente usadas opções.

Cmake Build

Plataformas: Windows, MacOS, Linux, BSDs

Você pode usar o CMake para construir Zydis em todas as plataformas suportadas. As instruções sobre como instalar o CMake podem ser encontradas aqui.

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

Projeto Visual Studio 2022

Plataformas: Windows

Mantemos manualmente um projeto do Visual Studio 2022, além da lógica do CMake Build.

CMake gerado vs Projeto

Plataformas: Windows

O CMake pode ser instruído a gerar um projeto do Visual Studio para praticamente qualquer versão VS. Um guia de vídeo que descreve como usar a GUI do CMake para gerar esses arquivos de projeto está disponível aqui. Não se confunda com o uso aparente de macOS no vídeo: o Windows está simplesmente sendo executado em uma máquina virtual.

Distribuição amalgamada

Plataformas: qualquer plataforma com um compilador C11 funcionando

Fornecemos um cabeçalho único gerado automaticamente e uma variante de arquivo de origem única do ZyDIS. Para usar essa variante de Zydis em seu projeto, tudo o que você precisa fazer é copiar esses dois arquivos para o seu projeto. As construções amalgamadas podem ser encontradas em nossa página de lançamento como zydis-amalgamated.tar.gz .

Esses arquivos são gerados com o script amalgamate.py .

Gerentes de pacotes

Plataformas: Windows, MacOS, Linux, FreeBSD

Cabeçalhos pré-criados, bibliotecas compartilhadas e executáveis ​​estão disponíveis através de uma variedade de gerentes de pacotes.

Versão Zydis em vários repositórios de pacotes

Repositório	Instalar comando
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

Usando Zydis em um projeto CMake

Um exemplo de como usar o ZYDIS em seu próprio projeto baseado em cmake pode ser encontrado neste repositório.

Ferramenta ZydisInfo

A ferramenta de linha de comando ZydisInfo pode ser usada para inspecionar essencialmente todas as informações que o ZYDIS fornece sobre uma instrução.

Ligações

Existem ligações oficiais para uma seleção de idiomas:

• Ferrugem
• Python 3

front-end de C ++ no estilo Asmjit

Se você está procurando um front-end de assembler no estilo ASMJIT para o codificador, confira o Zasm. O Zasm também fornece um invólucro C ++ idiomático em torno da interface decodificador e formatador.

Versões

Esquema

As versões seguem o esquema de versão semântica. Todas as garantias de estabilidade se aplicam apenas à API. A estabilidade da ABI é fornecida apenas entre versões de patch.

Filas e tags

• master detém o código de borda sangrando da próxima versão zydis não lançada. Quantidades aumentadas de bugs e problemas devem ser esperados e a estabilidade da API não é garantida fora das confirmações marcadas.
• As versões estáveis ​​e de visualização são anotadas com tags git
  • beta e outras versões de visualização têm -beta , -rc , etc. sufixos
• maintenance/v4 aponta para o código da versão mais recente do V4
  • V4 é a mais recente versão estável e recebe atualizações de recursos
• maintenance/v3 aponta para o código da versão mais recente do V3
  • V3 não receberá atualizações de recursos, mas receberá atualizações de segurança até 2025
• maintenance/v2 aponta para o código do último lançamento legado de V2
  • V2 é atingido no final da vida e não receberá nenhuma atualização de segurança

Créditos

• Intel (para XED de código aberto, permitindo uma comparação automática de nossas tabelas contra a deles, melhorando os dois)
• LLVM (para fornecer dados de instrução bastante sólidos também)
• Christian Ludloff (https://sandpile.org, insanamente útil)
• Lekoarts (para criar o logotipo do projeto)
• Nossos colaboradores no Github

Solução de problemas

-fPIC for Shared Library Builds

 /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

Sob algumas circunstâncias (por exemplo, ao construir Zydis como uma biblioteca estática usando o CMake e, em seguida, usar o Makefiles para vinculá -lo manualmente a uma biblioteca compartilhada), o CMake pode deixar de detectar que as informações de realocação devem ser emitidas. Isso pode ser forçado pela passagem -DCMAKE_POSITION_INDEPENDENT_CODE=ON à invocação do cmake.

Consultoria e suporte comercial

Oferecemos serviços de consultoria e suporte profissional para o ZYDIS. Se você precisar de uma extensão personalizada, requer ajuda para integrar Zydis ao seu produto ou simplesmente deseja atualizações e tempos de resposta garantidos contratualmente, estamos felizes em ajudar com isso! Please contact us at [email protected].

Doações

As doações são coletadas e distribuídas usando a conta de Flobernd.

Licença

O ZYDIS é licenciado sob a licença do MIT.