Partilhar via

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 de 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.

WinDbg não usa o arquivo tools.ini. Em vez disso, o WinDbg salva as configurações de inicialização em espaços de trabalho.

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 são sensíveis a maiúsculas e 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 cadeia de caracteres. Consulte Usando aliases para obter detalhes. Nenhum equivalente de linha de comando.

DebugChildren:bandeira

VERDADEIRO ou FALSO. Se TRUE, o CDB depura a aplicação especificada, bem como quaisquer processos filho que possa gerar. O equivalente da linha de comando é -o.

DebugOutput:sinalizador

VERDADEIRO ou FALSO. Se TRUE, CDB envia saída e recebe entrada através de um terminal. Se FALSO, a saída vai para o ecrã 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 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:bandeira

VERDADEIRO ou FALSO. Se TRUE, CDB executa o carregamento lento do símbolo; 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 definir essa opção, consulte Carregamento de símbolo diferido.

SetDll:nome do arquivo

Defina a extensão DLL. A extensão .dll nome do 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 este padrão, consulte Carregamento de DLLs de Extensão do Depurador.

StopFirst:bandeira

VERDADEIRO ou FALSO. Se verdadeiro, o CDB para 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 para quando recebe 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 manipulação 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) (outros): Código do evento

Consulte Controlando exceções e eventos para obter detalhes desse processo e outros métodos de controle dessas configurações.

VerboseOutput:flag

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 em tempo de execução. O equivalente da linha de comando é -v.

linhas:bandeira

VERDADEIRO ou FALSO. O sinalizador de linhas 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 do código-fonte e as opções de execução passo a passo do programa. Para obter mais informações , consulte l+, l- (set Source Options).

srcpath:diretório

Define o caminho de pesquisa do arquivo de origem. Para obter mais informações , consulte .srcpath, .lsrcpath (set Source Path).

enable_unicode:indicador

VERDADEIRO ou FALSO. O sinalizador enable_unicode especifica se o depurador exibe ponteiros e matrizes USHORT como cadeias de caracteres Unicode.

force_radix_output:indicador

VERDADEIRO ou FALSO. O sinalizador force_radix_output especifica se os inteiros são exibidos no formato decimal ou no radix padrão.

col_mode:indicador

VERDADEIRO ou FALSO. O sinalizador col_mode controla a configuração do modo de cor. Quando o modo de cor está ativado, o depurador pode produzir uma saída colorida. Por padrão, a maioria das cores não é definida e, em vez disso, utiliza as cores atuais do console.

col:nomecolspec

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 brilhante e um traço indica nenhuma contribuição de componente de cor. Devido às limitações de cor do console, o brilho não é realmente por componente, mas aplica-se a todos os componentes se qualquer um solicitar brilho. Em outras palavras, rgB é o mesmo que RGB. Por esta razão, recomenda-se que sejam usadas todas as letras maiúsculas caso algumas letras maiúsculas venham a ser utilizadas.

Exemplo de uso:

col: emphfg R--

Segue-se uma secção de exemplo [NTSD] no ficheiro tools.ini:

[NTSD]
sxe: 3c
sxe: cc
$u0: VeryLongName
VerboseOutput:true
  • Last updated on