bochscpu-python

Bindings de Python para el BochsCPU de @yrp usando FFI para emular código x86 de forma fácil y precisa.

Instalación

bochscpu-python solo requiere un entorno de Python 3.8 o más reciente.

Vía PyPI (preferido)

Con diferencia, la forma más sencilla de ponerlo en marcha es usar la versión estable empaquetada en PyPI

python -m pip install bochscpu-python

Vía las compilaciones generadas

Descargue el último artefacto funcional desde la pestaña GitHub Actions del repositorio. Extraiga el archivo ZIP e instale el archivo .whl que encontrará dentro de la carpeta wheel.

python -m pip install wheel/bochscpu-$version-$os-$arch.whl

Desde el repositorio fuente

Bastante sencillo:

python -m pip install .

O sin clonar

python -m pip install git+https://github.com/hugsy/bochscpu-python.git#egg=bochscpu-python

Tenga en cuenta que este método requerirá tener instaladas todas las herramientas de compilación necesarias (como se describe a continuación)

Compilación

Requisitos

• Python 3.8+ (con kit de desarrollo)
• cmake
• pip
• un compilador compatible con C++20 (probado con cl para Windows, clang++ para macOS y g++ para Linux)

Pasos

• Compile BochsCPU, BochsCPU-FFI y BochsCPU-Build siguiendo las instrucciones de sus respectivas páginas
• ... Alternativamente, los archivos objeto de las bibliotecas BochsCPU-FFI para Windows y Linux se pueden descargar desde las GitHub Actions de build
• Mueva los *.lib a bochscpu/lib/<BuildType> (donde BuildType puede ser Debug, Release, RelWithDebInfo, etc.)
• Instale los requisitos: python -m pip install -r requirements.txt
• Compile con cmake Esto generará el archivo pyd de bochscpu (y su PDB) que podrá importar desde una sesión de Python con import bochscpu.
• ... Alternativamente, también puede generar un .whl desde la raíz del proyecto:

python -m pip wheel .

Uso

Simplemente importe el módulo bochscpu y ¡que comience la diversión! Instalar el paquete también instalará archivos de interfaz, lo que permitirá a los IDE modernos (VSCode, PyCharm, etc.) ofrecer un autocompletado útil.

Se puede crear una plantilla muy básica así:

import bochscpu, bochscpu.utils, bochscpu.cpu

sess = bochscpu.Session()
sess.missing_page_handler = bochscpu.utils.callbacks.missing_page_cb
state = bochscpu.State()
bochscpu.cpu.set_real_mode(state)
hook = bochscpu.Hook()
bochscpu.utils.callbacks.install_default_callbacks(hook)
sess.run([hook,])

Esto creará una sesión de bochscpu, establecerá el estado de la CPU en modo real y precargará los hooks con callbacks básicos (que solo realizan un print al ejecutarse). Tenga en cuenta que este ejemplo en realidad no hará nada, ya que no hemos asignado páginas de código ni configurado correctamente los registros para que apunten a él.

Se puede encontrar una plantilla más completa en la carpeta examples/

Algunos Ejemplos

Disfruta 🍻