KD를 사용한 라이브 커널 모드 디버깅

명령 프롬프트 창에서 KD를 시작할 때 라이브 커널 모드 디버깅 세션을 시작할 수 있습니다. 다음 명령 중 하나를 입력합니다.

kd [-y SymbolPath] -k net:port=PortNumber,key=Key[,target=TargetIPAddress|TargetHostName]

kd [-y SymbolPath] -k usb:targetname=USBString

kd [-y SymbolPath] -k com:port=ComPort,baud=BaudRate

kd [-y SymbolPath] -k com:ipport=SerialTcpIpPort,port=SerialIPAddress

kd [-y SymbolPath] -k com:pipe,port=\\VMHost\pipe\PipeName[,resets=0][,reconnect]

kd [-y SymbolPath] -k com:modem

kd [-y SymbolPath] -kl

kd [-y SymbolPath] -k

자세한 내용은 KD 명령줄 옵션을 참조 하세요.

환경 변수

직렬(COM 포트) 연결을 통해 디버깅하는 경우 환경 변수를 사용하여 연결 설정을 지정할 수 있습니다.

다음 변수를 사용하여 직렬 연결을 지정합니다.

set _NT_DEBUG_PORT = ComPort

set _NT_DEBUG_BAUD_RATE = BaudRate

자세한 내용은 커널 모드 환경 변수를 참조 하세요.

매개 변수

SymbolPath
기호 파일이 있는 디렉터리 목록입니다. 목록의 디렉터리를 세미콜론으로 구분합니다. 자세한 내용은 기호 경로를 참조 하세요.

PortNumber
네트워크 디버깅에 사용할 포트 번호입니다. 49152에서 65535까지의 숫자를 선택할 수 있습니다. 자세한 내용은 수동으로 네트워크 연결 설정을 참조 하세요.

열쇠
네트워크 디버깅에 사용할 암호화 키입니다. 대상 컴퓨터를 구성할 때 bcdedit에서 제공하는 자동으로 생성된 키를 사용하는 것이 좋습니다. 자세한 내용은 수동으로 네트워크 연결 설정을 참조 하세요.

TargetIPAddress
대상 컴퓨터의 IPv4 주소입니다.

대상= IP 주소를 지정하면 디버거가 대상에 특수 패킷을 전송하여 지정된 대상 머신에 대한 연결을 시작합니다. 그러면 디버거가 해당 디버거와 연결을 시도하게 됩니다. 디버거는 약 반초마다 반복적으로 대상에 패킷을 보내 연결을 시도합니다. 연결에 성공하면 대상은 기존 연결을 삭제하고 디버거의 이 인스턴스와만 통신합니다. 이렇게 하면 기존 디버깅 연결에서 디버깅 세션을 제어할 수 있습니다.

대상이 호스트 IP 주소로 구성되고 구성된 호스트 IP 주소를 사용하여 컴퓨터에서 디버거를 실행하는 경우 대상= IP 주소 매개 변수를 지정할 필요가 없습니다. 대상이 호스트 IP 주소로 구성된 경우 3초마다 호스트에 OFFER 패킷을 보냅니다. 대상= IP 주소가 지정되지 않은 경우 OFFER 패킷을 사용하면 디버거가 호스트에 연결할 수 있습니다.

대상 에서 호스트 IP 주소를 구성하는 방법에 대한 자세한 내용은 KDNET 네트워크 커널 디버깅 자동 설정 및 KDNET 네트워크 커널 디버깅 수동 설정을 참조하세요.

TargetMachineName
대상 PC의 컴퓨터 이름입니다. 컴퓨터 이름을 사용하려면 네트워크의 DNS 시스템에 대상 PC의 IP 주소와 연결된 컴퓨터 이름이 있어야 합니다.

USBString
USB 연결 문자열. /targetname 부팅 옵션으로 지정된 문자열과 일치해야 합니다. 자세한 내용은 USB 3.0 xHCI-DBC 커널 모드 디버깅(KDUSB) 설정을 참조하세요.

ComPort
COM 포트의 이름입니다. 이 형식은 "com2" 형식이거나 "\\.\com2" 형식일 수 있지만 단순히 숫자가 아니어야 합니다. 자세한 내용은 수동으로 직렬 연결 설정을 참조 하세요.

BaudRate
전송 속도입니다. 9600, 19200, 38400, 57600 또는 115200일 수 있습니다.

VMHost
가상 머신 을 디버깅할 때 VMHost 는 가상 머신이 실행 중인 실제 컴퓨터의 이름을 지정합니다. 가상 머신이 커널 디버거 자체와 동일한 컴퓨터에서 실행되는 경우 VMHost에 단일 기간(.)을 사용합니다. 자세한 내용은 Virtual Machine에 대한 연결 설정을 참조 하세요.

PipeName
디버깅 연결을 위해 가상 머신에서 만든 파이프의 이름입니다.

resets=0
호스트와 대상이 동기화될 때 대상에 무제한으로 재설정 패킷을 보낼 수 있도록 지정합니다. 이 매개 변수는 특정 종류의 가상 머신을 디버깅할 때만 필요합니다.

다시
읽기/쓰기 오류가 발생할 경우 디버거가 파이프의 연결을 자동으로 끊고 다시 연결하도록 합니다. 또한 디버거가 시작될 때 명명된 파이프를 찾을 수 없는 경우 다시 연결 매개 변수로 인해 이 이름의 파이프가 나타날 때까지 기다립니다. 이 매개 변수는 특정 종류의 가상 머신을 디버깅할 때만 필요합니다.

-Kl 기
디버거가 로컬 커널 모드 디버깅을 수행하도록 합니다. 자세한 내용은 로컬 커널 모드 디버깅을 참조 하세요.

SerialTcpIpPort
에뮬레이트된 직렬 COM 포트의 대상 TCP IP 포트입니다.

SerialIPAddress
에뮬레이트된 직렬 COM 포트의 대상 TCP IP 주소입니다.

예

다음 일괄 처리 파일을 사용하여 COM 포트 연결을 통해 디버깅 세션을 설정하고 시작할 수 있습니다.

set _NT_SYMBOL_PATH=d:\mysymbols
set _NT_DEBUG_PORT=com1
set _NT_DEBUG_BAUD_RATE=115200
set _NT_DEBUG_LOG_FILE_OPEN=d:\debuggers\logfile1.log
kd

다음 명령줄을 사용하여 환경 변수 없이 WinDbg를 시작할 수 있습니다.

kd -y d:\mysymbols -k com:port=com2,baud=57600

kd -y d:\mysymbols -k com:port=\\.\com2,baud=115200

kd -y d:\mysymbols -k net:port=50000,key=AutoGeneratedKey