SOS.dll(SOS 디버깅 확장)

BPMD [-nofuturemodule] [<모듈 이름> <메서드 이름>] [-md <MethodDesc>] -list -clear <보류 중인 중단점 번호> -clearall

지정된 모듈의 지정된 메서드에 중단점을 만듭니다.

지정된 모듈 및 메서드가 로드되지 않은 경우 이 명령은 모듈이 로드되고 JIT(Just-In-Time) 컴파일되었다는 알림을 받을 때까지 기다렸다가 중단점을 만듭니다.

-list, -clear 및 -clearall 옵션을 사용하여 보류 중단점 목록을 관리할 수 있습니다.

• -list 옵션은 모든 보류 중인 중단점의 목록을 생성합니다. 보류 중인 중단점에 0이 아닌 모듈 ID가 있는 경우 해당 중단점은 로드된 특정 모듈의 함수에 적용됩니다. 보류 중인 중단점에 0인 모듈 ID가 있을 경우 해당 중단점은 아직 로드되지 않은 모듈에 적용됩니다.

• -clear 또는 -clearall 옵션을 사용하여 목록에서 보류 중단점을 제거합니다.

COMState

각 스레드의 COM 아파트 모델과 Context 포인터를 나열합니다(사용할 수 있는 경우).

DumpAssembly <assembly address>

어셈블리에 대한 정보를 표시합니다.

DumpAssembly 명령은 여러 개의 모듈(있는 경우)을 나열합니다.

DumpDomain 명령을 사용하여 어셈블리 주소를 가져올 수 있습니다.

DumpDomain [<domain address>]

지정된 Assembly 개체 주소 내에 로드된 각 AppDomain 개체를 열거합니다. 매개 변수 없이 호출된 경우 DumpDomain 명령은 프로세스의 모든 AppDomain 개체를 나열합니다.

DumpIL <Managed DynamicMethod object> | <DynamicMethodDesc pointer> | <MethodDesc pointer>

관리되는 메서드와 연관된 MSIL(Microsoft intermediate language)을 표시합니다.

동적 MSIL은 어셈블리에서 로드된 MSIL과는 다르게 내보내집니다. 동적 MSIL은 메타데이터 토큰 대신 관리되는 개체 배열의 개체를 참조합니다.

DumpMD <MethodDesc address>

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

IP2MD 명령을 사용하여 관리되는 함수에서 MethodDesc 구조체 주소를 가져올 수 있습니다.

DumpMethodSig <sigaddr> <moduleaddr>

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

DumpObj [-nofields] <object address>

또는

DO <object address>

지정된 주소의 개체에 대한 정보를 표시합니다. DumpObj 명령은 필드, EEClass 구조체 정보, 메서드 테이블 및 개체 크기를 표시합니다.

DumpStackObjects 명령을 사용하여 개체의 주소를 검색할 수 있습니다.

CLASS 형식의 필드도 개체이므로 이러한 필드에 대해 DumpObj 명령을 실행할 수 있습니다.

-nofields 옵션은 개체의 필드가 표시되는 것을 방지하고 문자열 같은 개체에 유용합니다.

DumpStack [-EE] [-n] [top stack [bottom stack]]

스택 추적을 표시합니다.

• -EE 옵션을 사용하면 DumpStack 명령은 관리되는 함수만 표시합니다. x86 플랫폼에 표시되는 스택 프레임을 제한하려면 top 및 bottom 매개 변수를 사용합니다.

• -n 옵션은 소스 파일 이름과 줄 번호의 표시를 사용하지 않습니다. 디버거에 옵션 SYMOPT_LOAD_LINES가 지정된 경우 SOS는 관리되는 모든 프레임에 대한 기호가 조회하고, 성공한 경우, 해당 소스 파일 이름과 줄 번호를 표시합니다. -n (줄 번호 없음) 매개 변수는 이 동작을 사용하지 않도록 지정할 수 있습니다.

x86 및 x64 플랫폼에서 DumpStack 명령은 자세한 스택 추적을 만듭니다.

IA-64 기반 플랫폼에서 DumpStack 명령은 디버거의 K 명령과 비슷하게 동작합니다. top 및 bottom매개 변수는 IA-64 기반 플랫폼에서 무시됩니다.

DumpSigElem <sigaddr> <moduleaddr>

서명 개체의 단일 요소를 표시합니다. 대부분의 경우 개별 서명 개체를 찾는 데 DumpSig를 사용해야 합니다. 그러나 어떤 식으로든 서명이 손상된 경우 DumpSigElem을 사용하여 유효한 부분을 읽을 수 있습니다.

DumpVC <MethodTable address> <Address>

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

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

EEStack [-short] [-EE]

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

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

• 잠긴 스레드

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

• 현재 관리 코드에 있는 스레드

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

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

FinalizeQueue [-detail] | [-allReady] [-short]

종료하도록 등록된 모든 개체를 표시합니다.

• -detail 옵션은 정리해야 하는 모든 SyncBlocks와 정리를 기다리는 RCW(RuntimeCallableWrappers)에 대한 추가 정보를 표시합니다. 이러한 두 데이터 구조는 실행할 때 모두 종료자 스레드에서 캐시되고 정리됩니다.

• -allReady 옵션은 가비지 컬렉션에 의해 이미 표시되거나 다음 가비지 컬렉션에 의해 표시될지 여부에 관계 없이 종료할 준비가 된 모든 개체를 표시합니다. "종료 준비" 목록에 없는 개체는 더 이상 루트에 있지 않은 종료할 수 있는 개체입니다. 종료 가능한 큐에 있는 모든 개체가 여전히 루트인지 여부를 확인하기 때문에 이 옵션은 매우 비용이 많이 들 수 있습니다.

