.\" Automatically generated by Pod::Man 2.23 (Pod::Simple 3.14) .\" Traduzione da binutils-2.15.94.0.2.2 di Giulio Daprelà .\" gennaio 2006 .\" Aggiornamento a binutils-2.23.91 di Marco Curreli .\" marzo 2014 .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .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" '' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is turned on, 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. .ie \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . nr % 0 . rr F .\} .el \{\ . de IX .. .\} .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .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'\f2\(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" .TH ADDR2LINE 1 "2013-11-18" "binutils-2.23.91" "GNU Development Tools" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NOME" addr2line \- converte gli indirizzi in nomi di file e numeri di riga. .SH "SINTASSI" .IX Header "SINTASSI" addr2line [\fB\-a\fR|\fB\-\-addresses\fR] [\fB\-b\fR \fIbfdname\fR|\fB\-\-target=\fR\fIbfdname\fR] [\fB\-C\fR|\fB\-\-demangle\fR[=\fIstyle\fR]] [\fB\-e\fR \fIfilename\fR|\fB\-\-exe=\fR\fIfilename\fR] [\fB\-f\fR|\fB\-\-functions\fR] [\fB\-s\fR|\fB\-\-basename\fR] [\fB\-i\fR|\fB\-\-inlines\fR] [\fB\-p\fR|\fB\-\-pretty\-print\fR] [\fB\-j\fR|\fB\-\-section=\fR\fIname\fR] [\fB\-H\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] [addr addr ...] .SH "DESCRIZIONE" .IX Header "DESCRIZIONE" \&\fBaddr2line\fR 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\fR. Quello predefinito è il file \fIa.out\fR. La sezione nell'oggetto rilocabile da usare è specificata con l'opzione \fB\-j\fR. .PP \&\fBaddr2line\fR ha due modalità operative. .PP Nella prima sulla riga di comando sono specificati indirizzi esadecimali, e \fBaddr2line\fR mostra il nome del file e il numero di riga per ciascun indirizzo. .PP Nella seconda \fBaddr2line\fR legge indirizzi esadecimali dallo standard input, e stampa nome file e numero di riga per ciascun indirizzo sullo standard output. In questa modalità \fBaddr2line\fR può essere usato in una pipe per convertire indirizzi scelti dinamicamente. .PP Il formato dell'output è \fB\s-1FILENAME:LINENO\s0\fR. Il nome del file e il numero di riga per ciascun indirizzo sono stampati su righe separate. .PP Se è usata l'opzione \fB\-f\fR, ciascuna riga \fB\s-1FILENAME:LINENO\s0\fR è preceduta da una riga \fB\s-1FUNCTIONNAME\s0\fR, che è il nome della funzione contenente l'indirizzo. .PP Se è usata l'opzione \fB\-i\fR e il codice al dato indirizzo è presente lì a causa dell'inlining eseguito dal compilatore, l'informazione data da \&\fB{\s-1FUNCTIONNAME\s0} \s-1FILENAME:LINENO\s0\fR per la funzione inline verrà mostrata dopo. Questo continua ricorsivamente finché non ci sono più inlining da riportare. .PP Se è usata l'opzione \fB\-a\fR all'output viene aggiunto come prefisso l'indirizzo di input. .PP Se è usata l'opzione \fB\-p\fR, l'output per ogni indirizzo di input viene mostrato su una riga, che potrebbe essere anche piuttosto lunga. Se l'opzione \&\fB\-p\fR non viene usata l'output è separato su più righe, secondo le regole viste nei paragrafi precedenti. .PP Se nome file o nome funzione non possono essere determinati, \&\fBaddr2line\fR stamperà due punti interrogativi al loro posto. Se il numero di riga non può essere determinato, \fBaddr2line\fR stamperà 0. .SH "OPZIONI" .IX Header "OPZIONI" La forma lunga e breve delle opzioni, mostrate qui in alternativa, sono equivalenti. .IP "\fB\-a\fR" 4 .IX Item "-a" .PD 0 .IP "\fB\-\-addresses\fR" 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\fR per essere identificato facilmente. .IP "\fB\-b\fR \fIbfdname\fR" 4 .IX Item "-b bfdname" .PD 0 .IP "\fB\-\-target=\fR\fIbfdname\fR" 4 .IX Item "--target=bfdname" .PD Specifica che il formato object-code per i file oggetto è \&\fIbfdname\fR. .IP "\fB\-C\fR" 4 .IX Item "-C" .PD 0 .IP "\fB\-\-demangle[=\fR\fIstyle\fR\fB]\fR" 4 .IX Item "--demangle[=style]" .PD Decodifica (\fIdemangle\fR) 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\fR \fIfilename\fR" 4 .IX Item "-e filename" .PD 0 .IP "\fB\-\-exe=\fR\fIfilename\fR" 4 .IX Item "--exe=filename" .PD Specifica il nome dell'eseguibile per il quale gli indirizzi devono essere tradotti. Il file predefinito è \fIa.out\fR. .IP "\fB\-f\fR" 4 .IX Item "-f" .PD 0 .IP "\fB\-\-functions\fR" 4 .IX Item "--functions" .PD Visualizza informazioni su nomi di funzioni e anche su file e numeri di riga. .IP "\fB\-s\fR" 4 .IX Item "-s" .PD 0 .IP "\fB\-\-basenames\fR" 4 .IX Item "--basenames" .PD Visuallizza solo la base di ciascun nome di file. .IP "\fB\-i\fR" 4 .IX Item "-i" .PD 0 .IP "\fB\-\-inlines\fR" 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'\fR espande \&\f(CW\*(C`callee1\*(C'\fR che espande \f(CW\*(C`callee2\*(C'\fR, e l'indirizzo proviene da \&\f(CW\*(C`callee2\*(C'\fR, verranno stampate anche le informazioni per \f(CW\*(C`callee1\*(C'\fR e \f(CW\*(C`main\*(C'\fR. .IP "\fB\-j\fR" 4 .IX Item "-j" .PD 0 .IP "\fB\-\-section\fR" 4 .IX Item "--section" .PD Legge gli offset relativi alla sezione specificata anziché gli indirizzi assoluti. .IP "\fB\-p\fR" 4 .IX Item "-p" .PD 0 .IP "\fB\-\-pretty\-print\fR" 4 .IX Item "--pretty-print" .PD Rende l'output più leggibile: ogni posizione è stampata su una riga. Se è specificata l'opzione \fB\-i\fR, le righe for all enclosing scopes sono precedute dal prefisso \fB(inlined by)\fR. .IP "\fB@\fR\fIfile\fR" 4 .IX Item "@file" Legge le opzioni da riga di comando da \fIfile\fR. Le opzioni lette sono inserite al posto dell'opzione originale @\fIfile\fR. Se \fIfile\fR non esiste o non può essere letto, l'opzione verrà letteralmente, e non rimossa. .Sp Le opzioni nel \fIfile\fR 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\fR può esso stesso contenere ulteriori opzioni @\fIfile\fR; ciascuna di queste opzioni sarà elaborata ricorsivamente. .SH "VEDERE ANCHE" .IX Header "VEDERE ANCHE" Le voci delle pagine info relative a \fIbinutils\fR. .SH "COPYRIGHT" .IX Header "COPYRIGHT" Copyright (c) 1991\-2013 Free Software Foundation, Inc. .PP Permission is granted to copy, distribute and/or modify this document under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3 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 \*(L"\s-1GNU\s0 Free Documentation License\*(R". .SH "DIRITTI DI COPIA" .IX Header "DIRITTI DI COPIA" Copyright (c) 1991\-2013 Free Software Foundation, Inc. .PP Traduzione in italiano a cura di ILDP - Italian Linux Documentation Project \%http://www.pluto.it/ildp. Segnalare eventuali errori di traduzione a .IR ildp@pluto.it .PP Questa è una traduzione non ufficiale in italiano dei permessi di copia riportati nella precedente sezione "\fBCOPYRIGHT\fR". Non è una pubblicazione della Free Software Foundation, e non ha validità legale per i termini di distribuzione della documentazione; solo il testo originale inglese ha tale validità. .PP This is an unofficial translation into Italian of the above section "\fBCOPYRIGHT\fP". It was not published by the Free Software Foundation, and does not legally state the distribution terms for this documentation; only the original English text does that. .PP È permesso copiare, distribuire e/o modificare questo documento seguendo i termini della \s-1GNU\s0 Free Documentation License (Licenza per documentazione libera GNU), 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 \*(L"\s-1GNU\s0 Free Documentation License\*(R" (Licenza per la documentazione libera GNU).