Logiciel - Binutils (GNU Binary Utilities) - Référence des commandes

addr2line	Adresse à ligne
Binutils (GNU Binary Utilities)

Syntaxe

Paramètres

Nom	Description
-a	Ce paramètre permet d'afficher l'adresse avant les informations sur le nom de la fonction, le fichier et le numéro de ligne. L'adresse est affichée avec un préfixe «0x» pour l'identifier facilement.
--addresses	Ce paramètre permet d'afficher l'adresse avant les informations sur le nom de la fonction, le fichier et le numéro de ligne. L'adresse est affichée avec un préfixe «0x» pour l'identifier facilement.
-b bfdname	Ce paramètre permet d'indiquer que le format du code objet pour les fichiers objets est bfdname.
--basenames	Ce paramètre permet d'afficher uniquement la base de chaque nom de fichier.
-C[=style]	Ce paramètre permet de décoder (démêlez) les noms de symboles de bas niveau en noms de niveau utilisateur. En plus de supprimer tout trait de soulignement initial ajouté par le système, cela rend les noms de fonctions C++ lisibles. Différents compilateurs ont différents styles de modification. Le paramètre facultatif de style de démembrement peut être utilisé pour choisir un style de démêlage approprié pour votre compilateur. Voir c++filt, pour plus d'informations sur le démêlage.
--demangle[=style]	Ce paramètre permet de décoder (démêlez) les noms de symboles de bas niveau en noms de niveau utilisateur. En plus de supprimer tout trait de soulignement initial ajouté par le système, cela rend les noms de fonctions C++ lisibles. Différents compilateurs ont différents styles de modification. Le paramètre facultatif de style de démembrement peut être utilisé pour choisir un style de démêlage approprié pour votre compilateur. Voir c++filt, pour plus d'informations sur le démêlage.
-e filename	Ce paramètre permet d'indiquer le nom de l'exécutable pour lequel les adresses doivent être traduites. Le fichier par défaut est a.out.
--exe=filename	Ce paramètre permet d'indiquer le nom de l'exécutable pour lequel les adresses doivent être traduites. Le fichier par défaut est a.out.
-f	Ce paramètre permet d'afficher les noms des fonctions ainsi que les informations sur les numéros de fichiers et de lignes.
--functions	Ce paramètre permet d'afficher les noms des fonctions ainsi que les informations sur les numéros de fichiers et de lignes.
-i	Ce paramètre permet d'indiquer, si l'adresse appartient à une fonction ayant été intégrée, que les informations source de toutes les étendues englobantes jusqu'à la première fonction non intégrée seront également affichées. Par exemple, si le main insère callee1 intégrant callee2 et que l'adresse provient du callee2, les informations source du callee1 et du main seront également affichées.
--inlines	Ce paramètre permet d'indiquer, si l'adresse appartient à une fonction ayant été intégrée, que les informations source de toutes les étendues englobantes jusqu'à la première fonction non intégrée seront également affichées. Par exemple, si le main insère callee1 intégrant callee2 et que l'adresse provient du callee2, les informations source du callee1 et du main seront également affichées.
-j	Ce paramètre permet de lire les déplacements par rapport à la section spécifiée au lieu des adresses absolues.
--no-recurse-limit	Ce paramètre permet de désactiver une limite sur la quantité de récursion effectuée lors du démêlage des chaînes. Étant donné que les formats de modification de noms permettent un niveau de récursion infini, il est possible de créer des chaînes dont le décodage épuisera la quantité d'espace de pile disponible sur la machine hôte, déclenchant une erreur de mémoire. La limite tente d'empêcher que cela ne se produise en limitant la récursivité à 2 048 niveaux d'imbrication. Par défaut, cette limite est activée, mais sa désactivation peut être nécessaire afin de démanteler les noms vraiment compliqués. Notez cependant que si la limite de récursivité est désactivée, l'épuisement de la pile est possible et tout rapport de bogue concernant un tel événement sera rejeté.
--no-recursion-limit	Ce paramètre permet de désactiver une limite sur la quantité de récursion effectuée lors du démêlage des chaînes. Étant donné que les formats de modification de noms permettent un niveau de récursion infini, il est possible de créer des chaînes dont le décodage épuisera la quantité d'espace de pile disponible sur la machine hôte, déclenchant une erreur de mémoire. La limite tente d'empêcher que cela ne se produise en limitant la récursivité à 2 048 niveaux d'imbrication. Par défaut, cette limite est activée, mais sa désactivation peut être nécessaire afin de démanteler les noms vraiment compliqués. Notez cependant que si la limite de récursivité est désactivée, l'épuisement de la pile est possible et tout rapport de bogue concernant un tel événement sera rejeté.
-p	Ce paramètre permet de rendre la sortie plus conviviale : chaque emplacement est affiché sur une seule ligne. Si l'option -i est spécifiée, les lignes de toutes les étendues englobantes sont préfixées par «(inlined by)».
--pretty-print	Ce paramètre permet de rendre la sortie plus conviviale : chaque emplacement est affiché sur une seule ligne. Si l'option -i est spécifiée, les lignes de toutes les étendues englobantes sont préfixées par «(inlined by)».
-R	Ce paramètre permet d'activer une limite sur la quantité de récursion effectuée lors du démêlage des chaînes. Étant donné que les formats de modification de noms permettent un niveau de récursion infini, il est possible de créer des chaînes dont le décodage épuisera la quantité d'espace de pile disponible sur la machine hôte, déclenchant une erreur de mémoire. La limite tente d'empêcher que cela ne se produise en limitant la récursivité à 2 048 niveaux d'imbrication. Par défaut, cette limite est activée, mais sa désactivation peut être nécessaire afin de démanteler les noms vraiment compliqués. Notez cependant que si la limite de récursivité est désactivée, l'épuisement de la pile est possible et tout rapport de bogue concernant un tel événement sera rejeté.
-r	Ce paramètre permet d'activer une limite sur la quantité de récursion effectuée lors du démêlage des chaînes. Étant donné que les formats de modification de noms permettent un niveau de récursion infini, il est possible de créer des chaînes dont le décodage épuisera la quantité d'espace de pile disponible sur la machine hôte, déclenchant une erreur de mémoire. La limite tente d'empêcher que cela ne se produise en limitant la récursivité à 2 048 niveaux d'imbrication. Par défaut, cette limite est activée, mais sa désactivation peut être nécessaire afin de démanteler les noms vraiment compliqués. Notez cependant que si la limite de récursivité est désactivée, l'épuisement de la pile est possible et tout rapport de bogue concernant un tel événement sera rejeté.
--recurse-limit	Ce paramètre permet d'activer une limite sur la quantité de récursion effectuée lors du démêlage des chaînes. Étant donné que les formats de modification de noms permettent un niveau de récursion infini, il est possible de créer des chaînes dont le décodage épuisera la quantité d'espace de pile disponible sur la machine hôte, déclenchant une erreur de mémoire. La limite tente d'empêcher que cela ne se produise en limitant la récursivité à 2 048 niveaux d'imbrication. Par défaut, cette limite est activée, mais sa désactivation peut être nécessaire afin de démanteler les noms vraiment compliqués. Notez cependant que si la limite de récursivité est désactivée, l'épuisement de la pile est possible et tout rapport de bogue concernant un tel événement sera rejeté.
--recursion-limit	Ce paramètre permet d'activer une limite sur la quantité de récursion effectuée lors du démêlage des chaînes. Étant donné que les formats de modification de noms permettent un niveau de récursion infini, il est possible de créer des chaînes dont le décodage épuisera la quantité d'espace de pile disponible sur la machine hôte, déclenchant une erreur de mémoire. La limite tente d'empêcher que cela ne se produise en limitant la récursivité à 2 048 niveaux d'imbrication. Par défaut, cette limite est activée, mais sa désactivation peut être nécessaire afin de démanteler les noms vraiment compliqués. Notez cependant que si la limite de récursivité est désactivée, l'épuisement de la pile est possible et tout rapport de bogue concernant un tel événement sera rejeté.
-s	Ce paramètre permet d'afficher uniquement la base de chaque nom de fichier.
--section	Ce paramètre permet de lire les déplacements par rapport à la section spécifiée au lieu des adresses absolues.
--target=bfdname	Ce paramètre permet d'indiquer que le format du code objet pour les fichiers objets est bfdname.

