.\" -*- coding: UTF-8 -*- .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40) .\" .\" Standard preamble: .\" ======================================================================== .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .de IX .. .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" fudge factors for nroff and troff . .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} .\" simple accents for nroff and troff . .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} .\" troff and (daisy-wheel) nroff accents . .ds : \k:\h'-(\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \k:\h'-(\n(.wu+\w'\(de'u\-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\fI\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E .\" corrections for vroff . .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' .\" for low resolution devices (crt and lpr) . .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "ADDR2LINE 1" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH ADDR2LINE 1 "20 febbraio 2021" binutils\-2.35.2 "Strumenti di sviluppo GNU" .if n .ad l .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .nh .SH NOME addr2line \- converte gli indirizzi in nomi di file e numeri di riga. .SH SINTASSI .IX Header SINTASSI addr2line [\fB\-a\fP|\fB\-\-addresses\fP] [\fB\-b\fP \fIbfdname\fP|\fB\-\-target=\fP\fIbfdname\fP] [\fB\-C\fP|\fB\-\-demangle\fP[=\fIstyle\fP]] [\fB\-r\fP|\fB\-\-no\-recurse\-limit\fP] [\fB\-R\fP|\fB\-\-recurse\-limit\fP] [\fB\-e\fP \fIfilename\fP|\fB\-\-exe=\fP\fIfilename\fP] [\fB\-f\fP|\fB\-\-functions\fP] [\fB\-s\fP|\fB\-\-basename\fP] [\fB\-i\fP|\fB\-\-inlines\fP] [\fB\-p\fP|\fB\-\-pretty\-print\fP] [\fB\-j\fP|\fB\-\-section=\fP\fIname\fP] [\fB\-H\fP|\fB\-\-help\fP] [\fB\-V\fP|\fB\-\-version\fP] [addr addr ...] .SH DESCRIZIONE .IX Header DESCRIZIONE \&\fBaddr2line\fP traduce indirizzi in nomi di file e numeri di riga. Dato un indirizzo in un eseguibile o un offset in una sezione di un oggetto rilocabile, esso usa l'informazione di debugging per capire quale nome di file e numero di riga sono associati e un dato indirizzo. .PP L'eseguibile o l'oggetto rilocabile da usare è specificato con l'opzione \fB\-e\fP. Quello predefinito è il file \fIa.out\fP. La sezione nell'oggetto rilocabile da usare è specificata con l'opzione \fB\-j\fP. .PP \&\fBaddr2line\fP ha due modalità operative. .PP Nella prima sulla riga di comando sono specificati indirizzi esadecimali, e \fBaddr2line\fP mostra il nome del file e il numero di riga per ciascun indirizzo. .PP Nella seconda \fBaddr2line\fP legge indirizzi esadecimali dallo standard input, e stampa nome file e numero di riga per ciascun indirizzo sullo standard output. In questa modalità \fBaddr2line\fP può essere usato in una pipe per convertire indirizzi scelti dinamicamente. .PP Il formato dell'output è \fB\s-1FILENAME:LINENO\s0\fP. Come comportamentopredefinito, ogni indirizzo in input genera una riga di output. .PP Due opzioni possono generare ulteriori righe prima di ogni riga \&\fB\s-1FILENAME:LINENO\s0\fP (in quest'ordine). .PP Se è usata l'opzione \fB\-a\fP viene mostrata una riga con l'indirizzo in input. .PP Se è usata l'opzione \fB\-f\fP, viene mostrata una riga con il \&\fB\s-1FUNCTIONNAME\s0\fP, che è il nome della funzione contenente l'indirizzo. .PP Un'opzione può generare ulteriori righe dopo la riga \&\fB\s-1FILENAME:LINENO\s0\fP. .PP Se è usata l'opzione \fB\-i\fP e il codice al dato indirizzo è presente lì a causa dell'inlining eseguito dal compilatore, ulteriori righe verranno mostrate dopo. Una o due righe supplementari (se è usata l'opzione \&\fB\-f\fP) sono mostrate per ogni funzione sottoposta a inlining. .PP In alternativa, se è usata l'opzione \fB\-p\fP, ogni indirizzo di input genera su un'unica lunga riga di output contenente l'indirizzo, il nome della funzione, il nome del file e il numero di riga. Se è stata usata anche l'opzione \&\fB\-i\fP ogni funzione sottoposta a inlining verrà mostrata nello stesso modo, ma su righe separate, con aggiunto il prefisso \fB(inlined by)\fP. .PP Se nome file o nome funzione non possono essere determinati, \&\fBaddr2line\fP stamperà due punti interrogativi al loro posto. Se il numero di riga non può essere determinato, \fBaddr2line\fP stamperà 0. .SH OPZIONI .IX Header OPZIONI Le opzioni nei formati lungo e corto, qui mostrate come alternative, sono equivalenti. .IP \fB\-a\fP 4 .IX Item \-a .PD 0 .IP \fB\-\-addresses\fP 4 .IX Item \-\-addresses .PD Mostra l'indirizzo prima delle informazioni su nome di funzione, file e numero di riga. L'indirizzo è stampato con un prefisso \fB0x\fP per essere identificato facilmente. .IP "\fB\-b\fP \fIbfdname\fP" 4 .IX Item "\-b bfdname" .PD 0 .IP \fB\-\-target=\fP\fIbfdname\fP 4 .IX Item \-\-target=bfdname .PD Specifica che il formato object\-code per i file oggetto è \&\fIbfdname\fP. .IP \fB\-C\fP 4 .IX Item \-C .PD 0 .IP \fB\-\-demangle[=\fP\fIstyle\fP\fB]\fP 4 .IX Item \-\-demangle[=style] .PD Decodifica (\fIdemangle\fP) nomi di simboli a basso livello in nomi a livello utente. Oltre a rimuovere ogni trattino basso iniziale aggiunto dal sistema, questo rende i nomi di funzione \*(C+ leggibili. Differenti compilatori hanno differenti stili di mangling. L'argomento opzionale di stile di demangling può essere usato per scegliere uno stile di demangling appropriato per il proprio compilatore. .IP "\fB\-e\fP \fIfilename\fP" 4 .IX Item "\-e filename" .PD 0 .IP \fB\-\-exe=\fP\fIfilename\fP 4 .IX Item \-\-exe=filename .PD Specifica il nome dell'eseguibile per il quale gli indirizzi devono essere tradotti. Il file predefinito è \fIa.out\fP. .IP \fB\-f\fP 4 .IX Item \-f .PD 0 .IP \fB\-\-functions\fP 4 .IX Item \-\-functions .PD Visualizza informazioni su nomi di funzioni e anche su file e numeri di riga. .IP \fB\-s\fP 4 .IX Item \-s .PD 0 .IP \fB\-\-basenames\fP 4 .IX Item \-\-basenames .PD Visuallizza solo la base di ciascun nome di file. .IP \fB\-i\fP 4 .IX Item \-i .PD 0 .IP \fB\-\-inlines\fP 4 .IX Item \-\-inlines .PD Se l'indirizzo appartiene a una funzione sottoposta a inlining, verrano stampate anche le informazioni sul codice sorgente per tutte le espansioni inluse fino alla prima funzione non sottoposta a espanzione inline. Per esempio, se \f(CW\*(C`main\*(C'\fP espande \&\f(CW\*(C`callee1\*(C'\fP che espande \f(CW\*(C`callee2\*(C'\fP, e l'indirizzo proviene da \&\f(CW\*(C`callee2\*(C'\fP, verranno stampate anche le informazioni per \f(CW\*(C`callee1\*(C'\fP e \f(CW\*(C`main\*(C'\fP. .IP \fB\-j\fP 4 .IX Item \-j .PD 0 .IP \fB\-\-section\fP 4 .IX Item \-\-section .PD Legge gli offset relativi alla sezione specificata anziché gli indirizzi assoluti. .IP \fB\-p\fP 4 .IX Item \-p .PD 0 .IP \fB\-\-pretty\-print\fP 4 .IX Item \-\-pretty\-print .PD Rende l'output più leggibile: ogni posizione è stampata su una riga. Se è specificata l'opzione \fB\-i\fP, le righe for all enclosing scopes sono precedute dal prefisso \fB(inlined by)\fP. .IP \fB\-r\fP 4 .IX Item \-r .PD 0 .IP \fB\-R\fP 4 .IX Item \-R .IP \fB\-\-recurse\-limit\fP 4 .IX Item \-\-recurse\-limit .IP \fB\-\-no\-recurse\-limit\fP 4 .IX Item \-\-no\-recurse\-limit .IP \fB\-\-recursion\-limit\fP 4 .IX Item \-\-recursion\-limit .IP \fB\-\-no\-recursion\-limit\fP 4 .IX Item \-\-no\-recursion\-limit .PD Enables or disables a limit on the amount of recursion performed whilst demangling strings. Since the name mangling formats allow for an inifinite level of recursion it is possible to create strings whose decoding will exhaust the amount of stack space available on the host machine, triggering a memory fault. The limit tries to prevent this from happening by restricting recursion to 2048 levels of nesting. .Sp The default is for this limit to be enabled, but disabling it may be necessary in order to demangle truly complicated names. Note however that if the recursion limit is disabled then stack exhaustion is possible and any bug reports about such an event will be rejected. .Sp L'opzione \fB\-r\fP è un sinonimo dell'opzione \&\fB\-\-no\-recurse\-limit\fP. L'opzione \fB\-R\fP è un sinonimo dell'opzione \fB\-\-recurse\-limit\fP. .Sp Si noti che questa opzione ha effetto solo se è stata abilitata l'opzione \&\fB\-\-demangle\fP. .IP \fB@\fP\fIfile\fP 4 .IX Item @file Legge le opzioni da riga di comando da \fIfile\fP. Le opzioni lette sono inserite al posto dell'opzione originale @\fIfile\fP. Se \fIfile\fP non esiste o non può essere letto, l'opzione sarà trattata letteralmente, e non rimossa. .Sp Le opzioni in \fIfile\fP sono separate da spazi vuoti. Si può includere uno spazio vuoto in un'opzione racchiudendo l'intera opzione fra apici, singoli o doppi. Può essere incluso qualsiasi carattere (compresa la barra inversa) facendo precedere al carattere una barra inversa. Il \fIfile\fP può esso stesso contenere ulteriori opzioni @\fIfile\fP; ciascuna di queste opzioni sarà elaborata ricorsivamente. .SH "VEDERE ANCHE" .IX Header "VEDERE ANCHE" I campi Info per \fIbinutils\fP. .SH COPYRIGHT .IX Header COPYRIGHT Copyright (c) 1991\-2020 Free Software Foundation, Inc. .PP È permesso copiare, distribuire e/o modificare questo documento nei termini della \*(lqLicenza per documentazione libera GNU\*(rq (\s-1GNU\s0 Free Documentation License), versione 1.3 o ogni versione successiva pubblicata dalla Free Software Foundation; senza sezioni non modificabili, senza testi di prima di copertina e di quarta di copertina. Una copia della licenza è inclusa nella sezione intitolata \*(lqLicenza per la documentazione libera GNU" (\*(L"\s-1GNU\s0 Free Documentation License\*(R"). .PP .SH TRADUZIONE La traduzione italiana di questa pagina di manuale è stata creata da Giulio Daprelà e Marco Curreli . .PP Questa traduzione è documentazione libera; leggere la .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License Versione 3 .UE o successiva per le condizioni di copyright. Non ci assumiamo alcuna responsabilità. .PP Per segnalare errori nella traduzione di questa pagina di manuale inviare un messaggio a .MT pluto-ildp@lists.pluto.it .ME .