mips64-linux-gnuabi64-gprof - Online na nuvem

PROGRAMA:

NOME

gprof - exibir dados de perfil do gráfico de chamadas

SINOPSE

gprof [- [abcDhilLrsTvwxyz]] [- [ACeEfFJnNOpPqQZ] [nome]]
[ -EU dirs ] [-d [Números]] [-k de para ]
[-m min-contagem ] [-R arquivo_mapa ] [-t comprimento da mesa ]
[- [sem-] fonte anotada [=nome]]
[- [sem-] contagens de exec [=nome]]
[- [sem-] perfil plano [=nome]] [- [sem-] gráfico [=nome]]
[- [sem-] tempo =nome] [--todas as linhas] [--brief]
[--debug [=nível]] [- ordenação de funções]
[- ordenação de arquivo arquivo_mapa ] [--diretório-caminho =dirs ]
[--display-unused-functions] [--file-format =nome ]
[--file-info] [--help] [--line] [--inline-file-names]
[--min-count =n ] [--no-static] [--print-path]
[--separate-files] [--static-call-graph] [--sum]
[--table-length =len ] [--tradicional] [--versão]
[--width =n ] [--ignore-non-functions]
[--demangle [=ESTILO]] [--no-demangle]
[--external-symbol-table = name]
[ arquivo de imagem ] [ arquivo de perfil ...]

DESCRIÇÃO

"gprof" produz um perfil de execução de programas C, Pascal ou Fortran77. O efeito de
as rotinas chamadas são incorporadas ao perfil de cada chamador. Os dados do perfil são obtidos
do arquivo de perfil do gráfico de chamadas (gmon.out padrão) que é criado por programas que são
compilado com o -pg opção de "cc", "pc" e "f77". o -pg opção também liga em
versões das rotinas da biblioteca que são compiladas para criação de perfil. "Gprof" lê o dado
arquivo objeto (o padrão é "a.out") e estabelece a relação entre sua tabela de símbolos
e o perfil do gráfico de chamadas de gmon.out. Se mais de um arquivo de perfil for especificado, o
A saída "gprof" mostra a soma das informações do perfil nos arquivos de perfil fornecidos.

Se você usar gcc 2.95.x ou 3.0 para compilar seus binários, pode ser necessário adicionar o
-fprofile-arcos para a linha de comando de compilação para que os gráficos de chamadas sejam devidamente
armazenado em gmon.out.

O "Gprof" calcula a quantidade de tempo gasto em cada rotina. Em seguida, esses tempos são
propagado ao longo das bordas do gráfico de chamadas. Ciclos são descobertos e chamadas para um
ciclo são feitos para compartilhar o tempo do ciclo.

Diversas formas de saída estão disponíveis a partir da análise.

A plano perfis mostra quanto tempo seu programa gastou em cada função, e quantos
vezes que a função foi chamada. Se você simplesmente deseja saber quais funções queimam a maioria dos
os ciclos, é afirmado de forma concisa aqui.

A chamada gráfico mostra, para cada função, quais funções foram chamadas, quais outras funções
chamou, e quantas vezes. Há também uma estimativa de quanto tempo foi gasto em
as sub-rotinas de cada função. Isso pode sugerir lugares onde você pode tentar
elimine chamadas de função que consomem muito tempo.

A Anotado fonte listagem é uma cópia do código-fonte do programa, rotulado com o
número de vezes que cada linha do programa foi executada.

OPÇÕES

Essas opções especificam qual dos vários formatos de saída "gprof" deve produzir.

Muitas dessas opções são opcionais Symspec para especificar funções a serem incluídas ou
excluídos. Essas opções podem ser especificadas várias vezes, com diferentes symspecs, para
incluir ou excluir conjuntos de símbolos.

Especificar qualquer uma dessas opções substitui o padrão (-p -q), que imprime um perfil plano
e análise de gráfico de chamadas para todas as funções.

"-UMA[symspec] "
"--annotated-source [=symspec] "
A -A opção faz com que "gprof" imprima o código-fonte anotado. Se Symspec é especificado,
saída de impressão apenas para símbolos correspondentes.

