alpha-linux-gnu-gprof - Online nel cloud

PROGRAMMA:

NOME

gprof - visualizza i dati del profilo del grafico delle chiamate

SINOSSI

gprof [ -[abcDhilLrsTvwxyz] ] [ -[ACEEfFJnNOpPqQZ][Nome]]
[ -IO dirs ] [ -D[num] ] [ -K da A ]
[ -M conteggio minimo ] [ -R file_mappa ] [ -T lunghezza del tavolo ]
[ --[no-]fonte-annotata[=Nome]]
[ --[no-]conteggi-esecutivi[=Nome]]
[ --[no-]profilo-piatto[=Nome] ] [ --[no-]grafico[=Nome]]
[ --[no-]tempo=Nome] [ --tutte le righe ] [ --breve ]
[ --debug[=livello] ] [ --ordine-funzione ]
[ --file-order file_mappa ] [ --directory-percorso=dirs ]
[ --display-funzioni-inutilizzate] [ --file-format=Nome ]
[ --file-info ] [ --help ] [ --line ] [ --inline-file-names ]
[ --conteggio-min=n ] [ --no-static ] [ --print-percorso ]
[ --file-separati ] [ --static-call-graph ] [ --sum ]
[ --lunghezza-tabella=len ] [ --tradizionale ] [ --versione ]
[ --larghezza=n ] [ --ignora-non-funzioni ]
[ --demanle[=STILE] ] [ --no-demanle ]
[--tabella-simbolo-esterno=nome]
[ file immagine ] [ file-profilo ...]

DESCRIZIONE

"gprof" produce un profilo di esecuzione di programmi C, Pascal o Fortran77. L'effetto di
le routine chiamate sono incorporate nel profilo di ogni chiamante. I dati del profilo sono presi
dal file di profilo del grafico delle chiamate (gmon.out default) che viene creato da programmi che sono
compilato con il -pag opzione di "cc", "pc" e "f77". Il -pag l'opzione si collega anche in
versioni delle routine di libreria compilate per la profilazione. "Gprof" legge il dato
file oggetto (il valore predefinito è "a.out") e stabilisce la relazione tra la sua tabella dei simboli
e il profilo del grafico delle chiamate da gmon.out. Se viene specificato più di un file di profilo, il
L'output "gprof" mostra la somma delle informazioni sul profilo nei file di profilo dati.

Se usi gcc 2.95.x o 3.0 per compilare i tuoi binari, potresti dover aggiungere il
-fprofile-archi alla riga di comando di compilazione in modo che i grafici delle chiamate siano correttamente
memorizzato in gmon.out.

"Gprof" calcola la quantità di tempo trascorso in ogni routine. Successivamente, questi tempi sono
propagato lungo i bordi del grafo di chiamata. I cicli vengono scoperti e chiamate in a
ciclo sono fatti per condividere il tempo del ciclo.

Diverse forme di output sono disponibili dall'analisi.

Il piatto tuo profilo mostra quanto tempo il tuo programma ha trascorso in ciascuna funzione e quanto
volte che la funzione è stata chiamata. Se vuoi semplicemente sapere quali funzioni bruciano di più
i cicli, si afferma concisamente qui.

Il chiamata grafico mostra, per ogni funzione, quali funzioni l'hanno chiamata, quali altre funzioni
ha chiamato, e quante volte. C'è anche una stima di quanto tempo è stato speso in
i sottoprogrammi di ciascuna funzione. Questo può suggerire posti dove potresti provare a
eliminare le chiamate di funzione che richiedono molto tempo.

Il annotato source listato è una copia del codice sorgente del programma, etichettato con
numero di volte in cui ogni riga del programma è stata eseguita.

VERSIONI

Queste opzioni specificano quale dei diversi formati di output "gprof" dovrebbe produrre.

Molte di queste opzioni richiedono un optional simspec per specificare le funzioni da includere o
escluso. Queste opzioni possono essere specificate più volte, con diverse symspec, a
includere o escludere insiemi di simboli.

La specificazione di una di queste opzioni sovrascrive l'impostazione predefinita (-p -q), che stampa un profilo piatto
e chiamare l'analisi del grafico per tutte le funzioni.

"-UN[symspec]"
"--fonte-annotata[=symspec]"
Il -A opzione fa sì che "gprof" stampi il codice sorgente annotato. Se simspec è specificato,
stampa l'output solo per i simboli corrispondenti.

"-B"
"--breve"
Se l' -b l'opzione è data, "gprof" non stampa le scritte prolisse che tentano di farlo
spiegare il significato di tutti i campi nelle tabelle. Questo è utile se hai intenzione
per stampare l'output, o sono stanchi di vedere i blurbs.

