SOS 디버깅 확장(SOS.dll)

CLRStack [-a] [-l] [-p]

관리 코드의 스택 추적만 제공합니다.

-p 옵션은 관리되는 함수의 인수를 표시합니다.

-l 옵션은 지역 변수에 대한 정보를 프레임에 표시합니다. SOS 디버깅 확장에서는 로컬 이름을 검색할 수 없으므로 로컬 이름의 출력은 <local address> = <value> 형식입니다.

-a(모두) 옵션은 -l 옵션과 -p 옵션을 동시에 지정하는 옵션입니다.

SOS 디버깅 확장에서는 x64 및 IA-64 기반 플랫폼에 전환 프레임을 표시하지 않습니다.

DumpArray [-start <startIndex>] [-length <length>] [-details] [-nofields] <array object address>

- 또는 -

DA [-start <startIndex>] [-length <length>] [-detail] [-nofields] array object address>

배열 개체의 요소를 검사합니다.

-start 옵션은 요소를 표시할 위치의 시작 인덱스를 지정합니다.

-length 옵션은 표시할 요소 수를 지정합니다.

-detail 옵션은 DumpObj 및 DumpVC 형식을 사용하여 요소의 세부 사항을 표시합니다.

-nofields 옵션은 배열이 표시되지 않도록 합니다. 이 옵션은 -detail 옵션을 지정한 경우에만 사용할 수 있습니다.

DumpClass <EEClass address>

형식과 연관된 EEClass 구조체에 대한 정보를 표시합니다.

DumpClass 명령은 정적 필드 값만 표시하고 비정적 필드 값은 표시하지 않습니다.

EEClass 구조체 주소를 가져오려면 DumpMT, DumpObj, Name2EE 또는 Token2EE 명령을 사용합니다.

DumpHeap [-stat] [-min <size>][-max <size>] [-thinlock] [-mt <MethodTable address>] [-type <partial type name>][start [end]]

가비지 수집된 힙에 대한 정보와 개체에 대한 컬렉션 통계를 표시합니다.

DumpHeap 명령은 가비지 수집기 힙에서 과도한 단편화가 감지될 경우 경고를 표시합니다.

-stat 옵션은 출력을 통계 형식 요약으로 제한합니다.

-min 옵션은 바이트로 지정된 size 매개 변수보다 작은 개체를 무시합니다.

-max 옵션은 바이트로 지정된 size 매개 변수보다 큰 개체를 무시합니다.

-thinlock 옵션은 ThinLocks를 보고합니다. 자세한 내용은 SyncBlk 명령을 참조하십시오.

-mt 옵션은 지정된 MethodTable 구조체에 해당하는 개체만 나열합니다.

-type 옵션은 형식 이름이 지정된 문자열의 부분 문자열에 해당하는 개체만 나열합니다.

start 매개 변수는 지정된 주소부터 나열을 시작합니다.

end 매개 변수는 지정된 주소에서 나열을 중지합니다.

DumpLog [<Filename>]

메모리 내 스트레스 로그의 내용을 지정된 파일에 씁니다. 이름을 지정하지 않으면 이 명령은 현재 디렉터리에 Stresslog.txt라는 파일을 만듭니다.

공용 언어 런타임에서는 스트레스 오류를 진단하는 데 유용한 메모리 내 스트레스 로그를 제공합니다. 이 로그를 사용하면 잠금이나 I/O를 사용하지 않고도 오류를 진단할 수 있습니다. 스트레스 로그를 사용하도록 설정하려면 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework 아래의 다음 레지스트리 키를 설정합니다.

(DWORD) StressLog = 1

(DWORD) LogFacility = 0xffffffff

(DWORD) StressLogSize = 65536

DumpMT [-MD] <MethodTable address>

지정된 주소의 메서드 테이블에 대한 정보를 표시합니다. -MD 옵션을 지정하면 개체와 함께 정의된 모든 메서드의 목록이 표시됩니다.

관리되는 각 개체에는 메서드 테이블 포인터가 들어 있습니다.

DumpModule [-mt] <Module address>

지정된 주소의 모듈에 대한 정보를 표시합니다. -mt 옵션은 모듈에 정의된 형식과 모듈에서 참조하는 형식을 표시합니다.

DumpDomain 또는 DumpAssembly 명령을 사용하여 모듈의 주소를 검색할 수 있습니다.

DumpRuntimeTypes

가비지 수집기 힙에 있는 런타임 형식 개체를 표시하고 해당 개체에 연관된 형식 이름과 메서드 테이블을 나열합니다.

DumpSig <sigaddr> <moduleaddr>

지정된 주소의 Sig 구조체에 대한 정보를 표시합니다.

DumpVC <MethodTable address> <Address>

지정된 주소에 있는 값 클래스의 필드에 대한 정보를 표시합니다.

MethodTable 매개 변수를 사용하면 DumpVC 명령은 필드를 올바르게 해석할 수 있습니다. 값 클래스에는 첫 번째 필드로 메서드 테이블이 포함되지 않습니다.

EEStack [-short] [-EE]

프로세스의 모든 스레드에 대해 DumpStack 명령을 실행합니다.

-EE 옵션은 DumpStack 명령에 직접 전달됩니다. -short 매개 변수는 출력을 다음과 같은 종류의 스레드로 제한합니다.

1. 잠긴 스레드

2. 가비지 수집을 위해 중단된 스레드

3. 현재 관리 코드에 있는 스레드

EHInfo [<MethodDesc address>] [<Code address>]