"-b"
"--apresentação"
Se o -b opção for fornecida, "gprof" não imprime as sinopses verbosas que tentam
explicar o significado de todos os campos nas tabelas. Isso é útil se você pretende
para imprimir a saída ou está cansado de ver as sinopses.

"-C [symspec] "
"--exec-counts [=symspec] "
A -C opção faz com que "gprof" imprima uma contagem de funções e o número de vezes
cada um foi chamado. Se Symspec é especificado, imprime contagem apenas para símbolos correspondentes.

Se o arquivo de dados de perfil contém registros de contagem de bloco básico, especificando o -l opção,
e o -C, fará com que as contagens de execução do bloco básico sejam computadas e exibidas.

"-EU"
"--informações do arquivo"
A -i opção faz com que "gprof" exiba informações resumidas sobre os dados do perfil
arquivo (s) e, em seguida, saia. O número de histograma, gráfico de chamada e contagem de bloco básico
registros é exibido.

"-EU dirs "
"- caminho do diretório =dirs "
A -I opção especifica uma lista de diretórios de pesquisa nos quais localizar os arquivos de origem.
Variável de ambiente GPROF_PATH também pode ser usado para transmitir essas informações. Usado
principalmente para saída de fonte anotada.

"-J [symspec] "
"--no-annotated-source [=symspec] "
A -J opção faz com que "gprof" não imprima o código-fonte anotado. Se Symspec is
especificado, "gprof" imprime a fonte anotada, mas exclui os símbolos correspondentes.

"-EU"
"--print-path"
Normalmente, os nomes dos arquivos de origem são impressos com o componente do caminho suprimido. o -L
opção faz com que "gprof" imprima o caminho completo dos nomes dos arquivos de origem, que é
determinado a partir de informações de depuração simbólicas no arquivo de imagem e é relativo a
o diretório no qual o compilador foi chamado.

"-p [symspec] "
"--flat-profile [=symspec] "
A -p opção faz com que "gprof" imprima um perfil plano. Se Symspec é especificado, imprimir
perfil plano apenas para símbolos correspondentes.

"-P [symspec] "
"--no-flat-profile [=symspec] "
A -P opção faz com que "gprof" suprima a impressão de um perfil plano. Se Symspec is
especificado, "gprof" imprime um perfil plano, mas exclui os símbolos correspondentes.

"-q [symspec] "
"--graph [=symspec] "
A -q opção faz com que "gprof" imprima a análise do gráfico de chamadas. Se Symspec is
especificado, imprime gráfico de chamadas apenas para símbolos correspondentes e seus filhos.

"-Q [symspec] "
"--não gráfico [=symspec] "
A -Q opção faz com que "gprof" suprima a impressão do gráfico de chamadas. Se Symspec is
especificado, "gprof" imprime um gráfico de chamadas, mas exclui os símbolos correspondentes.

"-t"
"- comprimento da tabela =num "
A -t opção faz com que o Números mais linhas de origem ativas em cada arquivo de origem a ser listado
quando a anotação de origem está habilitada. O padrão é 10.

"-y"
"--separate-files"
Esta opção afeta apenas a saída da fonte anotada. Normalmente, "gprof" imprime anotado
arquivos de origem para saída padrão. Se esta opção for especificada, a fonte anotada para um
arquivo chamado caminho / nome do arquivo é gerado no arquivo nome do arquivo-ann. Se o subjacente
sistema de arquivos truncaria nome do arquivo-ann de modo que sobrescreve o original nome do arquivo,
"gprof" gera fonte anotada no arquivo nome do arquivo.ann em vez disso (se o original
nome do arquivo tem uma extensão, essa extensão é substituído com .ann).

"-Z [symspec] "
"--não-exec-contagens [=symspec] "
A -Z opção faz com que "gprof" não imprima uma contagem de funções e o número de vezes
cada um foi chamado. Se Symspec é especificado, imprime contagem, mas exclui símbolos correspondentes.

"-r"
"- ordenação de funções"
A - ordem de função opção faz com que "gprof" imprima uma sugestão de pedido de função
para o programa com base em dados de criação de perfil. Esta opção sugere um pedido que pode
melhorar o comportamento de paginação, tlb e cache para o programa em sistemas que suportam
ordenação arbitrária de funções em um executável.

Os detalhes exatos de como forçar o vinculador a colocar funções em uma ordem específica
é dependente do sistema e está fora do escopo deste manual.