"-C[symspec]"
"--exec-counts[=symspec]"
Il -C opzione fa sì che "gprof" stampi un conteggio delle funzioni e il numero di volte
ciascuno è stato chiamato. Se simspec è specificato, stampa il conteggio solo per i simboli corrispondenti.

Se il file di dati del profilo contiene record di conteggio dei blocchi di base, specificando -l opzione,
con -C, farà sì che i conteggi delle esecuzioni dei blocchi di base vengano conteggiati e visualizzati.

"-IO"
"--informazioni-file"
Il -i opzione fa sì che "gprof" mostri informazioni di riepilogo sui dati del profilo
file e quindi esci. Il numero dell'istogramma, del grafico delle chiamate e del conteggio dei blocchi di base
vengono visualizzati i record.

"-IO dire"
"--percorso-directory=dire"
Il -I opzione specifica un elenco di directory di ricerca in cui trovare i file di origine.
Variabile d'ambiente PERCORSO_GPROF può essere utilizzato anche per trasmettere queste informazioni. Usato
principalmente per l'output della fonte annotata.

"-J[symspec]"
"--nessuna-fonte-annotata[=symspec]"
Il -J L'opzione fa sì che "gprof" non stampi il codice sorgente annotato. Se simspec is
specificato, "gprof" stampa la fonte annotata, ma esclude i simboli corrispondenti.

"-L"
"--percorso di stampa"
Normalmente, i nomi dei file di origine vengono stampati con il componente del percorso soppresso. Il -L
opzione fa in modo che "gprof" stampi il percorso completo dei nomi dei file di origine, che è
determinato dalle informazioni di debug simbolico nel file immagine ed è relativo a
la directory in cui è stato richiamato il compilatore.

"-P[symspec]"
"--profilo-piatto[=symspec]"
Il -p opzione fa in modo che "gprof" stampi un profilo piatto. Se simspec è specificato, stampa
profilo piatto solo per i simboli corrispondenti.

"-P[symspec]"
"--no-profilo-piatto[=symspec]"
Il -P L'opzione fa sì che "gprof" sopprima la stampa di un profilo piatto. Se simspec is
specificato, "gprof" stampa un profilo piatto, ma esclude i simboli corrispondenti.

"-Q[symspec]"
"--grafico[=symspec]"
Il -q opzione fa in modo che "gprof" stampi l'analisi del grafico delle chiamate. Se simspec is
specificato, stampa il grafico delle chiamate solo per i simboli corrispondenti e i loro figli.

"-Q[symspec]"
"--no-graph[=symspec]"
Il -Q L'opzione fa sì che "gprof" sopprima la stampa del grafico della chiamata. Se simspec is
specificato, "gprof" stampa un grafico di chiamata, ma esclude i simboli corrispondenti.

"-t"
"--lunghezza-tabella=numero"
Il -t l'opzione causa il num le righe di origine più attive in ogni file di origine da elencare
quando l'annotazione di origine è abilitata. Il valore predefinito è 10.

"-y"
"--file-separati"
Questa opzione ha effetto solo sull'output della sorgente annotata. Normalmente, "gprof" stampa annotato
file di origine allo standard output. Se questa opzione è specificata, fonte annotata per a
file chiamato percorso/nome file viene generato nel file nomefile-ann. Se il sottostante
il file system verrebbe troncato nomefile-ann in modo che sovrascrive l'originale Nome del file,
"gprof" genera una fonte annotata nel file nomefile.ann invece (se l'originale
il nome del file ha un'estensione, quell'estensione è sostituito con .ANN).

"-Z[symspec]"
"--no-exec-counts[=symspec]"
Il -Z opzione fa sì che "gprof" non stampi un conteggio delle funzioni e il numero di volte
ciascuno è stato chiamato. Se simspec è specificato, stampa tally, ma esclude i simboli corrispondenti.

"-R"
"--ordine-funzione"
Il --ordinamento-funzione opzione fa in modo che "gprof" stampi un ordinamento delle funzioni suggerito
per il programma basato su dati di profilazione. Questa opzione suggerisce un ordinamento che può
migliorare il comportamento di paging, tlb e cache per il programma su sistemi che supportano
ordinamento arbitrario delle funzioni in un eseguibile.

I dettagli esatti su come forzare il linker a posizionare le funzioni in un ordine particolare
dipende dal sistema e non rientra nell'ambito di questo manuale.

"-R file_mappa"
"--ordine-file file_mappa"
Il --ordine-file l'opzione fa in modo che "gprof" stampi un ordinamento suggerito della linea di collegamento .o
per il programma basato su dati di profilazione. Questa opzione suggerisce un ordinamento che può
migliorare il comportamento di paging, tlb e cache per il programma su sistemi che non supportano
ordinamento arbitrario delle funzioni in un eseguibile.

