chopstix

Píblico

Extraer microbistres representativos.

Comienzo rápido

Ejecute el siguiente comando para instalar Chopstix:

 ./install.sh <INSTALLATION_DIRECTORY>

El comando realizará todos los pasos necesarios (es decir, incluida la descarga de requisitos específicos) e instalará Chopstix en `<Stallation_Directory>.

Instalación

La siguiente es una lista de los requisitos mínimos de software para poder instalar Chopstix.

• Un compilador con soporte C ++ 11 (por ejemplo, GCC 4.8.4)
• libpfm-4.8.0: http://perfmon2.sourceforge.net/
• Cmake> = 2.8
• Git
• Python 3 (opcional)
• sqlite3 (opcional)

Para descargar y configurar Chopstix para la instalación, siga estos pasos:

 git clone https://github.com/IBM/chopstix.git chopstix
cd chopstix
git submodule sync
git submodule update --init --recursive

Si descarga el contenido del repositorio directamente desde github.com como un archivo zip comprimido, también debe descargar las dependencias externas y descomprimirlas en el directorio ./external .

Compilación

Chopstix usa CMake como sistema de compilación. Hemos proporcionado un envoltorio simple en forma de un script de configuración para proporcionar una interfaz más accesible.

El flujo de trabajo de construcción básica es el siguiente:

 mkdir build
cd build
../configure
make && make install

Para obtener información más detallada sobre las opciones de configuración, consulte Documentación de instalación.

Uso básico

Chopstix guarda toda la información recopilada en una base de datos SQL local. Por defecto, guardará datos en chop.db La mayoría de los comandos tienen una opción -data para cambiar esta ruta.

En general, puede invocar cualquier comando usando chop <command> . Para obtener más información sobre un comando específico, intente chop help <command> . También hay algunos scripts de utilidad (es decir, chop-marks ) que generalmente tienen prefijo por chop- .

El flujo de trabajo básico para Chopstix es el siguiente:

 chop sample ./my_app     # Sample invocation of ./my_app
chop disasm              # Detect and disassemble used object files
chop count               # Group and count samples per instruction
chop annotate            # Annotate control flow graph
chop search -target-coverage 90%   # Generate hottest paths
chop list paths          # List generated paths
chop text path -id <id>  # Show instructions for path with <id>

Para un ejemplo de flujo de trabajo más detallado, consulte los siguientes documentos:

• Instalación
• Uso general
  • Rastreo
  • Ejemplo de flujo de trabajo
• Información de desarrollo
  • Custom_Commands
  • Diseño de la base de datos
  • Depurar
  • Eventos Power8