• -short 옵션은 각 개체의 주소로 출력을 제한합니다. -allReady와 함께 사용할 경우 더 이상 루트가 아닌 종료자가 있는 모든 개체를 열거합니다. 독립적으로 사용되는 경우 종료 가능 및 "종료 준비" 큐에 모든 개체를 나열합니다.

FindRoots -gen <N> | -gen any |<개체 주소>

디버거가 지정된 생성의 다음 수집에서 디버기를 중단하도록 합니다. 효과는 중단이 발생하는 즉시 다시 설정됩니다. 다음 컬렉션에서 중단하려면 명령을 다시 실행해야 합니다. 이 명령의 <object address> 폼은 -gen 또는 -gen any에 의해 초래된 중단이 발생한 후에 사용됩니다. 그 당시 디버기가 현재 문제가 되는 생성에서 개체에 대한 루트를 식별하기 위한 FindRoots의 올바른 상태에 있습니다.

GCHandleLeaks

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

GCRoot [-nostacks] <Object address>

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

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

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

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

help [<command>] [faq]

매개 변수가 지정되지 않은 경우 사용할 수 있는 모든 명령을 표시하거나, 지정된 명령에 대한 자세한 도움말 정보를 표시합니다.

faq 매개 변수는 질문과 대답을 표시합니다.

HistClear

Hist 명령의 패밀리에서 사용하는 모든 리소스를 해제합니다.

일반적으로 각 HistInit이 이전 리소스를 정리하기 때문에 HistClear를 명시적으로 호출할 필요가 없습니다.

HistObj <obj_address>

모든 스트레스 로그 재배치 레코드를 검사하여 인수로 전달된 주소로 연결될 수 있는 가비지 수집 재배치의 체인을 표시합니다.

HistRoot <root>

지정된 루트의 승격 및 재배치와 관련된 정보를 표시합니다.

루트 값은 가비지 수집을 통해 개체의 움직임을 추적하는 데 사용할 수 있습니다.

ListNearObj (lno) <obj_address>

지정된 주소의 앞 및 다음 개체를 표시합니다. 명령은 관리되는 개체(유효한 메서드 테이블을 기준으로 함)와 인수 주소 다음에 있는 개체의 유효한 시작처럼 보이는 가비지 수집 힙에서 주소를 찾습니다.

Name2EE <module name> <type or method name>

또는

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

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

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

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

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

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

또는

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

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

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

• -lines 옵션은 사용할 수 있는 경우 소스 정보를 표시합니다.

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

RCWCleanupList <RCWCleanupList address>

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

SOSFlush

내부 SOS 캐시를 플러시합니다.

SyncBlk [-all | <syncblk number>]

지정된 SyncBlock 구조체나 모든 SyncBlock 구조체를 표시합니다. 인수를 전달하지 않으면 SyncBlk 명령은 스레드에서 소유하는 개체에 해당하는 SyncBlock 구조체를 표시합니다.

SyncBlock 구조체는 모든 개체에 대해 만들 필요는 없는 추가 정보를 포함하기 위한 컨테이너입니다. 이 구조체는 COM interop 데이터, 해시 코드 및 스레드로부터 안전한 작업에 대한 잠금 정보를 포함할 수 있습니다.

Token2EE <module name> <token>

지정된 모듈의 지정된 메타데이터 토큰을 MethodTable 구조체나 MethodDesc 구조체로 전환합니다.

module name 매개 변수에 *를 전달하면 로드된 모든 관리되는 모듈에서 해당 토큰이 매핑되는 대상을 확인할 수 있습니다. mscorlib 또는 image00400000과 같이 모듈의 디버거 이름을 전달할 수도 있습니다.

ThreadState <상태 값 필드>

스레드의 현재 상태를 표시합니다. value 매개 변수는 Threads 보고서 출력에 있는 State 필드의 값입니다.

예를 들면 와 같은 형식입니다.

    0:003> !Threads
    ThreadCount:      2
    UnstartedThread:  0
    BackgroundThread: 1
    PendingThread:    0
    DeadThread:       0
    Hosted Runtime:   no
                                          PreEmptive   GC Alloc           Lock
           ID OSID ThreadOBJ    State     GC       Context       Domain   Count APT Exception
       0    1  250 0019b068      a020 Disabled 02349668:02349fe8 0015def0     0 MTA
       2    2  944 001a6020      b220 Enabled  00000000:00000000 0015def0     0 MTA (Finalizer)
    0:003> !ThreadState b220
        Legal to Join
        Background
        CLR Owns
        CoInitialized
        In Multi Threaded Apartment

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

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

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

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

• -n 옵션은 소스 파일 이름과 줄 번호의 표시를 사용하지 않습니다. 디버거에 옵션 SYMOPT_LOAD_LINES가 지정된 경우 SOS는 관리되는 모든 프레임에 대한 기호가 조회하고, 성공한 경우, 해당 소스 파일 이름과 줄 번호를 표시합니다. 이 동작을 비활성화하는 -n 옵션을 지정할 수 있습니다.

VerifyObj <object address>

기호 손상에 대한 인수로 전달되는 개체를 검사합니다.

VMStat

가상 주소 공간의 요약 뷰를 제공합니다. 이 뷰에서는 해당 메모리에 적용된 각 보호 형식(사용 가능, 예약됨, 커밋됨, 전용, 매핑됨, 이미지)별로 정렬됩니다. TOTAL 열에는 AVERAGE 열에 BLK COUNT 열을 곱한 결과가 표시됩니다.