Provided by: manpages-it_2.80-3_all bug

NOME

       nm - elenca i simboli dai file oggetto

SINTASSI

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

DESCRIZIONE

       GNU nm elenca i simboli dai file oggetto objfile....  Se come argomento non viene indicato
       alcun file oggetto, nm prende il file a.out.

       Per ciascun simbolo, nm mostra:

       ·   Il valore del  simbolo,  nella  base  selezionata  dalle  opzioni  (vedere  sotto),  o
           esadecimale per default.

       ·   Il  tipo  di  simbolo.  Sono  usati  almeno  i  seguenti tipi; altri sono, ovviamente,
           dipendenti dal formato del file  oggetto.  Se  minuscolo,  il  simbolo  è  locale;  se
           maiuscolo il simbolo è globale (esterno).

           "A" Il valore del simbolo è assoluto, e non verrà cambiato da ulteriori collegamenti.

           "B" Il simbolo è nella sezione dati non inizializzata (nota come BSS).

           "C" Il  simbolo  è  comune.  I  simboli comuni sono dati non inizializzati.  Quando si
               collegano, simboli multipli comuni possono apparire con  lo  stesso  nome.  Se  il
               simbolo  è  definito  da  qualche  parte,  i simboli comuni sono trattati come non
               riferimenti non definiti.

           "D" Il simbolo è nella sezione dati inizializzata.

           "G" Il simbolo è in una  sezione  dati  inizializzata  per  piccoli  oggetti.   Alcuni
               formati  di  file  oggetto  permettono un accesso più efficiente a piccoli oggetti
               dati, come una variabile globale intera rispetto a un grande array globale.

           "I" Il simbolo è un riferimento indiretto a un altro simbolo. Questa  è  un'estensione
               GNU al formato di file oggetto a.out usata raramente.

           "N" Il simbolo è un simbolo di debugging.

           "R" Il simbolo è in una sezione dati a sola lettura.

           "S" Il simbolo è in una sezione dati per piccoli oggetti non inizializzata.

           "T" Il simbolo è nella sezione testo (codice).

           "U" Il simbolo non è definito.

           "V" Il  simbolo è un oggetto debole. Quando un simbolo definito debole è collegato con
               un simbolo definito normalmente, il simbolo definito normale è usato senza errori.
               Quando  un  simbolo  indefinito debole è collegato e il simbolo non è definito, il
               valore del simbolo debole diviene zero senza alcun errore.

           "W" Il simbolo è un simbolo debole che non è stato classificato specificatamente  come
               oggetto  simbolo  debole.  Quando  un  simbolo  definito debole è collegato con un
               simbolo definito normale, il simbolo definito normale è usato senza alcun  errore.
               Quando  un  simbolo  indefinito debole è collegato e il simbolo non è definito, il
               valore del simbolo è determinato in una  modalità  dipendente  dal  sistema  senza
               errori. In alcuni sistemi la maiuscola indica che è stato specificato un valore di
               default.

           "-" Il simbolo è un simbolo stab in un file oggetto a.out. In questo caso i successivi
               valori  stampati  sono  il campo stab altro, il campo stab desc, e il tipo stab. I
               simboli stab sono usati per mantenere le informazioni di debug.

           "?" Il tipo del simbolo è sconosciuto, o specifico del formato del file oggetto.

       ·   Il nome del simbolo.

