VSInstr
A ferramenta VSInstr é usada para instrumentar binários.Ele é chamado usando a seguinte sintaxe:
VSInstr [/U] filename [/options]
A tabela a seguir descreve as opções da ferramenta VSInstr:
Opções |
Descrição |
|---|---|
HELP ou ? |
Exibe ajuda. |
U |
A opção U grava a saída redirecionada do console sistema autônomo Unicode.Ele deve ser a primeira opção especificada. |
@filename |
Arquivo de resposta deve ter uma opção de comando por linha.Não use aspas. |
OUTPUTPATH:path |
Diretório de destino para a imagem instrumentada.Se um caminho de saída não for especificado, o binário original é renomeado acrescentando "Orig" ao nome de arquivo na mesma pasta e uma cópia do binário é instrumentada. |
CONTROL:{THREAD|PROCESS|GLOBAL} |
A opção CONTROL é usada para especificar o nível de profiling das seguintes funções controle de coleta de dados: StartProfile StopProfile SuspendProfile ResumeProfile THREAD -Especifica a coleta de dados de nível de segmento controle funções. O profiling é iniciado ou interrompido somente para o segmento atual.O estado do profiling de outros segmentos não é afetado.O padrão é o segmento. PROCESS -Especifica os dados em nível de processo de criação de perfil coleção controlar funções. O profiling inicia ou para para todos os segmentos no processo atual.O estado do profiling de outros processos não é afetado. GLOBAL -Especifica o nível global (processo cruzada) da função de controle da coleta de dados. Um erro ocorrerá se você não especificar o nível do profiling. |
START:{INSIDE|OUTSIDE},funcname |
A opção START é usada para limitar a coleta de dados para a função de destino e funções filho chamadas por essa função. INSIDE -Insere a função StartProfile imediatamente após a entrada para a função de destino. Insere a função StopProfile imediatamente antes de cada retorno na função de destino. OUTSIDE -Insere a função StartProfile imediatamente antes de cada telefonar para a função de destino. Insere a função StopProfile imediatamente após cada chamada para a função de destino. funcname -nome da função destino. |
SUSPEND:{INSIDE|OUTSIDE},funcname |
A opção SUSPEND é usada para excluir a coleta de dados para a função de destino e funções filho chamadas pela função. INSIDE -Insere a função SuspendProfile imediatamente após a entrada para a função de destino. Insere a função ResumeProfile imediatamente antes de cada retorno na função de destino. OUTSIDE -Insere a função SuspendProfile imediatamente antes da entrada para a função de destino. Insere a função ResumeProfile imediatamente após a saída da função de destino. funcname -nome da função de destino. Se a função destino contém uma função StartProfile, a função SuspendProfile será inserida antes desta.Se a função destino contém uma função StopProfile, a função ResumeProfile será inserida depois desta. |
STARTONLY:{BEFORE|AFTER|TOP|BOTTOM},funcname |
A opção STARTONLY é usada para iniciar a coleta de dados durante uma execução do profiling.Ela insere a função API StartProfile no local especificado. BEFORE -imediatamente antes da entrada da função destino. AFTER -imediatamente após a sair da função de destino. TOP -imediatamente depois da entrada da função destino. BOTTOM -imediatamente antes de cada retorno na função de destino. funcname -nome da função de destino. |
STOPONLY:{BEFORE|AFTER|TOP|BOTTOM},funcname |
A opção STOPONLY é usada para interromper a coleta de dados durante uma execução do profiling.Ela insere a função StopProfile no local especificado. BEFORE -imediatamente antes da entrada da função destino. AFTER -imediatamente após a sair da função de destino. TOP -imediatamente depois da entrada da função destino. BOTTOM -imediatamente antes de cada retorno na função de destino. funcname -nome da função de destino. |
SUSPENDONLY:{BEFORE|AFTER|TOP|BOTTOM},funcname |
A opção SUSPENDONLY é usada para interromper a coleta de dados durante uma execução de profiling.Ele insere a API SuspendProfile no local especificado. BEFORE -imediatamente antes da entrada da função destino. AFTER -imediatamente após a sair da função de destino. TOP -imediatamente depois da entrada da função destino. BOTTOM -imediatamente antes de cada retorno na função de destino. funcname -nome da função de destino. Se a função destino contém uma função StartProfile, a função SuspendProfile será inserida antes desta. |
RESUMEONLY:{BEFORE|AFTER|TOP|BOTTOM},funcname |
A opção RESUMEONLY é usada para iniciar ou reiniciar coleta dados durante uma execução de profiling. Ela é geralmente utilizada para iniciar um profiling após uma opção SUSPENDONLY interromper o profiling.Ela insere uma API ResumeProfile no local especificado. BEFORE -imediatamente antes da entrada da função destino. AFTER -imediatamente após a sair da função de destino. TOP -imediatamente depois da entrada da função destino. BOTTOM -imediatamente antes de cada retorno na função de destino. funcname -nome da função de destino. Se a função destino contém uma função StopProfile, a função ResumeProfile será inserida depois desta. |
EXCLUDE:funcspec |
A opção EXCLUDE especifica uma especificação de função a ser excluída da instrumentação por investigação.Ela é útil quando a inserção de investigação no profiling em uma função causa resultados imprevisíveis ou indesejados. Não use as opções EXCLUDE e INCLUDE que se referem a funções no mesmo binário. Você pode especificar múltiplas especificações de função com opções EXCLUDE separadas. funcspec é definida sistema autônomo: [namespace <separator1>] [classe <separator2>] função <separator1>é:: para código nativo, e . para código gerenciado. <separator2>é sempre:: A opção EXCLUDE oferece suporte à cobertura código. Para excluir todas as funções em um namespace usar o caractere curinga: MyNamespace:: * |
INCLUDE:funcspec |
A opção INCLUDE Especifica uma especificação de função em um binário para instrumentar com testes.Todas as outras funções nos binários não são instrumentadas. Você pode especificar várias especificações de função com opções INCLUDE separadas. Não use opções INCLUDE e EXCLUDE que se refiram a funções no mesmo binário. A opção INCLUDE não é suportada com cobertura de código. funcspec é definida sistema autônomo: [namespace <separator1>] [classe <separator2>] função <separator1>é:: para código nativo, e . para código gerenciado. <separator2>é sempre:: |
EXCLUDESMALLFUNCS |
Exclui funções pequenas, que são funções curtas que não faça chamadas de função, de instrumentação.A opção EXCLUDESMALLFUNCS fornece menos sobrecarga devido à instrumentação de velocidade de instrumentação, portanto, melhor. A exclusão de pequenas funções também reduz o dimensionar do arquivo VSP e time necessário para análise. |
MARK:{BEFORE|AFTER|TOP|BOTTOM},funcname,markid |
A opção MARK insere uma função API MarkProfile na entrada ou na saída da função de destino.A API MarkProfile insere uma marca de analisar (um identificador usado para delimitar os dados em relatórios) que você pode usar para identificar o início ou participante de um intervalo de dados no arquivo de relatório Vsp. BEFORE -Imediatamente antes da entrada da função destino. AFTER -Imediatamente após a sair da função destino. TOP -Imediatamente depois da entrada da função destino. BOTTOM -Imediatamente antes de cada retorno na função de destino. funcname -Nome da função de destino Markid -Um inteiro positivo (long) para usar sistema autônomo o identificador do analisar da marca. |
COVERAGE |
A opção COVERAGE executa a instrumentação de cobertura.Ela pode ser combinada com a opção OUTPUTPATH. |
VERBOSE |
A opção VERBOSE é usada para exibir informações detalhadas sobre o processo de instrumentação. |
NOWARN[:[Message Number[;Message Number]]] |
A opção NOWARN é usada para suprimir todos os avisos ou alguns específicos. Message Number -o número de aviso. If Message Number é omitido, todos os avisos são suprimidos. Para obter mais informações, consulte Avisos VSInstr. |
DUMPFUNCS |
A opção DUMPFUNCS exibe as funções dentro da imagem especificada.Nenhuma instrumentação é executada. |
Consulte também
Referência
Definições de coluna do relatório de ferramentas de criação de perfil