NOM¶

nm - Lister les symboles des fichiers objets

SYNOPSIS¶

nm [-a⎪--debug-syms] [-g⎪--extern-only]
[-B] [-C⎪--demangle[=style]] [-D⎪--dynamic]
[-S⎪--print-size] [-s⎪--print-armap]
[-A⎪-o⎪--print-file-name]
[-n⎪-v⎪--numeric-sort] [-p⎪--no-sort]
[-r⎪--reverse-sort] [--size-sort] [-u⎪--undefined-only]
[-t racine⎪--radix=racine] [-P⎪--portability]
[--target=nom-bfd] [-fformat⎪--format=format]
[--defined-only] [-l⎪--line-numbers] [--no-demangle]
[-V⎪--version] [-X 32_64] [--help] [fichier-objet...]

DESCRIPTION¶

GNU nm liste les symboles provenant des fichiers objets fichier-objet... Si aucun fichier objet n'est fourni comme argument, nm suppose qu'on lui a spécifié le fichier a.out.

Pour chaque symbole, nm affiche :

• La valeur du symbole, dans la racine sélectionnée par les options (voir plus bas), ou en hexadécimal par défaut.
• Le type du symbole. Au moins les types suivants sont utilisés ; d'autres peuvent également l'être, en fonction du format du fichier objet. S'il est en minuscules, le symbole est local ; s'il est en majuscules, le symbole est global (externe).

•

Le nom du symbole.

OPTIONS¶

Les formes longues et courtes des options, montrées ici comme alternatives, sont équivalentes.

-A

-o

--print-file-name

Faire précéder chaque symbole par le nom du fichier d'entrée (ou du membre de l'archive) dans lequel il a été trouvé, plutôt que de n'identifier le fichier d'entrée qu'une seule fois, avant tous ses symboles.

-a

--debug-syms

Afficher tous les symboles, même ceux spécifiques au débogueur ; normalement, ceux-ci ne sont pas listés.

-B

Identique à --format=bsd (pour la compatibilité avec le nm MIPS).

-C

--demangle[=style]

Décoder (demangle) les noms de symboles de bas niveau en noms de niveau utilisateur. En plus de supprimer tout « _ » initial ajouté par le système, ceci rend lisibles les noms de fonctions C++. Des compilateurs différents ont des styles de codage différents. L'argument optionnel de style de décodage peut être utilisé pour choisir un style de décodage approprié à votre compilateur.

--no-demangle

Ne pas décoder les noms de symboles de bas niveau. C'est le défaut.

-D

--dynamic

Afficher les symboles dynamiques plutôt que les symboles normaux. Ceci n'a de sens que pour les objets dynamiques, comme certains types de bibliothèques partagées.

-f format

--format=format

Utiliser le format de sortie format, qui peut être « bsd », « sysv », ou « posix ». Le défaut est « bsd ». Seul le premier caractère de format est significatif : il peut être en minuscule ou en majuscule.

-g

--extern-only

N'afficher que les symboles externes.

-l

--line-numbers

Pour chaque symbole, utiliser des informations de débogage pour essayer de trouver un nom de fichier et un numéro de ligne. Pour un symbole défini, rechercher le numéro de ligne de l'adresse du symbole. Pour un symbole non défini, rechercher le numéro de ligne d'une entrée de relogement qui se réfère au symbole. Si l'information de numéro de ligne peut être trouvée, l'afficher après les autres informations sur le symbole.

-n

-v

--numeric-sort

Trier les symboles numériquement par leur adresse, et non pas alphabétiquement par leur nom.

-p

--no-sort

Ne pas trier les symboles, uniquement les afficher dans leur ordre de rencontre.

-P

--portability

Utiliser le format de sortie standard POSIX.2 au lieu du format par défaut. Équivalent à -f posix.

-S

--print-size---

Afficher la taille des symboles définis pour le format de sortie « bsd ».

-s

--print-armap

Lors du listage des symboles des membres de l'archive, inclure l'index (stocké dans l'archive par ar ou ranlib), c.-à-d. une correspondance entre les modules et le nom des symboles qui y sont définis.

-r

--reverse-sort

Renverser l'ordre de tri (numérique ou alphabétique) ; commencer par le dernier.

--size-sort

Trier les symboles par taille. La taille est calculée par la différence entre la valeur du symbole et la valeur du symbole de valeur immédiatement supérieure. La taille du symbole est affichée, plutôt que sa valeur.

-t racine

--radix=racine

Utiliser racine comme racine servant à l'affichage des valeurs des symboles. Elle doit être d pour décimal, o pour octal, ou x pour hexadécimal.

--target=nom-bfd

Spécifier un format de code objet différent de celui utilisé par défaut sur votre système.

-u

--undefined-only

N'afficher que les symboles non définis (ceux externes à chaque fichier objet).

--defined-only

N'afficher que les symboles définis pour chaque fichier objet.

-V

--version

Afficher le numéro de version de nm et se terminer.

-X

Cette option ignorée est utilisée pour la compatibilité avec la version AIX de nm. Elle prend un paramètre qui doit être la chaîne 32_64. Le mode par défaut du nm AIX correspond à -X 32, qui n'est pas supporté par le nm GNU.

--help

Afficher un résumé des options de nm et se terminer.

VOIR AUSSI¶

ar(1), objdump(1), ranlib(1), et les entrées Info pour binutils.

COPYRIGHT¶

Copyright (c) 1991, 92, 93, 94, 95, 96, 97, 98, 99, 2000, 2001, 2002 Free Software Foundation, Inc.

L'autorisation est donnée de copier, de distribuer et/ou de modifier ce document sous les termes de la GNU Free Documentation License version 1.1 ou toute autre version ultérieure publiée par la Free Software Foundation, sans section invariante ni texte de couverture ni texte de quatrième de couverture. Une copie de la licence est incluse dans la section intitulée « GNU Free Documentation License ».

TRADUCTION¶

Frédéric Delanoy <delanoy_f at yahoo.com>, 2002.