Description

Cette commande permet de convertir les adresses en noms de fichiers et numéros de ligne.

Remarques

addr2line traduit les adresses ou le symbole+déplacement en noms de fichiers et numéros de ligne. Étant donné une adresse ou un symbole+déplacement dans un exécutable ou un déplacement dans une section d'un objet relocalisable, il utilise les informations de débogage pour déterminer quel nom de fichier et quel numéro de ligne lui sont associés.
L'objet exécutable ou relocalisable à utiliser est spécifié avec l'option -e. La valeur par défaut est le fichier a.out. La section de l'objet relocalisable à utiliser est spécifiée avec l'option -j.
La commande addr2line a deux modes de fonctionnement. Dans le premier, les adresses hexadécimales ou symbole+déplacements sont spécifiées sur la ligne de commande, et addr2line affiche le nom de fichier et le numéro de ligne pour chaque adresse. Dans la seconde, addr2line lit les adresses hexadécimales ou le symbole+déplacement à partir de l'entrée standard et affiche le nom de fichier et le numéro de ligne pour chaque adresse sur la sortie standard. Dans ce mode, addr2line peut être utilisé dans un tube pour convertir des adresses choisies dynamiquement.
Le format de sortie est «FILENAME:LINENO». Par défaut, chaque adresse d'entrée génère une ligne de sortie.
Deux options peuvent générer des lignes supplémentaires avant chaque ligne «FILENAME:LINENO» (dans cet ordre). Si l'option -a est utilisée, une ligne avec l'adresse d'entrée s'affiche. Si l'option -f est utilisée, une ligne avec «FUNCTIONNAME» s'affiche. C'est le nom de la fonction contenant l'adresse. Une option peut générer des lignes supplémentaires après la ligne «FILENAME:LINENO». Si l'option -i est utilisée et que le code à l'adresse donnée y est présent en raison de l'inline par le compilateur, des lignes supplémentaires sont affichées par la suite. Une ou deux lignes supplémentaires (si l'option -f est utilisée) sont affichées pour chaque fonction en ligne.
Alternativement, si l'option -p est utilisée, chaque adresse d'entrée génère une seule et longue ligne de sortie contenant l'adresse, le nom de la fonction, le nom du fichier et le numéro de ligne. Si l'option -i a également été utilisée, toutes les fonctions en ligne seront affichées de la même manière, mais sur des lignes séparées, et préfixées par le texte «(inlined by)».
Si le nom du fichier ou le nom de la fonction ne peut pas être déterminé, addr2line affichera deux points d'interrogation à leur place. Si le numéro de ligne ne peut pas être déterminé, addr2line affichera 0.
Lorsque symbol+déplacement est utilisé, +offset est facultatif, sauf lorsque le symbole est ambigu avec un nombre hexadécimal. Les symboles résolus peuvent être mutilés ou non, sauf que les symboles non mutilés avec + ne sont pas autorisés.
Les formes longue et courte des options sont équivalentes.
L'option -r est synonyme de l'option --no-recurse-limit. L'option -R est synonyme de l'option --recurse-limit. Notez que cette option n'est efficace que si l'option -C ou --demangle a été activée.

Dernière mise à jour : Dimanche, le 3 Septembre 2023

Section courante

A propos

Section administrative du site

addr2line

Syntaxe

Paramètres

Description

Remarques