OPZIONI

       Le opzioni nei formati lungo e corto, qui mostrate come alternative, sono equivalenti.

       -A
       -o
       --print-file-name
           Fa precedere a ciascun simbolo il nome del file input (o membro  dell'  archivio)  nel
           quale  è  stato trovato, invece che identificare il file di input solo una volta prima
           di tutti i suoi simboli.

       -a
       --debug-syms
           Mostra tutti i simboli, anche i simboli esclusivi del debugger; normalmente questi non
           sono elencati.

       -B  Lo stesso che --format=bsd (per compatibilità con MIPS nm).

       -C
       --demangle[=style]
           Decodifica  (demangle)  i  nomi dei simboli di basso livello in nomi a livello utente.
           Oltre a rimuovere ogni underscore iniziale aggiunto dal sistema questo rende leggibili
           i  nomi  di  funzioni C++ . Differenti compilatori hanno differenti stili di codifica.
           L'argomento opzionale dello stile di decodifica può essere  usato  per  scegliere  uno
           stile appropriato di decodifica per il proprio compilatore.

       --no-demangle
           Non decodifica i nomi di simboli di basso livello. Questo è il default.

       -D
       --dynamic
           Mostra i simboli dinamici invece dei simboli normali. Ciò è significativo solo per gli
           oggetti dinamici, come certi tipi di librerie condivise.

       -f format
       --format=format
           Usa il formato di output format, che  può  essere  "bsd",  "sysv",  or  "posix".   The
           default  is "bsd".  Solo il primo carattere di format è significativo; esso può essere
           indifferentemente maiuscolo o minuscolo.

       -g
       --extern-only
           Mostra solo i simboli esterni.

       -l
       --line-numbers
           Per ciascun simbolo usa le informazioni di debug per tentare di trovare un nome file e
           un  numero  di  linea. Per un simbolo definito cerca il numero di linea dell'indirizzo
           del simbolo. Per un simbolo indefinito cerca  il  numero  di  linea  di  un  campo  di
           rilocazione  che  fa riferimento al simbolo. Se l'informazione del numero di linea può
           essere trovata la stampa dopo l'altra informazione sul simbolo.

       -n
       -v
       --numeric-sort
           Ordina i simboli numericamente secondo il loro indirizzo, invece  che  alfabeticamente
           per nome.

       -p
       --no-sort
           Non  si preoccupa di ordinare i simboli secondo nessun criterio; li stampa nell'ordine
           in cui li trova.

       -P
       --portability
           Usa il formato di output standard POSIX.2 invece del formato di default. Equivalente a
           -f posix.

       -S
       --print-size
           Stampa  la  dimensione,  non  il valore, dei simboli definiti per il formato di output
           "bsd" .

       -s
       --print-armap
           Quando elenca i simboli  da  membri  dell'archivio  include  l'indice:  una  mappatura
           (memorizzata  nell'archivio da ar o ranlib) di quali moduli contengono definizioni per
           quali nomi.

       -r
       --reverse-sort
           Inverte il senso dell'ordinamento (sia esso numerico  o  alfabetico);  mette  l'ultimo
           come primo.

       --size-sort
           Ordina  i  simboli  per dimensione. La dimensione è conteggiata come differenza tra il
           valore del simbolo e il valore del simbolo con il successivo  valore  maggiore.  Se  è
           usato  il  formato di output "bsd" viene stampata la dimensione del simbolo invece del
           valore, e per stampare sia dimensione che valore bisogna usare -S .

       --special-syms
           Mostra simboli che hanno un significato speciale target-specific. Questi simboli  sono
           normalmente  usati dal target per alcuni processamenti speciali e normalmente non sono
           di aiuto quando inclusi negli elenchi simboli normali. Per esempio per  i  target  ARM
           questa  opzione  salterà  i  simboli di mappatura usati per segnare le transizioni tra
           codice ARM , codice THUMB e dati.

       -t radix
       --radix=radix
           Usa radix come base per stampare i valori dei simboli. Deve essere d per il  decimale,
           o per l'ottale o x per l' esadecimale.

       --target=bfdname
           specifica  un  formato  del  codice oggetto diverso dal formato di default del proprio
           sistema.

       -u
       --undefined-only
           Mostra solo i simboli non definiti (quelli esterni ai file oggetto).

       --defined-only
           Mostra solo i simboli definiti per ciascun file oggetto.

       -V
       --version
           Mostra il numero di versione di nm ed esce.

       -X  Questa opzione è ignorata per compatibilità con la versione AIX di nm. Essa prende  un
           parametro  che deve essere la stringa 32_64. I modi di default di AIX nm corrispondono
           a -X 32, che non è supportato da GNU nm.

       --help
           Mostra un sommario delle opzioni di nm ed esce.

VEDERE ANCHE

       ar(1), objdump(1), ranlib(1), e i campi Info di binutils.

COPYRIGHT

       Copyright (c) 1991, 1992, 1993, 1994, 1995, 1996, 1997,  1998,  1999,  2000,  2001,  2002,
       2003, 2004 Free Software Foundation, Inc.

       Permission  is  granted to copy, distribute and/or modify this document under the terms of
       the GNU Free Documentation License, Version 1.1 or any later version published by the Free
       Software  Foundation;  with  no Invariant Sections, with no Front-Cover Texts, and with no
       Back-Cover Texts.  A copy of the license is included in the section  entitled  ``GNU  Free
       Documentation License''.