Uso del -a argomento è altamente raccomandato con questa opzione.

Il file_mappa l'argomento è il percorso di un file che fornisce il nome della funzione all'oggetto
mappature di file. Il formato del file è simile all'output del programma "nm".

c-parse.o:00000000 T yyparse
c-parse.o:00000004 C yyerrflag
c-lang.o:00000000 T forse_objc_method_name
c-lang.o:00000000 T print_lang_statistics
c-lang.o:00000000 T riconosci_objc_keyword
c-decl.o:00000000 T print_lang_identifier
c-decl.o:00000000 T print_lang_type
...

Per creare un file_mappa con GNU "nm", digita un comando come "nm --extern-only
--defined-only -v --print-file-name nome-programma".

"-T"
"--tradizionale"
Il -T L'opzione fa in modo che "gprof" stampi il suo output in stile BSD "tradizionale".

"-w larghezza"
"--larghezza=larghezza"
Imposta la larghezza delle linee di output su larghezza. Attualmente utilizzato solo durante la stampa della funzione
indice nella parte inferiore del grafico delle chiamate.

"-X"
"--tutte le righe"
Questa opzione ha effetto solo sull'output della sorgente annotata. Per impostazione predefinita, solo le linee in corrispondenza di
l'inizio di un blocco di base viene annotato. Se questa opzione è specificata, ogni riga in
un blocco di base viene annotato ripetendo l'annotazione per la prima riga. Questo
il comportamento è simile a quello di "tcov" -a.

"--demanle[=stile]"
"--no-demanle"
Queste opzioni controllano se i nomi dei simboli C++ devono essere smantellati durante la stampa
produzione. L'impostazione predefinita è smantellare i simboli. Può essere usata l'opzione "--no-demanle"
per disattivare lo smantellamento. Diversi compilatori hanno diversi stili di manipolazione. Il
l'argomento facoltativo dello stile di smistamento può essere utilizzato per scegliere un smantellamento appropriato
stile per il tuo compilatore.

Analisi Opzioni
"-un"
"--no-statico"
Il -a opzione fa sì che "gprof" sopprima la stampa di dichiarati staticamente (privato)
funzioni. (Queste sono funzioni i cui nomi non sono elencati come globali e che sono
non visibili al di fuori del file/funzione/blocco in cui sono stati definiti.) Tempo trascorso in
queste funzioni, chiamate a/da esse, ecc., saranno tutte attribuite alla funzione che
è stato caricato direttamente prima di esso nel file eseguibile. Questa opzione interessa sia il
profilo piatto e il grafico delle chiamate.

"-C"
"--static-call-graph"
Il -c opzione fa sì che il grafico di chiamata del programma venga aumentato da un'euristica
che esamina lo spazio di testo del file oggetto e identifica le chiamate di funzione nel
codice macchina binario. Poiché i normali record del grafico delle chiamate vengono generati solo quando
vengono inserite le funzioni, questa opzione identifica i bambini che potrebbero essere stati chiamati,
ma non lo sono mai stati. Le chiamate a funzioni che non sono state compilate con la profilazione abilitata sono
anche identificati, ma solo se per essi sono presenti voci della tabella dei simboli. Chiama a
le routine della libreria dinamica sono in genere non è un trovato da questa opzione. Genitori o figli
identificati tramite questa euristica sono indicati nel grafico delle chiamate con conteggi delle chiamate di 0.

"-D"
"--ignora-non-funzioni"
Il -D L'opzione fa in modo che "gprof" ignori i simboli che non sono noti per essere funzioni.
Questa opzione fornirà dati del profilo più accurati sui sistemi in cui è supportata
(Solaris e HPUX per esempio).

"-K da A"
Il -k l'opzione consente di eliminare dal grafico di chiamata qualsiasi arco dai simboli corrispondenti
simspec da a quelli corrispondenti a symspec a.

"-l"
"--linea"
Il -l l'opzione abilita la profilazione riga per riga, che fa sì che i risultati dell'istogramma siano
addebitato alle singole righe del codice sorgente, invece che alle funzioni. Solo questa funzione
funziona con programmi compilati da versioni precedenti del compilatore "gcc". Versioni più recenti
di "gcc" sono progettati per funzionare invece con lo strumento "gcov".

Se il programma è stato compilato con il conteggio dei blocchi di base abilitato, anche questa opzione sarà
identificare quante volte è stata eseguita ogni riga di codice. Mentre la profilazione riga per riga
può aiutare a isolare dove in una grande funzione un programma sta spendendo il suo tempo, anche
aumenta significativamente il tempo di esecuzione di "gprof" e ingrandisce le statistiche
imprecisioni.