"-R map_file "
"- ordenação de arquivos map_file "
A - ordenação de arquivo opção faz com que "gprof" imprima uma sugestão de pedido de linha de link .o
para o programa com base em dados de criação de perfil. Esta opção sugere um pedido que pode
melhorar o comportamento de paginação, tlb e cache para o programa em sistemas que não suportam
ordenação arbitrária de funções em um executável.

Uso do -a argumento é altamente recomendado com esta opção.

A arquivo_mapa argumento é um caminho para um arquivo que fornece o nome da função para o objeto
mapeamentos de arquivos. O formato do arquivo é semelhante à saída do programa "nm".

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

Para criar um arquivo_mapa com GNU "nm", digite um comando como "nm - apenas externo
--defined-only -v --print-file-name nome-do-programa ".

"-T"
"--tradicional"
A -T a opção faz com que o "gprof" imprima sua saída no estilo BSD "tradicional".

"-C largura"
"--width =largura"
Define a largura das linhas de saída para largura. Atualmente usado apenas ao imprimir a função
índice na parte inferior do gráfico de chamadas.

"-x"
"- todas as linhas"
Esta opção afeta apenas a saída da fonte anotada. Por padrão, apenas as linhas no
início de um bloco básico são anotados. Se esta opção for especificada, cada linha em
um bloco básico é anotado repetindo a anotação para a primeira linha. Esse
comportamento é semelhante ao de "tcov" -a.

"--demangle [=estilo]"
"--no-demangle"
Essas opções controlam se os nomes dos símbolos C ++ devem ser removidos durante a impressão
saída. O padrão é desmantelar os símbolos. A opção "--no-demangle" pode ser usada
para desligar a demangling. Compiladores diferentes têm estilos de mutilação diferentes. o
o argumento de estilo de demangling opcional pode ser usado para escolher uma demangling apropriada
estilo para o seu compilador.

Análise Opções
"-uma"
"--no-static"
A -a opção faz com que "gprof" suprima a impressão de estaticamente declarado (privado)
funções. (Estas são funções cujos nomes não estão listados como globais, e que são
não visível fora do arquivo / função / bloco onde foram definidos.) Tempo gasto em
essas funções, chamadas para / a partir deles, etc., serão todos atribuídos à função que
foi carregado diretamente antes dele no arquivo executável. Esta opção afeta tanto o
perfil plano e o gráfico de chamadas.

"-c"
"--static-call-graph"
A -c opção faz com que o gráfico de chamada do programa seja aumentado por uma heurística
que examina o espaço de texto do arquivo de objeto e identifica chamadas de função no
código de máquina binário. Uma vez que os registros normais do gráfico de chamadas são gerados apenas quando
funções são inseridas, esta opção identifica filhos que poderiam ter sido chamados,
mas nunca foi. Chamadas para funções que não foram compiladas com a criação de perfil habilitada são
também identificados, mas apenas se as entradas da tabela de símbolos estiverem presentes para eles. Chamadas para
rotinas de biblioteca dinâmica são tipicamente não encontrado por esta opção. Pais ou filhos
identificados por meio desta heurística são indicados no gráfico de chamadas com contagens de chamadas de 0.

"-D"
"--ignore-non-functions"
A -D opção faz com que "gprof" ignore símbolos que não são conhecidos como funções.
Esta opção fornecerá dados de perfil mais precisos em sistemas onde é suportado
(Solaris e HPUX por exemplo).

"-k de para"
A -k opção permite que você apague do gráfico de chamadas quaisquer arcos de símbolos correspondentes
Symspec da para aqueles symspec correspondentes para.

"-eu"
"--linha"
A -l opção ativa o perfil linha por linha, o que faz com que os acessos do histograma sejam
cobrados por linhas de código-fonte individuais, em vez de funções. Este recurso apenas
funciona com programas compilados por versões anteriores do compilador "gcc". Versões mais recentes
do "gcc" são projetados para funcionar com a ferramenta "gcov".

Se o programa foi compilado com a contagem de blocos básicos habilitada, esta opção também irá
identificar quantas vezes cada linha de código foi executada. Durante a criação de perfil linha por linha
pode ajudar a isolar onde em uma função grande um programa está gastando seu tempo, ele também
aumenta significativamente o tempo de execução de "gprof" e amplia as estatísticas
imprecisões.

