Compartilhar via


Opções de linha de comando do 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 -?

Seguem-se descrições das opções de linha de comando do KD. Somente as opções -remote e -server diferenciam maiúsculas de minúsculas. O hífen inicial pode ser substituído por uma barra (/). Opções que não recebem nenhum parâmetro adicional podem ser concatenadas - então kd -r -n -v pode ser escrito 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

-servidor Transporte de servidor
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 o primeiro parâmetro na linha de comando.

-remoto Transporte de cliente
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 de ClientTransport , consulte Ativando um cliente de depuração. Quando esse parâmetro é usado, ele deve ser o primeiro parâmetro na linha de comando.

-um Extensão
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 definir esse padrão, consulte Carregando DLLs de extensão do depurador.

-b
Esta opção não é mais suportada.

-bonc
Se essa opção for especificada, o depurador entrará 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 atualmente dividido no destino.

-c "comando"
Especifica o comando inicial do depurador a ser executado na inicialização. Esse comando deve ser colocado entre aspas. Vários comandos podem ser separados por ponto-e-vírgula. (Se você tiver uma lista de comandos longa, 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 "nome do arquivo"
Especifica o caminho e o nome de um arquivo de script. Esse arquivo de script é executado assim que o depurador é iniciado. Se o nome do arquivo 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 "nome do arquivo"
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 o nome do arquivo 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.

-Clines Linhas
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 Travando e reinicializando o computador de destino para obter detalhes e 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 da 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.

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

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

-Ui Sequência de chaves
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. Este comando não iniciará o KD.

-k Tipo de conexão
Informa ao depurador como se conectar ao destino. Para obter detalhes, consulte 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.

-kx Opções Exdié
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 sonda de hardware ou simulador de hardware, entre em contato com a Microsoft para obter informações de depuração.

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

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

-m
Indica que a porta serial está conectada a um modem. Instrui o depurador a observar o sinal de detecção de portadora.

-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
Carregamento de símbolo ruidoso: Habilita a saída detalhada do manipulador de símbolos. Para obter detalhes e outros métodos de controle disso, 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 shell, consulte Usando comandos shell.

-QR Servidor
Lista todos os servidores de depuração em execução no servidor de rede especificado. A barra invertida dupla (\\) que precede o servidor é opcional. Consulte Pesquisando servidores de depuração para obter detalhes.

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

-r
Exibe registros.

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

-sdce
Faz com que o depurador exiba caixas de diálogo de erro de acesso a arquivos durante o carregamento do símbolo. Para obter detalhes e outros métodos de controle disso, 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 quaisquer símbolos questionáveis. Para obter detalhes e outros métodos de controle disso, consulte SYMOPT_EXACT_SYMBOLS.

-bandeiras 0xNúmero
Define todas as opções do manipulador de símbolos de uma só vez. O número 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 de CV. Para obter detalhes e outros métodos de controle disso, consulte SYMOPT_IGNORE_CVREC.

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

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

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

-srcpath Caminho de origem
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 disso, consulte SYMOPT_AUTO_PUBLICS.

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

Valor Constante Significado

0

NONE

Não exiba nenhum erro.

1

ERROR

Exibir eventos de depuração de nível ERROR.

2

ERRO MENOR

Exibir eventos de depuração de nível MINORERROR e ERROR.

3

WARNING

Exiba eventos de depuração de nível WARNING, MINORERROR e ERROR.

Esse nível de erro só tem significado em compilações verificadas do Microsoft Windows. O valor padrão é 1. As compilações verificadas estavam disponíveis em versões anteriores do Windows, antes do Windows 10, versão 1803.

-v
Gera mensagens detalhadas para cargas, cargas adiadas e descargas.

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

-acordar PID
Faz com que o modo de suspensão termine para o depurador do modo de usuário cuja ID do processo é especificada pelo PID. Esse comando deve ser emitido na máquina de destino durante o modo de suspensão. Consulte Controlar o depurador de modo de usuário do depurador de kernel para obter mais informações.

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

-x
Faz com que o depurador seja interrompido quando uma exceção ocorre pela primeira vez, em vez de permitir que o aplicativo ou módulo que causou a exceção lide com ela. (O mesmo que -b, exceto com um eb nt inicial ! Bandeira NtGlobal: 9; g .)

-y Caminho do símbolo
Especifica o caminho de pesquisa do 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.

-z Dumpfile
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á ser colocado entre aspas. É possível abrir vários arquivos de despejo de uma só vez, incluindo várias opções -z, cada uma seguida por um valor DumpFile diferente. Para obter detalhes, consulte Analisando um arquivo de despejo no modo kernel com KD.

-zp Arquivo de paginação
Especifica o nome de um arquivo de paginação modificado. Isso é ú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 paginação padrão do Windows — somente arquivos de paginação especialmente modificados podem ser usados.

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

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