Opções de Command-Line KD

Os usuários iniciantes do KD devem começar com a seção Depuração Usando KD e NTKD .

A linha de comando KD usa a sintaxe a seguir.

kd [ -server ServerTransport | -remote ClientTransport ] 
   [-b | -x] [-d] [-bonc] [-m] [-myob] [-lines] [-n] [-r] [-s] 
   [-v] [-clines lines] [-failinc] [-noio] [-noshell] 
   [-secure] [-sdce] [-ses] [-sicv] [-sins] [-snc] [-snul]
   [-sup] [-sflags 0xNumber] [-log{a|au|o|ou} LogFile] 
   [-aExtension] [-zp PageFile] 
   [-i ImagePath] [-y SymbolPath]  [-srcpath SourcePath] 
   [-k ConnectType | -kl | -kqm | -kx ExdiOptions] [-ee {masm|c++}] 
   [-z DumpFile] [-cf "filename"] [-cfr "filename"] [-c "command"] 
   [-t PrintErrorLevel] [-version] 

kd -iu KeyString

kd -QR Server 

kd -wake PID 

kd -?

As descrições das opções de linha de comando do KD seguem. Somente as opções -remote e -server diferenciam maiúsculas de minúsculas. O hífen inicial pode ser substituído por uma barra (/). As opções que não levam parâmetros adicionais podem ser concatenadas – portanto , kd -r -n -v pode ser gravado como kd -rnv.

Se a opção -remote ou -server for usada, ela deverá aparecer antes de qualquer outra opção na linha de comando.

Parâmetros

-serverServerTransport
Cria um servidor de depuração que pode ser acessado por outros depuradores. Para obter uma explicação do possível ServerTransport, consulte Ativando um servidor de depuração. Quando esse parâmetro é usado, ele deve ser os primeiros parâmetros na linha de comando.

-remoteClientTransport
Cria um cliente de depuração e se conecta a um servidor de depuração que já está em execução. Para obter uma explicação dos possíveis valores clientTransport , consulte Ativando um cliente de depuração. Quando esse parâmetro é usado, ele deve ser os primeiros parâmetros na linha de comando.

-aExtension
Define a DLL de extensão padrão. O padrão é kdextx86.dll ou kdexts.dll. Não deve haver espaço após o "a" e a extensão de nome de arquivo .dll não deve ser incluída. Para obter detalhes e outros métodos de configuração desse padrão, consulte Carregando DLLs de extensão do depurador.

-B
Não há mais suporte para essa opção.

-bonc
Se essa opção for especificada, o depurador será dividido no destino assim que a sessão começar. Isso é especialmente útil ao se conectar a um servidor de depuração que pode não estar dividido no destino no momento.

