chopstix

Hachiéton

Extraire les microbenchacs représentatifs.

Démarrage rapide

Exécutez la commande suivante pour installer Chopstix:

 ./install.sh <INSTALLATION_DIRECTORY>

La commande effectuera toutes les étapes nécessaires (c'est-à-dire y compris le téléchargement des exigences spécifiques) et installera Chopstix dans `<Installalation_directory>.

Installation

Ce qui suit est une liste des exigences logicielles minimales pour pouvoir installer des Chopstix.

• Un compilateur avec le support C ++ 11 (par exemple GCC 4.8.4)
• libpfm-4.8.0: http://perfmon2.sourceforge.net/
• Cmake> = 2,8
• Git
• Python 3 (facultatif)
• sqlite3 (facultatif)

Pour télécharger et configurer des Chopstix pour l'installation, suivez ces étapes:

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

Si vous téléchargez le contenu du référentiel directement à partir de github.com en tant que fichier zip compressé, vous devez également télécharger les dépendances externes et les décompresser dans le répertoire ./external .

Compilation

Chopstix utilise CMake comme système de construction. Nous avons fourni un simple enveloppe sous forme de script de configuration afin de fournir une interface plus accessible.

Le flux de travail de base de base est le suivant:

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

Pour des informations plus détaillées concernant les options de configuration, voir la documentation d'installation.

Utilisation de base

Chopstix enregistre toutes les informations collectées dans une base de données SQL locale. Par défaut, il enregistrera des données sur chop.db La plupart des commandes ont une option -data pour modifier ce chemin.

En général, vous pouvez invoquer n'importe quelle commande à l'aide de chop <command> . Pour plus d'informations sur une commande spécifique, essayez chop help <command> . Il existe également des scripts utilitaires (c.-à-d. chop-marks ) qui sont généralement préfixées par chop- .

Le flux de travail de base pour Chopstix est le suivant:

 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>

Pour un exemple de flux de travail plus détaillé, consultez les documents suivants:

• Installation
• Utilisation générale
  • Tracé
  • Exemple de workflow
• Informations sur le développement
  • Custom_commands
  • Disposition de la base de données
  • Déboguer
  • Événements Power8