Configurando tools.ini

O arquivo tools.ini contém informações para inicializar os depuradores de linha de comando. Na inicialização, o depurador procura o cabeçalho de seção apropriado no arquivo tools.ini e extrai informações de inicialização das entradas no 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 é VERDADEIRA.

Entrada	Descrição
$u 0: valor ... $u 9: valor	Atribua valores a aliases de nome fixo. Você pode especificar valores numéricos n ou 0xn ou qualquer outra string. Consulte Usando aliases para obter detalhes. Nenhum equivalente de linha de comando.
DebugChildren: sinalizador	VERDADEIRO ou FALSO. Se TRUE, o CDB depurará o aplicativo especificado, bem como todos os processos filho que ele possa gerar. O equivalente da linha de comando é -o.
DebugOutput: sinalizador	VERDADEIRO ou FALSO. Se TRUE, o CDB envia a saída e recebe 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: arquivo	Especifica o nome do arquivo de script do qual o CDB ou KD recebe 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: sinalizador	VERDADEIRO ou FALSO. Se TRUE, o CDB executa o carregamento lento de símbolos; ou seja, os símbolos não são carregados até que sejam necessários. 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: nome do arquivo	Defina a DLL de extensão. A extensão .dll nome de arquivo deve ser omitida. O padrão é userexts.dll. O equivalente da linha de comando é -a. Para obter detalhes e outros métodos de definir esse padrão, consulte Carregando DLLs de extensão do depurador.
StopFirst: sinalizador	VERDADEIRO ou FALSO. Se for verdadeiro, o CDB será interrompido no ponto de interrupção no final do processo de carregamento da imagem. O equivalente da linha de comando é -g.
StopOnProcessExit: sinalizador	VERDADEIRO ou FALSO. Se TRUE, o CDB será interrompido quando receber uma notificação de encerramento do processo. O equivalente da linha de comando é -G.
sxd: eventosxe: evento	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 do evento Consulte Controlando exceções e eventos para obter detalhes sobre esse processo e outros métodos de controle dessas configurações.
VerboseOutput: sinalizador	VERDADEIRO ou FALSO. Se TRUE, o CDB exibirá informações detalhadas sobre manipulação de símbolos, notificação de eventos e outras ocorrências de tempo de execução. O equivalente de linha de comando é -v.
linhas: bandeira	VERDADEIRO ou FALSO. O sinalizador lines habilita ou desabilita o suporte para informações de linha de origem.
srcopt: opções	Define as opções de linha de origem que controlam a exibição da origem e as opções de revisão do programa. Para obter mais informações, consulte l+, l- (Definir opções de origem).
srcpath: diretório	Define o caminho de pesquisa do arquivo de origem. Para obter mais informações, consulte .srcpath, .lsrcpath (Definir caminho de origem).
enable_unicode: bandeira	VERDADEIRO ou FALSO. O sinalizador enable_unicode especifica se o depurador exibe ponteiros e matrizes USHORT como cadeias de caracteres Unicode.
force_radix_output: bandeira	VERDADEIRO ou FALSO. O sinalizador force_radix_output especifica se os inteiros são exibidos no formato decimal ou na base padrão.
col_mode: bandeira	VERDADEIRO ou FALSO. O sinalizador col_mode controla a configuração do modo de cor. Quando o modo de cor está habilitado, o depurador pode produzir uma 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: nome colspec	O nome indica o elemento que você está colorindo. O colspec é um indicador RGB de três letras da forma [rR-][gG-][bB-]. Uma letra minúscula indica mais escuro, uma letra maiúscula indica mais claro e um traço indica que não há contribuição do componente de cor. Devido às limitações de cores do console, bright não é realmente por componente, mas se aplica a todos os componentes se algum solicitar bright. Em outras palavras, rgB é o mesmo que RGB. Por esse motivo, recomenda-se que todas as tampas sejam usadas se alguma tampa for usada. Exemplo de uso: col: emphfg R--

Segue uma seção de amostra [NTSD] no arquivo tools.ini:

[NTSD]
sxe: 3c
sxe: cc
$u0: VeryLongName
VerboseOutput:true