-c "command"
Especifica o comando inicial do depurador a ser executado na inicialização. Esse comando deve estar entre aspas. Vários comandos podem ser separados por ponto e vírgula. (Se você tiver uma longa lista de comandos, pode ser mais fácil colocá-los em um script e, em seguida, usar a opção -c com o comando $<, $><, $><, $$>< (Executar Arquivo de Script ).

Se você estiver iniciando um cliente de depuração, esse comando deverá ser destinado ao servidor de depuração. Comandos específicos do cliente, como .lsrcpath, não são permitidos.

-cf "filename"
Especifica o caminho e o nome de um arquivo de script. Esse arquivo de script é executado assim que o depurador é iniciado. Se filename contiver espaços, ele deverá ser colocado entre aspas. Se o caminho for omitido, o diretório atual será assumido. Se a opção -cf não for usada, o arquivo ntsd.ini no diretório atual será usado como o arquivo de script. Se o arquivo não existir, nenhum erro ocorrerá. Para obter detalhes, consulte Usando arquivos de script.

-cfr "filename"
Especifica o caminho e o nome de um arquivo de script. Esse arquivo de script é executado assim que o depurador é iniciado e sempre que o destino é reiniciado. Se filename contiver espaços, ele deverá ser colocado entre aspas. Se o caminho for omitido, o diretório atual será assumido. Se o arquivo não existir, nenhum erro ocorrerá. Para obter detalhes, consulte Usando arquivos de script.

Linhas -clines
Define o número aproximado de comandos no histórico de comandos que podem ser acessados durante a depuração remota. Para obter detalhes e outras maneiras de alterar esse número, consulte Usando comandos do depurador.

-d
Após uma reinicialização, o depurador entrará no computador de destino assim que um módulo de kernel for carregado. (Essa quebra é anterior à quebra da opção -b.) Consulte Falha e reinicialização do computador de destino para obter detalhes e para obter outros métodos de alteração desse status.

-ee {masm|c++}
Define o avaliador de expressão padrão. Se masm for especificado, a sintaxe da expressão MASM será usada. Se c++ for especificado, a sintaxe de expressão C++ será usada. Se a opção -ee for omitida, a sintaxe da expressão MASM será usada como padrão. Consulte Avaliando expressões para obter detalhes.

-failinc
Faz com que o depurador ignore todos os símbolos questionáveis. Ao depurar um arquivo de minidump no modo de usuário ou kernel, essa opção também impedirá que o depurador carregue todos os módulos cujas imagens não podem ser mapeadas. Para obter detalhes e outros métodos de controle, consulte SYMOPT_EXACT_SYMBOLS.

-iImagePath
Especifica o local dos executáveis que geraram a falha. Se o caminho contiver espaços, ele deverá ser colocado entre aspas.

-iuKeyString
Registra a comunicação remota do depurador como um tipo de URL para que os usuários possam iniciar automaticamente um cliente remoto do depurador com uma URL. KeyString tem o formato remdbgeng://RemotingOption. RemotingOption é uma cadeia de caracteres que define o protocolo de transporte conforme definido no tópico Ativando um cliente de depuração. Se essa ação for bem-sucedida, nenhuma mensagem será exibida; se falhar, uma mensagem de erro será exibida.

O parâmetro -iu não deve ser usado com nenhum outro parâmetro. Esse comando não iniciará o KD.

-kConnectType
Informa ao depurador como se conectar ao destino. Para obter detalhes, confira Depuração usando KD e NTKD.

-Kl
Inicia uma sessão de depuração de kernel no mesmo computador que o depurador.

-kqm
Inicia o KD no modo silencioso.

-kxExdiOptions
Inicia uma sessão de depuração de kernel usando um driver EXDI. Os drivers EXDI não são descritos nesta documentação. Se você tiver uma interface EXDI para sua investigação de hardware ou simulador de hardware, entre em contato com a Microsoft para obter informações de depuração.

-Linhas
Habilita a depuração de linha de origem. Se essa opção for omitida, o comando .lines (Alternar Suporte à Linha de Origem) precisará ser usado antes que a depuração de origem seja permitida. Para outros métodos de controle, consulte SYMOPT_LOAD_LINES.

-log{a|au|o|ou} LogFile
Começa a registrar informações em log em um arquivo de log. Se LogFile já existir, ele será substituído se -logo for usado ou a saída será acrescentada ao arquivo se -loga for usado. As opções -logau e -logou operam semelhantes a -loga e -logo , respectivamente, exceto que o arquivo de log é um arquivo Unicode. Para obter mais detalhes, consulte Mantendo um arquivo de log em KD.

-M
Indica que a porta serial está conectada a um modem. Instrui o depurador a watch para o sinal de detecção da operadora.

-Myob
Se houver uma incompatibilidade de versão com dbghelp.dll, o depurador continuará a ser executado. (Sem a opção -myob , isso é considerado um erro fatal.)

Um efeito secundário dessa opção é que o aviso que normalmente aparece ao invadir o computador de destino é suprimido.

-N
Carga de símbolo barulhento: habilita a saída detalhada do manipulador de símbolos. Para obter detalhes e outros métodos de controle, consulte SYMOPT_DEBUG.

-noio
Impede que o servidor de depuração seja usado para entrada ou saída. A entrada só será aceita do cliente de depuração (além de qualquer comando inicial ou script de comando especificado pela opção de linha de comando -c ).

Toda a saída será direcionada para o cliente de depuração. Para obter mais detalhes, consulte Ativando um servidor de depuração.

-noshell
Proíbe todos os comandos .shell . Essa proibição durará enquanto o depurador estiver em execução, mesmo que uma nova sessão de depuração seja iniciada. Para obter detalhes e outras maneiras de desabilitar comandos de shell, consulte Usando comandos do Shell.

-QRServer
Lista todos os servidores de depuração em execução no servidor de rede especificado. A barra invertida dupla (\\) anterior ao Servidor é opcional. Consulte Pesquisar servidores de depuração para obter detalhes.

O parâmetro -QR não deve ser usado com nenhum outro parâmetro. Esse comando não iniciará o KD.

-R
Exibe registros.

-s
Desabilita o carregamento de símbolo lento. Isso reduzirá a inicialização do processo. Para obter detalhes e outros métodos de controle, consulte SYMOPT_DEFERRED_LOADS.

-sdce
Faz com que o depurador exiba as caixas de diálogo Erro de acesso ao arquivo durante a carga do símbolo. Para obter detalhes e outros métodos de controle, consulte SYMOPT_FAIL_CRITICAL_ERRORS.

-Seguro
Ativa o Modo Seguro.

-Ses
Faz com que o depurador execute uma avaliação estrita de todos os arquivos de símbolo e ignore todos os símbolos questionáveis. Para obter detalhes e outros métodos de controle, consulte SYMOPT_EXACT_SYMBOLS.

-sflags 0xNumber
Define todas as opções do manipulador de símbolos de uma só vez. Number deve ser um número hexadecimal prefixado com 0x – um decimal sem o 0x é permitido, mas as opções de símbolo são sinalizadores binários e, portanto, hexadecimal é recomendado. Essa opção deve ser usada com cuidado, pois substituirá todos os padrões do manipulador de símbolos. Para obter detalhes, consulte Configurando opções de símbolo.

-sicv
Faz com que o manipulador de símbolos ignore o registro CV. Para obter detalhes e outros métodos de controle, consulte SYMOPT_IGNORE_CVREC.

-Pecados
Faz com que o depurador ignore o caminho do símbolo e as variáveis de ambiente de caminho de imagem executável. Para obter detalhes, consulte SYMOPT_IGNORE_NT_SYMPATH.

-Snc
Faz com que o depurador desative a tradução do C++. Para obter detalhes e outros métodos de controle, consulte SYMOPT_NO_CPP.

-snul
Desabilita o carregamento automático de símbolos para nomes não qualificados. Para obter detalhes e outros métodos de controle, consulte SYMOPT_NO_UNQUALIFIED_LOADS.

-srcpathSourcePath
Especifica o caminho de pesquisa do arquivo de origem. Separe vários caminhos com um ponto e vírgula (;). Se o caminho contiver espaços, ele deverá ser colocado entre aspas. Para obter detalhes e outras maneiras de alterar esse caminho, consulte Caminho de origem.

-Sup
Faz com que o manipulador de símbolos pesquise a tabela de símbolos públicos durante cada pesquisa de símbolos. Para obter detalhes e outros métodos de controle, consulte SYMOPT_AUTO_PUBLICS.

-tPrintErrorLevel
Especifica o nível de erro que fará com que o depurador exiba uma mensagem de erro. Esse é um número decimal igual a 0, 1, 2 ou 3. Os valores são descritos da seguinte maneira:

Valor	Constante	Significado
0	Nenhuma	Não exiba nenhum erro.
1	ERROR	Exibir eventos de depuração no nível DE ERRO.
2	MINORERROR	Exibir eventos de depuração de nível MINORERROR e ERROR.
3	WARNING	Exibir eventos de depuração DE AVISO, MINORERROR e Nível de ERRO.

Esse nível de erro só tem significado em builds verificados do Microsoft Windows. O valor padrão é 1. Os builds verificados estavam disponíveis em versões mais antigas do Windows, antes de Windows 10 versão 1803.

-V
Gera mensagens detalhadas para cargas, cargas adiadas e descarregamentos.

-Versão
Imprime a cadeia de caracteres de versão do depurador.

-wakePID
Faz com que o modo de suspensão termine para o depurador do modo de usuário cuja ID de processo é especificada pelo PID. Esse comando deve ser emitido no computador de destino durante o modo de suspensão. Consulte Controling the User-Mode Debugger from the Kernel Debugger for details.

O parâmetro -wake não deve ser usado com nenhum outro parâmetro. Esse comando não iniciará o KD.

-X
Faz com que o depurador interrompa quando ocorre uma exceção pela primeira vez, em vez de permitir que o aplicativo ou módulo que causou a exceção lide com ele. (Igual a -b, exceto com um eb nt inicial! NtGlobalFlag 9; g command.)

-ySymbolPath
Especifica o caminho de pesquisa de símbolo. Separe vários caminhos com um ponto e vírgula (;). Se o caminho contiver espaços, ele deverá ser colocado entre aspas. Para obter detalhes e outras maneiras de alterar esse caminho, consulte Caminho do símbolo.

-zDumpFile
Especifica o nome de um arquivo de despejo de memória a ser depurado. Se o caminho e o nome do arquivo contiverem espaços, isso deverá estar entre aspas. É possível abrir vários arquivos de despejo ao mesmo tempo, incluindo várias opções -z , cada uma seguida por um valor de DumpFile diferente. Para obter detalhes, consulte Analisando um arquivo de despejo de Kernel-Mode com KD.

-zpPageFile
Especifica o nome de um arquivo de página modificado. Isso será útil se você estiver depurando um arquivo de despejo e quiser usar o comando .pagein (Página na Memória). Você não pode usar -zp com um arquivo de página padrão do Windows— somente arquivos de página especialmente modificados podem ser usados.

-?
Exibe o texto da ajuda da linha de comando.

O KD detectará automaticamente a plataforma na qual o destino está em execução. Você não precisa especificar o destino na linha de comando KD. A sintaxe mais antiga (usando o nome I386KD ou IA64KD) está obsoleta.