Vargas : Outils de débogage

Pour connaître les options permettant de déboguer un programme en Fortran et en C.

Pour les programmes séquentiels, on peut utiliser le débogueur ligne à ligne dbx. Les instructions de dbx sont référencées dans le manuel en ligne(man dbx). La table des symboles qui facilite l'analysedu débogage sous dbx est obtenue à l'aide de l'option de compilation -g.
Voici un exemple d'utilisation :
```
vargas : xlf90 -g -qnooptimize -qfullpath test.f (en Fortran)
vargas : dbx ./a.out
vargas : xlc -g -qnooptimize -qfullpath test.c (en C)
vargas : dbx ./a.out
vargas : xlC -g -qnooptimize -qfullpath test.C (en C++)
vargas : dbx ./a.out
```
Remarques :
- l'option de compilation -g n'entraine pas de surcoût de la consommation du temps CPU; elle est maintenant être positionnée par défaut, aussi n'avez-vous pas à la spécifier,
- pour déboguer correctement un programme sur Vargas il est important d'inhiber toute(s) optimisation(s) en positionnant -qnooptimize ou -O0 (o majuscule et zéro) à la compilation,
- l'option de compilation -qfullpath indiquera le chemin d'accès au fichier source lorsque vous utiliserez un débogueur.

Le débogueur TotalView est disponible.

Le code peut être séquentiel aussi bien que parallèle ; sont supportés la bibliothèque d'échange de messages MPI ainsi qu'OpenMP. TotalView démarre une interface graphique XWindows : il faut donc que vous ayez préalablement positionné la variable DISPLAY correspondant à votre écran et autorisé l'affichage d'une fenêtre X-Window sur celui-ci.
Il faut également que vous ayez lancé la commande
```
vargas : module load tv
```
pour pouvoir y accéder aux exécutables et aux bibliothèques nécessaires à l'exécution de TotalView.
En interactif séquentiel : après avoir lancé la commande module décrite ci-dessus, il suffit d'appeler tv, tv8 ou totalview. Si vous n'avez pas possibilité d'afficher une fenêtre graphique, vous pouvez aussi travailler avec l'interface de commande en ligne totalviewcli, ou encore tvcli ou tv8cli. Mais d'une part cela enlève une grande partie de l'interêt de Totalview (son interface graphique), d'autre part cela rend indispensable d'avoir le Guide de Référence à disposition.

En interactif parallèle : pour pouvoir lancer une session interactive parallèle sur les noeuds de Vargas il est nécessaire de lancer une fois pour toutes la commande
addutv pour autoriser votre login à lancer Totalview depuis un noeud autres que le noeud interactif. Votre login sera inscrit dans la demi-journée (un programme passe à 10h, 14 et 18h tous les jours). Une fois cette formalité effectuée, vous pouvez lancer TotalView en parallèle. Nous vous demandons de bien vouloir lancer (une fois pour toutes) la commande delutv quand vous aurez la certitude d'avoir terminé votre débogage.

Le nombre de processeurs demandés se règle via une variable d'environnement : MP_PROCS.
Pour 8 processeurs par exemple, on fera
```
vargas : export MP_PROCS=8
vargas : tv poe -a ./mon_executable
```
Dans un premier temps, TotalView affiche des informations relatives à son initialisation : cliquer sur OK; puis dans la fenêtre principale cliquer sur la flèche verte Go. Puis Totalview demande si l'on veut s'arrêter juste avant le démarrage en parallèle de l'exécutable proprement dit (pour positionner des points d'arrêt par exemple) : il faut cliquer sur Yes . Le code source de l'exécutable s'affiche alors dans la fenêtre principale.

En batch parallèle : pour pouvoir lancer une session de débogage en parallèle sur les noeuds de Vargas il est nécessaire de taper une fois pour toutes la commande
addutv pour autoriser votre login à lancer Totalview sur des noeuds autres que le noeud interactif; votre login sera inscrit dans la demi-journée (un programme passe à 10h, 14 et 18h tous les jours). Une fois cette formalité effectuée, vous pouvez lancer TotalView en parallèle. Nous vous demandons de bien vouloir lancer (une fois pour toutes) la commande delutv une fois que vous aurez la certitude d'avoir terminé votre débogage.

Voici un exemple minimal de soumission pour une session de débogage MPI sur 16 coeurs :
```
# @ job_name = Totalview
# @ job_type = parallel
# Fichier sortie standard du travail
# @ output = $(job_name).$(jobid)
# Fichier erreur standard du travail
# @ error = $(output)
# Temps elapsed maximum demande
# @ wall_clock_limit = 10:00
# Nombre de processeurs
# @ total_tasks = 16
# @ queue

# Pour avoir l'écho des commandes
set -x

# Pour se mettre dans le repertoire d'ou on a soumis ce job :
cd $LOADL_STEP_INITDIR

export DISPLAY=mon_ecran.labo.fr:0
module load tv
tv poe -a ./mon_executable
```
Dans un premier temps, Totalview affiche des informations relatives à son initialisation : cliquer sur OK; puis dans la fenêtre principale cliquer sur la flèche verte Go . Enfin Totalview demande si l'on veut s'arrêter juste avant le démarrage en parallèle de l'exécutable proprement dit (pour positionner des points d'arrêt par exemple) : il faut cliquer sur Yes . Le source de l'exécutable s'affiche alors dans la fenêtre principale.

La documentation interactive complète en anglais de la toute dernière version sortie est disponible sur le serveur d'Etnus ainsi que l'ensemble des documents en version PDF.

Nous mettons aussi directement à disposition les documents PDF concernant la version par défaut 8.9.1 installée sur Vargas, en anglais eux aussi :
- le Guide de l'Utilisateur,
- le Guide de Reférence ,
- Le débogage mémoire,
- Le nouveautés apportées par cette version (et un récapitulatif portant sur les versions précédentes).
© CNRS - IDRIS, 13/01/2012

Vargas : Outils de débogage

© CNRS - IDRIS, 13/01/2012