Profiling/fr: what changed
Revision 3 to 4. Removed lines have a minus sign; added lines have a plus sign.
| Old | New | Line | |
|---|---|---|---|
| 1 | 1 | **Profiling** est une technique d'analyse des performances qui peuvent être utilisées pour trouver les goulots d'étranglement dans votre application. En particulier, elle englobe la mesure de la fréquence et de la durée des appels de fonction. | |
| 2 | 2 | ||
| 3 | 3 | ## Profilage et optimisation | |
| 4 | 4 | ||
| 5 | 5 | Le profilage peut aider à identifier les différentes parties 'critiques' de votre code, dont l'optimisation pourrait sérieusement améliorer la performance de votre programme. Il vaut mieux le faire au moment ou vous vous préparez à faire une réalisation(release) et que vous avez une fonctionnalité qui ralenti fortement votre code. C'est une perte de temps et de ressources d'optimiser quelque chose qui va être jeté les jours suivant pendant une quelconque restructuration de code. | |
| 6 | 6 | ||
| 7 | 7 | Faites attention à ne pas sur-optimiser votre programme. Cela vaut rarement la peine de passer des jours à la seule obtention d'un gain d'exécution de 2%. On peut généralement éliminer 30% du temps d'exécution en juste une demi heure de codage avec quelques optimisations qui seront utiles. | |
| 8 | 8 | ||
| 9 | 9 | Bien sûr, l'optimisation du code qui est très souvent réutilisé vaut un peu plus d'efforts pour gagner en performance. | |
| 10 | 10 | ||
| 11 | 11 | ## Prise en charge du profileur par FreePascal | |
| 12 | 12 | ||
| 13 | 13 | FreePascal a une prise en charge intégrée pour produire des exécutables appropriés (au moins) pour deux profileurs: | |
| 14 | 14 | ||
| 15 | 15 | - gprof, le profileur Gnu: permis avec l'option `-pg`. | |
| 16 | 16 | - Valgrind, en utilisant le plug-in Callgrind: permis avec l'option `-gv`. | |
| 17 | 17 | ||
| 18 | 18 | Malheureusement, la prise en charge du profileur pourrait ne pas être disponible (a moins de: travailler directement de manière séparée) pour toutes les plateformes. gprof ne fonctionne plus avec linux depuis fpc 2.2.0. Valgrind devrait fonctionner avec Linux (et systèmes apparentés). Pour Windows des étapes supplémentaires pourraient être nécessaires pour la prise en charge de gprof fonctionne. Valgrind est tout simplement disponible uniquement pour Linux et quelques autres systèmes UNIX. | |
| 19 | 19 | ||
| 20 | 20 | ## Utilisation de Valgrind/Callgrind | |
| 21 | 21 | ||
| 22 | 22 | Valgrind était à l'origine seulement un débogueur de mémoire, mais maintenant il prend aussi en charge par exemple le profilage à l'aide du plug-in Callgrind( qui a remplacé le plugin calltree). Pour installer Valgrind avec Callgrind sur Debian, exécutez par exemple | |
| 23 | 23 | ||
| 24 | - | ||
| 24 | + | ```text | |
| 25 | + | aptitude install valgrind valgrind-callgrind | |
| 26 | + | ``` | |
| 25 | 27 | ||
| 26 | 28 | Pour profiler votre programme, vous devez suivre trois étapes | |
| 27 | 29 | ||
| 28 | 30 | - Compilez votre programme avec l'option `-gv` . | |
| 29 | 31 | - Exécutez votre programme en utilisant `valgrind` | |
| 30 | 32 | - Analyser la sortie obtenue avec `valgrind_annotate` ou avec l'outil avec interface graphique `KCacheGrind` | |
| 31 | 33 | ||
| 32 | 34 | Compilez votre programme avec | |
| 33 | 35 | ||
| 34 | - | ||
| 36 | + | ```text | |
| 37 | + | fpc -gv myprogram.pas | |
| 38 | + | ``` | |
| 35 | 39 | ||
| 36 | 40 | Exécutez Valgrind en utilisant par exemple | |
| 37 | 41 | ||
| 38 | - | ||
| 42 | + | ``` pascal | |
| 43 | + | valgrind --tool=callgrind ./myprogram --options --to --my --program | |
| 44 | + | ``` | |
| 39 | 45 | ||
| 40 | 46 | Vous pouvez également profiler uniquement des parties spécifiques de votre programme. Par exemple vous pouvez démarrer le programme avec | |
| 41 | 47 | ||
| 42 | - | ||
| 48 | + | ``` pascal | |
| 49 | + | valgrind --instr-atstart=off ./myprogram --options --to --my --program | |
| 50 | + | ``` | |
| 43 | 51 | ||
| 44 | 52 | Au moment ou vous voulez que le profilage réel démarre, exécutez | |
| 45 | 53 | ||
| 46 | - | ||
| 54 | + | ```text | |
| 55 | + | valgrind_control -i on | |
| 56 | + | ``` | |
| 47 | 57 | ||
| 48 | 58 | Pour arrêter le profilage, exécutez la même commande avec `off` au lieu de `on`. Pour obtenir uniquement des informations de profilage quand vous êtes dans une fonction particulière, vous pouvez transmettre l'option `--toggle-collect=funcNamePrefix` à valgrind. Reportez-vous à la documentation de Valgrind pour plus de détails. | |
| 49 | 59 | ||
| 50 | 60 | Callgrind a créé un fichier de traçage avec un nom typique du genre `callgrind.out.12345`. Pour obtenir un rapport statistique lisible, exécutez par exemple | |
| 51 | 61 | ||
| 52 | - | ||
| 62 | + | ```text | |
| 63 | + | callgrind_annotate callgrind.out.12345 | |
| 64 | + | ``` | |
| 53 | 65 | ||
| 54 | 66 | Bien sûr, vous pouvez également faire une expérimentation avec les autres outils plug-ins qui sont fournies avec Valgrind. Cachegrind, par exemple, fait le profilage de l'utilisation du cache. d'autres plug-ins peuvent être utilisés pour profiler ou déboguer l'allocation de mémoire ou détecter les conditions de transfert de données. | |
| 55 | 67 | ||
| 56 | 68 | ## Utilisation de KCacheGrind | |
| 57 | 69 | ||
| 58 | 70 | Bien que la sortie de `callgrind_annotate` peut certainement faire la lumière sur les caractéristiques de performance de votre programme, l'outil avec interface graphique KCacheGrind peut vous donner des informations encore plus intéressant, présentée sous différentes formes: des listes d'appellant/appelé, des cartes d'appelant/appelé et des graphiques d'appel. Pour l'installer sur Debian, exécutez | |
| 59 | 71 | ||
| 60 | - | ||
| 72 | + | ```text | |
| 73 | + | aptitude install kcachegrind graphviz | |
| 74 | + | ``` | |
| 61 | 75 | ||
| 62 | 76 | (Le paquet `graphviz` est nécessaire si vous voulez générer avec KCacheGrind des graphes d'appel.) | |
| 63 | 77 | ||
| 64 | 78 |  | |
| 65 | 79 | ||
| 66 | 80 | Exécutez KCachegrind avec un appel simple à `kcachegrind`. Vous pouvez maintenant ouvrir un fichier de traçage en utilisant l'interface graphique et tout devraient être auto-explicatif. | |
| 67 | 81 | ||
| 68 | 82 | Sur la gauche, vous verrez un 'profil plat', lequel liste pour chaque fonction : (dans le top 100) | |
| 69 | 83 | ||
| 70 | 84 | - Incl: durée passée dans la fonction, *y compris* ce qui est appelé (les fonctions appelées par la fonction). | |
| 71 | 85 | - Self: durée passée au sein de la fonction elle-même, *à l'exception* de ce qui est appelé. | |
| 72 | 86 | - Called: le nombre de fois où la fonction a été appelée. | |
| 73 | 87 | ||
| 74 | 88 | *Note:* Si vous cliquez sur l'un des entêtes de colonne pour trier la liste, vous pourriez avoir besoin de faire une réactualisation (F5) pour veiller à ce que le top 100 *en ce qui concerne cette colonne* sera affiché. Une autre astuce: dans les options de configuration, vous pouvez rendre la liste plus longue que seulement le top 100. | |
| 75 | 89 | ||
| 76 | 90 | Sur la droite, vous verrez un certain nombre d'onglets, vous permettant de voir des listes et des cartes d'appelants et d'appelés, ainsi qu'un graphique d'appels, ce qui est très utile pour voir d'un coup d'œil qui appelle le plus. | |
| 77 | 91 | ||
| 78 | 92 | ## Profilage de la mémoire | |
| 79 | 93 | ||
| 80 | 94 | ### Heaptrc, LineInfo | |
| 81 | 95 | ||
| 82 | 96 | Pour détecter des fuites de mémoire, compilez simplement avec -gh. Cela va compiler comme si vous avez ajouté l'unité **heaptrc** en tant que première unité de la section uses de votre programme. Heaptrc est lié au gestionnaire de mémoire de fpc et vérifie plusieurs choses. En collaboration avec l'option -gl (par ajout de l'unité lineinfo) il vous donnera des informations utiles et backtraces, là où un bloc de mémoire a été allouée. Il prend en charge certaines options qui peuvent être contrôlée via l'option d'environnement *HEAPTRC* contenant des mots-clés: | |
| 83 | 97 | ||
| 84 | 98 | - keepreleased: Toute la mémoire libérée, est gardée et vérifiée si écrasée. | |
| 85 | 99 | - disabled: désactiver le traçage. Ceci est utile pour des programmes compilés avec heaptrc et devrait fonctionner normalement. | |
| 86 | 100 | - nohalt: normalement heaptrc s'arrête sur la première erreur qu'il trouve. Ajouter ce mot clé si le programme doit continuer( comme il le ferait normalement, sans heaptrc). | |
| 87 | 101 | - haltonnotreleased: Normalement heaptrc imprime pour chaque bloc non libéré un backtrace, qui peut prendre un certain temps. Ajouter ce mot clé pour faire un arrêt après la première fuite de mémoire signalée. | |
| 88 | 102 | - log=\<filename\>: Au lieu d'écrire sur la sortie standard(stdout), vous pouvez donner un nom de fichier log. | |
| 89 | 103 | ||
| 90 | 104 | Commentaire: **heaptrc** entrera en conflit avec **cmem** si vous avez de déboguer des bibliothèques externes. Valgrind devrait être utilisée dans ce cas. | |
| 91 | 105 | ||
| 92 | 106 | ### Vérification de mémoire avec Valgrind | |
| 93 | 107 | ||
| 94 | 108 | Il y a des fuites de mémoire que heaptrc ne trouve pas. Le programme valgrind dispose d'un outil appelé memcheck, qui fait beaucoup plus de comptabilité que heaptrc et trouve quelques bugs de plus. L'inconvénient est que valgrind est lent comme un escargot, aussi ne faites cela que si heaptrc n'a pas pu vous aider. Voici un exemple: | |
| 95 | 109 | ||
| 96 | - | ||
| 110 | + | ```text | |
| 111 | + | valgrind --tool=memcheck --leak-check=summary --log-file=log.txt ./project1 | |
| 112 | + | ``` | |
| 97 | 113 | ||
| 98 | 114 | Le fichier log.txt trouvera presque toujours quelque chose, parce qu'il cherche aussi à vérifier les bibliothèques externes utilisées et certaines bibliothèques communes sont mal codées. | |
| 99 | 115 | ||
| 100 | 116 | Pour obtenir encore plus d'informations exécutez avec | |
| 101 | 117 | ||
| 102 | - | ||
| 118 | + | ```text | |
| 119 | + | valgrind --tool=memcheck --leak-check=full --log-file=log.txt --show-reachable=yes --num-callers=128 ./project1 | |
| 120 | + | ``` | |
| 103 | 121 | ||
| 104 | 122 | --- | |
| 105 | 123 | *From the Free Pascal wiki, page "Profiling/fr", as it stood on 2017-11-19 after a change by FTurtle, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).* | |
| 106 | 124 | Category: Debugging/fr |