Configurando tools.ini
O arquivo tools.ini contém informações para inicializar os depuradores de linha de comando. Na inicialização, o depurador pesquisa o cabeçalho de seção apropriado no arquivo tools.ini e extrai informações de inicialização das entradas sob o cabeçalho . Cada depurador de linha de comando tem seu próprio cabeçalho de seção – [CDB], [NTSD] e [KD]. A variável de ambiente INIT deve apontar para o diretório que contém o arquivo tools.ini.
O WinDbg não usa o arquivo tools.ini. Em vez disso, o WinDbg salva as configurações de inicialização em workspaces.
As entradas tools.ini são mostradas na tabela a seguir.
As palavras-chave devem ser separadas dos valores por espaço em branco ou dois-pontos. As palavras-chave não diferenciam maiúsculas de minúsculas.
Para valores TRUE ou FALSE , "FALSE" é o único valor falso. Qualquer outra coisa é TRUE.
Entrada | Descrição |
---|---|
$u 0:value ... $u 9:value |
Atribua valores a aliases de nome fixo. Você pode especificar valores numéricos n ou 0xn ou qualquer outra cadeia de caracteres. Consulte Usando aliases para obter detalhes. Nenhum equivalente de linha de comando. |
DebugChildren:flag |
TRUE ou FALSE. Se TRUE, o CDB depura o aplicativo especificado, bem como todos os processos filho que ele pode gerar. O equivalente da linha de comando é -o. |
DebugOutput:flag |
TRUE ou FALSE. Se TRUE, o CDB enviará a saída e receberá a entrada por meio de um terminal. Se FALSE, a saída vai para a tela do usuário. A opção de linha de comando -d é semelhante, mas não idêntica. |
IniFile:file |
Especifica o nome do arquivo de script do qual CDB ou KD usa comandos na inicialização. O padrão é o arquivo ntsd.ini no diretório atual. O equivalente da linha de comando é -cf. Para obter detalhes, consulte Usando arquivos de script. |
LazyLoad:flag |
TRUE ou FALSE. Se TRUE, o CDB executará o carregamento lento de símbolos; ou seja, os símbolos não são carregados até que seja necessário. O equivalente da linha de comando é -s. Para obter detalhes e outros métodos de configuração dessa opção, consulte Carregamento de símbolo adiado. |
SetDll:filename |
Defina a DLL de extensão. A extensão de nome de arquivo .dll deve ser omitida. O padrão é userexts.dll. O equivalente de linha de comando é -a. Para obter detalhes e outros métodos de configuração desse padrão, consulte Carregando DLLs de extensão do depurador. |
StopFirst:flag |
TRUE ou FALSE. Se for true, o CDB será interrompido no ponto de interrupção no final do processo de carregamento de imagens. O equivalente da linha de comando é -g. |
StopOnProcessExit:flag |
TRUE ou FALSE. Se TRUE, a CDB será interrompida quando receber uma notificação de encerramento do processo. O equivalente da linha de comando é -G. |
sxd:eventsxe:event | Define a resposta do depurador e o status de tratamento para a exceção ou evento especificado. Exceções e eventos podem ser especificados das seguintes maneiras: *: exceção padrão n: exceção n (decimal) 0xn: exceção 0xn (hexadecimal) (outro): código de eventoConsulte Controlando exceções e eventos para obter detalhes desse processo e para outros métodos de controle dessas configurações. |
VerboseOutput:flag |
TRUE ou FALSE. Se TRUE, a CDB exibirá informações detalhadas sobre manipulação de símbolos, notificação de eventos e outras ocorrências em tempo de execução. O equivalente da linha de comando é -v. |
lines:flag |
TRUE ou FALSE. O sinalizador de linhas habilita ou desabilita o suporte para informações de linha de origem. |
srcopt:options |
Define as opções de linha de origem que controlam as opções de exibição do código-fonte e de etapa do programa. Para obter mais informações , consulte l+, l- (Definir opções de origem). |
srcpath:directory |
Define o caminho de pesquisa do arquivo de origem. Para obter mais informações , consulte .srcpath, .lsrcpath (Definir caminho de origem). |
enable_unicode:flag |
TRUE ou FALSE. O sinalizador enable_unicode especifica se o depurador exibe ponteiros e matrizes USHORT como cadeias de caracteres Unicode. |
force_radix_output:flag |
TRUE ou FALSE. O sinalizador force_radix_output especifica se os inteiros são exibidos no formato decimal ou no radix padrão. |
col_mode:flag |
TRUE ou FALSE. O sinalizador col_mode controla a configuração do modo de cor. Quando o modo de cor está habilitado, o depurador pode produzir saída colorida. Por padrão, a maioria das cores não é definida e, em vez disso, usa como padrão as cores atuais do console. |
col:namecolspec |
O nome indica o elemento que você está colorindo. O colspec é um indicador RGB de três letras do formulário [rR-][gG-][bB-]. Uma letra minúscula indica mais escura, uma letra maiúscula indica mais brilhante e um traço não indica nenhuma contribuição de componente de cor. Devido às limitações de cor do console, bright não é realmente por componente, mas se aplica a todos os componentes se qualquer solicitação for brilhante. Em outras palavras, rgB é o mesmo que RGB. Por esse motivo, é recomendável que todas as tampas sejam usadas se algum caps for usado. Exemplo de uso: col: emphfg R-- |
Uma seção de exemplo [NTSD] no arquivo tools.ini segue:
[NTSD]
sxe: 3c
sxe: cc
$u0: VeryLongName
VerboseOutput:true
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de