libgoblin

di las palabras correctas

Documentación

https://docs.rs/goblin/

registro de cambios

Uso

Goblin requiere rustc 1.85.0 (Rust edición 2024).

Añade a tu Cargo.toml

[dependencies]
goblin = "0.10"

Características

nombre increíble del crate
implementación zero-copy, multiplataforma, consciente de endianness, ELF64/32 - ¡wow!
analizador zero-copy, multiplataforma, consciente de endianness, Mach-o de 32/64 bits - ¡zoiks!
analizador PE de 32/64 bits - ¡bing!
un analizador de archivos estilo Unix y BSD (este último cortesía de @willglynn) - ¡hurra!
muchas opciones de cfg - ¡te hará dar vueltas la cabeza y enfadarte al leer el código fuente!
fuzzeado - "Me complace informar que goblin resistió 100 millones de ejecuciones de fuzzing, 1 millón de ejecuciones cada una para la semilla 1~100." - @sanxiyn
pruebas

libgoblin pretende ser tu tienda única para análisis, carga y análisis de binarios.

Casos de uso

Goblin soporta principalmente los siguientes casos de uso importantes:

Estructuras #[repr(C)] centrales, sin std, tiempo de compilación mínimo, 32/64 (o ambas) a tu gusto.
Type punning. Define una función una vez en un tipo, pero haz que funcione en variantes de 32 o 64 bits - sin cambiar realmente nada, ¡y sin macros! Consulta examples/automagic.rs para un ejemplo básico.
Modo std. Esto añade implementaciones de lectura y escritura mediante Pread y Pwrite, lectura desde archivo, asignaciones convenientes, métodos adicionales, etc. Esto es para clientes que pueden asignar memoria y quieren leer binarios desde el disco.
Endian_fd. Un nombre realmente terrible 😆 esto es para análisis de binarios como en panopticon o falcon que necesita leer binarios de endianness foránea, o como base para construir binutils de arquitectura foránea multiplataforma, por ejemplo cargo-sym y bingrep son ejemplos simples de esto, pero el cielo es el límite.

Aquí hay algunas cosas que podrías hacer con este crate (o ayudar a implementar para que se puedan hacer):

Escribe un compilador y úsalo para generar binarios (todas las estructuras C sin procesar tienen Pwrite derivado).
Escribe una herramienta de análisis de binarios que cargue, analice y examine varios formatos binarios, por ejemplo, panopticon o falcon.
Escribe un enlazador dinámico semi-funcional.
Escribe un kernel y carga binarios usando cfg no_std. Es decir, es esencialmente solo definiciones de struct y constantes (como un encabezado C) - sin fd, sin salida, sin std.
Escribe una herramienta bin2json, porque ¿por qué los formatos binarios no deberían estar en JSON?

Configuraciones (Cfgs)

libgoblin está diseñado para ser masivamente configurable. Las banderas actuales son:

elf64 - binarios elf de 64 bits, definiciones de struct repr(C)
elf32 - binarios elf de 32 bits, definiciones de struct repr(C)
mach64 - definiciones de struct repr(C) de mach-o de 64 bits
mach32 - definiciones de struct repr(C) de mach-o de 32 bits
pe32 - definiciones de struct repr(C) de PE de 32 bits
pe64 - definiciones de struct repr(C) de PE de 64 bits

te - definiciones de struct repr(C) de Terse Executable (TE)

archive - un analizador de archivos Unix
endian_fd - analiza según la endianness en el binario
std - para permitir entornos no_std

Mantenedores

PE: @kkent030315
Elf: @m4b, abierto a solicitudes
Mach-o: @m4b, abierto a solicitudes

Los mantenedores son los revisores de primer contacto para ese backend en particular. Son elegidos según contribuciones previas, actividad, conocimiento base y comportamiento amigable y gregario :D

Actualmente, yo (@m4b) solo tengo derechos de fusión para todos los PRs. En el futuro es probable que el/los mantenedor(es) de ese backend dado también tengan derechos de fusión.

Por último, probablemente seguiré dando revisiones superficiales a todos los PRs, pero delegaré mayormente/completamente al mantenedor de ese backend.

Y recuerda siempre la sabiduría de Bill y Ted: "¡Sed excelentes los unos con los otros!"

Contribuidores

¡Gracias a todos ❤️!

En orden lexicográfico:

Contribuir

A menos que se indique explícitamente lo contrario, aceptas que tus contribuciones tienen la licencia descrita en el archivo LICENSE adjunto (MIT).

Por favor, prefija los commits con el componente binario afectado; cuanto más específico mejor, p.ej., si solo modificas reubicaciones en el módulo elf, entonces haz "elf.reloc: added new constants for Z80"
Los mensajes de commit deben explicar su cambio, sin "cambiado" o "arreglo" genéricos; si envías commits así en un PR, ten en cuenta que @m4b o alguien probablemente los aplastará.
Si estás haciendo un cambio grande en un módulo, por favor abre un issue primero y discutamos; no quiero desperdiciar tu tiempo si no es una buena dirección técnica, etc.
Si tu PR no recibe atención, por favor responde a todos los comentarios relevantes planteados en el PR, y si aún no hay respuesta, menciona a @m4b en github y también siéntete libre de enviar un correo electrónico a @m4b.
Por favor, añade pruebas si estás agregando una nueva característica. Siéntete libre de añadir pruebas incluso si no lo estás, las pruebas son geniales y fáciles en rust.

goblin

Más Populares