"--nomi-file-inline"
Questa opzione fa sì che "gprof" stampi il file sorgente dopo ogni simbolo sia nel flat
profilo e il grafico delle chiamate. Il percorso completo del file viene stampato se utilizzato con il -L
opzione.

"-m numero"
"--min-count=numero"
Questa opzione ha effetto solo sull'output del conteggio delle esecuzioni. Simboli che vengono eseguiti meno di
num i tempi sono soppressi.

"-nsymspec"
"--tempo=symspec"
Il -n opzione fa sì che "gprof", nella sua analisi del grafico delle chiamate, propaghi solo i tempi per
simboli corrispondenti simspec.

"-Nsymspec"
"--non-tempo=symspec"
Il -n opzione fa sì che "gprof", nella sua analisi del grafico delle chiamate, non propaghi i tempi per
simboli corrispondenti simspec.

"-Snome del file"
"--tabella-simbolo-esterno=nome del file"
Il -S opzione fa sì che "gprof" legga un file di tabella dei simboli esterno, come
/proc/kallsyms, invece di leggere la tabella dei simboli dal file oggetto dato (il
l'impostazione predefinita è "a.out"). Questo è utile per profilare i moduli del kernel.

"-z"
"--display-funzioni-inutilizzate"
Se dai il -z opzione, "gprof" menzionerà tutte le funzioni nel profilo piatto,
anche quelli che non sono mai stati chiamati e che non hanno avuto tempo speso in loro. Questo è utile
in combinazione con il -c opzione per scoprire quali routine non sono mai state chiamate.

Miscellanea Opzioni
"-D[numero]"
"--debug[=numero]"
Il -d num opzione specifica le opzioni di debug. Se num non è specificato, abilita tutto
debug.

"-h"
"--aiuto"
Il -h opzione stampa l'utilizzo della riga di comando.

"-Onome"
"--file-format=nome"
Seleziona il formato dei file di dati del profilo. I formati riconosciuti sono auto (la
predefinito), bsd, 4.4 bsd, magiae prof (non ancora supportato).

"-S"
"--somma"
Il -s opzione fa sì che "gprof" riepiloghi le informazioni nei file di dati del profilo it
leggere e scrivere un file di dati del profilo chiamato gmon.sum, che contiene tutte le
informazioni dai file di dati del profilo che "gprof" ha letto. Il file gmon.sum può
essere uno dei file di input specificati; l'effetto di questo è quello di unire i dati nel
altri file di input in gmon.sum.

Alla fine puoi eseguire di nuovo "gprof" senza -s per analizzare i dati cumulativi nel
filetto gmon.sum.

"-v"
"--versione"
Il -v flag fa sì che "gprof" stampi il numero di versione corrente e quindi esca.

deprecato Opzioni
Queste opzioni sono state sostituite con versioni più recenti che utilizzano symspecs.

"-e nome_funzione"
Il -e funzione opzione dice a "gprof" di non stampare informazioni sulla funzione
nome_funzione (e i suoi figli...) nel grafico delle chiamate. La funzione sarà ancora
elencato come figlio di qualsiasi funzione che lo chiama, ma il suo numero di indice verrà mostrato come
[non stampato]. Più di una -e l'opzione può essere data; solo uno nome_funzione può essere
indicato con ciascuno -e opzione.

"-E nome_funzione"
Il "-E funzione" l'opzione funziona come l'opzione "-e", ma il tempo trascorso nella funzione
(e i bambini che non sono stati chiamati da nessun'altra parte), non verranno utilizzati per calcolare il
percentuali di tempo per il grafico delle chiamate. Più di una -E l'opzione può essere data; soltanto
prima nome_funzione può essere indicato con ciascuno -E opzione.

"-F nome_funzione"
Il -f funzione opzione fa sì che "gprof" limiti il ​​grafico della chiamata alla funzione
nome_funzione e i suoi figli (e i loro figli...). Più di una -f l'opzione potrebbe
essere dato; solo uno nome_funzione può essere indicato con ciascuno -f opzione.

"-F nome_funzione"
Il -F funzione l'opzione funziona come l'opzione "-f", ma solo il tempo trascorso nella funzione
e i suoi figli (e i loro figli...) saranno usati per determinare il tempo totale e
percentuali di tempo per il grafico delle chiamate. Più di una -F l'opzione può essere data; soltanto
prima nome_funzione può essere indicato con ciascuno -F opzione. Il -F l'opzione sovrascrive
-E opzione.

Usa alpha-linux-gnu-gprof online usando i servizi onworks.net