"--nomes-de-arquivo-in-line"
Esta opção faz com que o "gprof" imprima o arquivo de origem após cada símbolo no plano
perfil e o gráfico de chamadas. O caminho completo para o arquivo é impresso se usado com o -L
opção.

"-m num "
"--min-count =num "
Esta opção afeta apenas a saída da contagem de execução. Símbolos que são executados menos de
Números os tempos são suprimidos.

"-nsymspec "
"--time =symspec "
A -n opção faz com que "gprof", em sua análise de gráfico de chamadas, propague apenas tempos para
símbolos combinando Symspec.

"-Nsymspec "
"--no-time =symspec "
A -n opção faz com que "gprof", em sua análise de gráfico de chamadas, não propague tempos para
símbolos combinando Symspec.

"-Snome do arquivo"
"--external-symbol-table =nome do arquivo"
A -S opção faz com que "gprof" leia um arquivo de tabela de símbolos externa, como
/ proc / kallsyms, em vez de ler a tabela de símbolos do arquivo de objeto fornecido (o
o padrão é "a.out"). Isso é útil para criar perfis de módulos do kernel.

"-z"
"--display-unused-functions"
Se você der o -z opção, "gprof" mencionará todas as funções no perfil plano,
mesmo aqueles que nunca foram chamados, e que não tiveram nenhum tempo gasto com eles. Isso é útil
em conjunto com o -c opção para descobrir quais rotinas nunca foram chamadas.

Gerais Opções
"-d [num] "
"--debug [=num] "
A -d Números opção especifica opções de depuração. Se Números não é especificado, habilite todos
depuração.

"-h"
"--ajuda"
A -h opção imprime o uso da linha de comando.

"-Onome"
"--file-format =nome"
Seleciona o formato dos arquivos de dados do perfil. Os formatos reconhecidos são auto (O
padrão), bsd, 4.4 bsd, mágica e prof (ainda não suportado).

"-s"
"--soma"
A -s opção faz com que o "gprof" resuma as informações nos arquivos de dados do perfil.
ler e escrever um arquivo de dados de perfil chamado gmon.sum, que contém todos os
informações dos arquivos de dados de perfil que o "gprof" lê. O arquivo gmon.sum pode
ser um dos arquivos de entrada especificados; o efeito disso é mesclar os dados no
outros arquivos de entrada em gmon.sum.

Eventualmente, você pode executar "gprof" novamente sem -s para analisar os dados cumulativos no
lima gmon.sum.

"-v"
"--versão"
A -v sinalizador faz com que "gprof" imprima o número da versão atual e saia.

Obsoleto Opções
Essas opções foram substituídas por versões mais recentes que usam symspecs.

"-e function_name "
A -e função opção diz ao "gprof" para não imprimir informações sobre a função
nome_função (e seus filhos ...) no gráfico de chamadas. A função ainda será
listado como filho de qualquer função que o chame, mas seu número de índice será mostrado como
[não impresso]. Mais de um -e opção pode ser dada; apenas um nome_função pode ser
indicado com cada -e opção.

"-E function_name "
O "-E função" opção funciona como a opção "-e", mas o tempo gasto na função
(e filhos que não foram chamados de qualquer outro lugar), não serão usados ​​para calcular o
percentagens de tempo para o gráfico de chamadas. Mais de um -E opção pode ser dada; só
um nome_função pode ser indicado com cada -E opção.

"-f function_name "
A -f função opção faz com que "gprof" limite o gráfico de chamadas para a função
nome_função e seus filhos (e seus filhos ...). Mais de um -f opção pode
seja dado; apenas um nome_função pode ser indicado com cada -f opção.

"-F function_name "
A -F função opção funciona como a opção "-f", mas apenas o tempo gasto na função
e seus filhos (e seus filhos ...) serão usados ​​para determinar o tempo total e
percentagens de tempo para o gráfico de chamadas. Mais de um -F opção pode ser dada; só
um nome_função pode ser indicado com cada -F opção. O -F opção substitui o
-E opção.

Use mips64-linux-gnuabi64-gprof online usando serviços onworks.net