지정된 메서드의 예외 처리 블록을 표시합니다. 이 명령은 절 블록(try 블록) 및 처리기 블록(catch 블록)의 코드 주소와 오프셋을 표시합니다.

FindAppDomain <Object address>

지정된 주소에 있는 개체의 응용 프로그램 도메인을 확인합니다.

GCHandleLeaks

메모리에서 프로세스의 강력하고 고정된 가비지 수집기 핸들에 대한 참조를 검색하여 결과를 표시합니다. 핸들이 있으면 GCHandleLeaks 명령은 참조의 주소를 표시합니다. 메모리에 핸들이 없으면 이 명령은 알림을 표시합니다.

GCRoot [-nostacks] <Object address>

지정된 주소의 개체에 대한 참조(또는 루트)와 관련된 정보를 표시합니다.

GCRoot 명령은 다른 개체 내의 핸들과 스택의 핸들에 대한 핸들 테이블 및 관리되는 전체 힙을 검사합니다. 그런 다음 각 스택에서 개체에 대한 포인터를 검색하고 종료자 큐도 검색합니다.

이 명령은 스택 루트가 유효하거나 삭제되었는지는 확인하지 않습니다. 스택 루트가 여전히 사용 중인지 여부를 확인하기 위해 로컬 또는 인수 값이 속해 있는 프레임을 디스어셈블하려면 CLRStack 및 U 명령을 사용합니다.

-nostacks 옵션은 검색을 가비지 수집기 핸들 및 종료-연결(freachable) 개체로 제한합니다.

IP2MD <Code address>

JIT(Just-In-Time) 컴파일된 코드의 지정된 주소에 있는 MethodDesc 구조체를 표시합니다.

Name2EE <module name> <type or method name>

- 또는 -

Name2EE <module name>!<type or method name>

지정된 모듈에 있는 지정된 형식 또는 메서드의 MethodTable 구조체와 EEClass 구조체를 표시합니다.

지정된 모듈은 프로세스에 로드되어 있어야 합니다.

올바른 형식 이름을 가져오려면 MSIL 디스어셈블러(Ildasm.exe)를 사용하여 모듈을 찾습니다. *를 module name 매개 변수로 전달하여 로드된 모든 관리되는 모듈을 검색할 수도 있습니다. module name 매개 변수는 mscorlib 또는 image00400000과 같이 모듈의 디버거 이름일 수도 있습니다.

이 명령은 Windows 디버거 구문인 <module>!<type>을 지원합니다. 해당 형식은 정규화된 형식이어야 합니다.

PrintException [-nested] [<Exception object address>]

- 또는 -

PE [-nested] [<Exception object address>]

지정된 주소의 Exception 클래스에서 파생된 개체 필드를 표시하고 필드의 형식을 지정합니다. 주소를 지정하지 않으면 PrintException 명령은 현재 스레드에서 마지막으로 throw된 예외를 표시합니다.

-nested 옵션은 중첩된 예외 개체에 대한 자세한 정보를 표시합니다.

이 명령을 사용하여 이진 배열인 _stackTrace 필드의 형식을 지정하고 해당 필드를 볼 수 있습니다.

RCWCleanupList <RCWCleanupList address>

지정된 주소에서 정리를 기다리는 런타임 호출 가능 래퍼의 목록을 표시합니다.

StopOnException [-derived] [-create | -create2] <Exception> <Pseudo-register number>

지정된 예외가 throw되면 디버거가 중지되고 다른 예외가 throw되면 계속 실행되도록 합니다.

-derived 옵션은 지정된 예외와 지정된 예외에서 파생되는 모든 예외를 catch합니다.

ThreadPool

큐에 대기 중인 작업 요청 수, 완료 포트 스레드 수 및 타이머 수를 비롯하여 관리되는 스레드 풀에 대한 정보를 표시합니다.

Threads [-live] [-special]

프로세스의 관리되는 모든 스레드를 표시합니다.

Threads 명령은 디버거 약식 ID, 공용 언어 런타임 스레드 ID 및 운영 체제 스레드 ID를 표시합니다. 또한 Threads 명령은 스레드가 실행되고 있는 응용 프로그램 도메인을 나타내는 Domain 열, COM 아파트 모드가 표시되는 APT 열 및 해당 스레드에서 마지막으로 throw된 예외가 표시되는 Exception 열을 표시합니다.

-live 옵션은 라이브 스레드와 연관된 스레드를 표시합니다.

-special 옵션은 CLR에서 만들어진 모든 특수 스레드를 표시합니다. 특수 스레드에는 동시 GC(가비지 수집) 및 서버 GC의 GC 스레드, Debugger 도우미 스레드, Finalizer 스레드, AppDomain Unload 스레드 및 Threadpool 타이머 스레드가 포함됩니다.

U [-gcinfo] [-ehinfo] <MethodDesc address> | <Code address>

메서드의 MethodDesc 구조체 포인터나 메서드 본문 내의 코드 주소로 지정된 관리되는 메서드에 대해 주석이 지정된 디스어셈블리를 표시합니다. U 명령은 메서드를 처음부터 끝까지 모두 표시하고 메타데이터 토큰을 이름으로 변환하는 주석을 함께 표시합니다.

-gcinfo 옵션을 사용하면 U 명령은 메서드의 GCInfo 구조체를 표시합니다.

-ehinfo 옵션은 메서드에 대한 예외 정보를 표시합니다. EHInfo 명령을 사용하여 이 정보를 볼 수도 있습니다.

VMMap

가상 주소 공간으로 이동하여 각 영역에 적용된 보호 형식을 표시합니다.