Ildasm.exe(IL 디스어셈블러)Ildasm.exe (IL Disassembler)

IL 디스어셈블러는 IL 어셈블러(Ilasm.exe)의 자매 도구입니다.The IL Disassembler is a companion tool to the IL Assembler (Ilasm.exe). Ildasm.exe는 IL(intermediate language) 코드가 포함된 PE(이식 가능한 실행) 파일을 가져와서 Ildasm.exe에 입력하기에 적합한 텍스트 파일을 만듭니다.Ildasm.exe takes a portable executable (PE) file that contains intermediate language (IL) code and creates a text file suitable as input to Ilasm.exe.

이 도구는 자동으로 Visual Studio와 함께 설치됩니다.This tool is automatically installed with Visual Studio. 이 도구를 실행하려면 Visual Studio용 개발자 명령 프롬프트(또는 Windows 7의 Visual Studio 명령 프롬프트)를 사용합니다.To run the tool, use the Developer Command Prompt for Visual Studio (or the Visual Studio Command Prompt in Windows 7). 자세한 내용은 명령 프롬프트를 참조하세요.For more information, see Command Prompts.

명령 프롬프트에 다음을 입력합니다.At the command prompt, type the following:

구문Syntax

ildasm [options] [PEfilename] [options]

매개 변수Parameters

.exe, .dll, .obj, .lib.winmd 파일에 사용할 수 있는 옵션은 다음과 같습니다.The following options are available for .exe, .dll, .obj, .lib, and .winmd files.

옵션Option 설명Description
/out= filename/out= filename 결과를 그래픽 사용자 인터페이스에 표시하지 않고 지정된 filename을 사용하여 출력 파일을 만듭니다.Creates an output file with the specified filename, rather than displaying the results in a graphical user interface.
/rtf/rtf 서식 있는 텍스트로 출력을 생성합니다.Produces output in rich text format. /text 옵션과 함께 사용할 수 없습니다.Invalid with the /text option.
/text/text 결과를 그래픽 사용자 인터페이스에 표시하거나 출력 파일로 표시하지 않고 콘솔 창에 표시합니다.Displays the results to the console window, rather than in a graphical user interface or as an output file.
/html/html HTML 형식으로 출력을 생성합니다.Produces output in HTML format. /output 옵션으로만 사용할 수 있습니다.Valid with the /output option only.
/?/? 이 도구의 명령 구문 및 옵션을 표시합니다.Displays the command syntax and options for the tool.

.exe, .dll.winmd 파일에 사용할 수 있는 추가 옵션은 다음과 같습니다.The following additional options are available for .exe, .dll, and .winmd files.

옵션Option 설명Description
/bytes/bytes 16진수 형식의 실제 바이트 수를 명령 주석으로 표시합니다.Shows actual bytes, in hexadecimal format, as instruction comments.
/caverbal/caverbal 사용자 지정 특성 blob을 일반 텍스트 형식으로 생성합니다.Produces custom attribute blobs in verbal form. 기본값은 이진 형식입니다.The default is binary form.
/linenum/linenum 원본 소스 줄에 대한 참조를 포함합니다.Includes references to original source lines.
/nobar/nobar 디스어셈블리 진행률 표시줄 팝업 창을 표시하지 않습니다.Suppresses the disassembly progress indicator pop-up window.
/noca/noca 사용자 지정 특성 출력을 생성하지 않습니다.Suppresses the output of custom attributes.
/project/project 메타데이터를 기본 Windows 런타임에서 표시되는 방식 대신, 관리 코드에 표시되는 방식으로 표시합니다.Displays metadata the way it appears to managed code, instead of the way it appears in the native Windows Runtime. 만약 PEfilename이 Windows 메타데이터( .winmd) 파일이 아니라면, 이 옵션은 효과가 없습니다.If PEfilename is not a Windows metadata (.winmd) file, this option has no effect. Windows 스토어 앱 및 Windows 런타임에 대한 .NET Framework 지원을 참조하세요.See .NET Framework Support for Windows Store Apps and Windows Runtime.
/pubonly/pubonly 공용 형식 및 멤버만 디스어셈블합니다.Disassembles only public types and members. /visibility:PUB와 같습니다.Equivalent to /visibility:PUB.
/quoteallnames/quoteallnames 모든 이름을 작은따옴표 내에 포함시킵니다.Includes all names in single quotes.
/raweh/raweh 예외 처리 절을 원시 형식으로 표시합니다.Shows exception handling clauses in raw form.
/source/source 주석에 따라 원본 소스 줄을 표시합니다.Shows original source lines as comments.
/tokens/tokens 클래스 및 멤버의 메타데이터 토큰을 표시합니다.Shows metadata tokens of classes and members.
/visibility: vis[+vis...]/visibility: vis[+vis...] 지정된 표시 범위의 형식 또는 멤버만 디스어셈블합니다.Disassembles only types or members with the specified visibility. 다음은 vis에 사용할 수 있는 값입니다.The following are valid values for vis:

PUB - PublicPUB — Public

PRI - PrivatePRI — Private

FAM - FamilyFAM — Family

ASM - AssemblyASM — Assembly

FAA - Family and AssemblyFAA — Family and Assembly

FOA - Family or AssemblyFOA — Family or Assembly

PSC - Private ScopePSC — Private Scope

이러한 표시 한정자의 정의는 MethodAttributesTypeAttributes를 참조하십시오.For definitions of these visibility modifiers, see MethodAttributes and TypeAttributes.

.exe, .dll.winmd 파일에 대해 파일 또는 콘솔 출력 전용으로 사용할 수 있는 옵션은 다음과 같습니다.The following options are valid for .exe, .dll, and .winmd files for file or console output only.

옵션Option 설명Description
/all/all /header, /bytes, /stats, /classlist, /tokens 옵션 조합을 지정합니다.Specifies a combination of the /header, /bytes, /stats, /classlist, and /tokens options.
/classlist/classlist 모듈에 정의된 클래스 목록을 포함합니다.Includes a list of classes defined in the module.
/forward/forward 정방향 클래스 선언을 사용합니다.Uses forward class declaration.
/headers/headers 출력에 파일 헤더 정보를 포함시킵니다.Includes file header information in the output.
/item: class[ :: member[(sig]]/item: class[:: member[(sig]] 지정된 인수에 따라 다음과 같이 디스어셈블합니다.Disassembles the following depending upon the argument supplied:

- 지정된 class를 디스어셈블합니다.- Disassembles the specified class.
- 지정된 classmember를 디스어셈블합니다.- Disassembles the specified member of the class.
- 지정된 시그니처 sig가 포함된 classmember를 디스어셈블합니다.- Disassembles the member of the class with the specified signature sig. sig 형식은 다음과 같습니다.The format of sig is:
[instance] returnType(parameterType1, parameterType2, …, parameterTypeN)[instance] returnType(parameterType1, parameterType2, …, parameterTypeN)
참고 .NET Framework 버전 1.0 및 1.1에서는 (sig)와 같이 sig 다음에 닫는 괄호가 있어야 합니다.Note In the .NET Framework versions 1.0 and 1.1, sig must be followed by a closing parenthesis: (sig). .Net Framework 2.0부터는 (sig와 같이 닫는 괄호를 생략해야 합니다.Starting with the Net Framework 2.0 the closing parenthesis must be omitted: (sig.
/noil/noil IL 어셈블리 코드 출력을 표시하지 않습니다.Suppresses IL assembly code output.
/stats/stats 이미지에 대한 통계를 포함합니다.Includes statistics on the image.
/typelist/typelist 라운드트립에서 형식 순서를 유지하기 위해 전체 형식 목록을 생성합니다.Produces the full list of types, to preserve type ordering in a round trip.
/unicode/unicode 출력에 유니코드 인코딩을 사용합니다.Uses Unicode encoding for the output.
/utf8/utf8 출력에 UTF-8 인코딩을 사용합니다.Uses UTF-8 encoding for the output. ANSI가 기본값입니다.ANSI is the default.

.exe, .dll, .obj, .lib.winmd 파일에 대해 파일 또는 콘솔 출력 전용으로 사용할 수 있는 옵션은 다음과 같습니다.The following options are valid for .exe, .dll, .obj, .lib, and .winmd files for file or console output only.

옵션Option 설명Description
/metadata[=specifier]/metadata[=specifier] 메타데이터를 표시합니다. specifier는 다음과 같습니다.Shows metadata, where specifier is:

MDHEADER - 메타데이터 헤더 정보 및 크기를 표시합니다.MDHEADER — Show the metadata header information and sizes.

HEX - 정보를 단어뿐만 아니라 16진수로 표시합니다.HEX — Show information in hex as well as in words.

CSV - 레코드 개수 및 힙 크기를 표시합니다.CSV — Show the record counts and heap sizes.

UNREX - 확인할 수 없는 외부 참조를 표시합니다.UNREX — Show unresolved externals.

SCHEMA - 메타데이터 헤더 및 스키마 정보를 표시합니다.SCHEMA — Show the metadata header and schema information.

RAW - 원시 메타데이터 테이블을 표시합니다.RAW — Show the raw metadata tables.

HEAPS - 원시 힙을 표시합니다.HEAPS — Show the raw heaps.

VALIDATE - 메타데이터의 일관성을 확인합니다.VALIDATE — Validate the consistency of the metadata.

specifier에 대해 다른 값을 사용하여 /metadata를 여러 번 지정할 수 있습니다.You can specify /metadata multiple times, with different values for specifier.

.lib 파일에 대해 파일 또는 콘솔 출력 전용으로 사용할 수 있는 옵션은 다음과 같습니다.The following options are valid for .lib files for file or console output only.

옵션Option 설명Description
/objectfile=filename/objectfile=filename 지정된 라이브러리에 있는 단일 개체 파일의 메타데이터를 표시합니다Shows the metadata of a single object file in the specified library.

참고

Ildasm.exe의 모든 옵션은 대/소문자가 구분되지 않으며 처음 세 문자로 인식됩니다.All options for Ildasm.exe are case-insensitive and recognized by the first three letters. 예를 들어 /quo/quoteallnames와 같습니다.For example, /quo is equivalent to /quoteallnames. 인수를 지정하는 옵션에는 옵션과 인수 사이의 구분 기호로 콜론(:) 또는 등호(=) 중 하나만 사용할 수 있습니다.Options that specify arguments accept either a colon (:) or an equal sign (=) as the separator between the option and the argument. 예를 들어 /output: filename/output= filename과 같습니다.For example, /output: filename is equivalent to /output= filename.

설명Remarks

Ildasm.exe는 디스크의 PE 파일에 대해서만 작동하며,Ildasm.exe only operates on PE files on disk. 전역 어셈블리 캐시에 설치된 파일에 대해서는 작동하지 않습니다.It does not operate on files installed in the global assembly cache.

Ildasm.exe를 사용하여 생성한 텍스트 파일은 IL 어셈블러(Ilasm.exe)에 대한 입력 파일로 사용될 수 있습니다.The text file produced by Ildasm.exe can be used as input to the IL Assembler (Ilasm.exe). 이렇게 하면 런타임 메타데이터 특성을 모두 지원하지 않는 프로그래밍 언어로 코드를 컴파일할 때 유용합니다.This is useful, for example, when compiling code in a programming language that does not support all the runtime metadata attributes. 코드를 컴파일하고 Ildasm.exe를 사용하여 출력을 실행한 후에는 결과로 만들어지는 IL 텍스트 파일을 수동으로 편집하여 손실된 특성을 추가할 수 있습니다.After compiling the code and running its output through Ildasm.exe, the resulting IL text file can be hand-edited to add the missing attributes. 그런 다음에는 IL 어셈블러를 통해 이 텍스트 파일을 실행하여 최종 실행 파일을 생성할 수 있습니다.You can then run this text file through the IL Assembler to produce a final executable file.

참고

포함된 네이티브 코드가 들어 있는 PE 파일(예: Visual C++로 생성된 PE 파일)에는 현재 이 방법을 사용할 수 없습니다.Currently, you cannot use this technique with PE files that contain embedded native code (for example, PE files produced by Visual C++).

IL 디스어셈블러의 기본 GUI를 사용하면 계층 구조 트리 뷰에서 기존 PE 파일의 메타데이터 및 디스어셈블된 코드를 볼 수 있습니다.You can use the default GUI in the IL Disassembler to view the metadata and disassembled code of any existing PE file in a hierarchical tree view. 이 GUI를 사용하려면 해당 명령줄에서 ildasm을 입력합니다. 이때 PEfilename 인수나 기타 옵션은 지정하지 않습니다.To use the GUI, type ildasm at the command line without supplying the PEfilename argument or any options. 파일 메뉴에서 Ildasm.exe에 로드하려는 PE 파일 탐색할 수 있습니다.From the File menu, you can navigate to the PE file that you want to load into Ildasm.exe. 선택한 PE에 대해 표시된 메타데이터 및 디스어셈블된 코드를 저장하려면 파일 메뉴에서 덤프 명령을 선택합니다.To save the metadata and disassembled code displayed for the selected PE, select the Dump command from the File menu. 계층 구조 트리 뷰만 저장하려면 파일 메뉴에서 트리 뷰 덤프 명령을 선택합니다.To save the hierarchical tree view only, select the Dump Treeview command from the File menu. Ildasm.exe로 파일을 로드하고 출력 내용을 해석하는 방법에 대한 자세한 지침을 보려면 Windows SDK와 함께 제공되는 Samples 폴더의 Ildasm.exe 자습서를 참조하세요.For a detailed guide to loading a file into Ildasm.exe and interpreting the output, see the Ildasm.exe Tutorial, located in the Samples folder that ships with the Windows SDK.

Ildasm.exe에 포함 리소스가 들어 있는 PEfilename 인수를 제공하면 여러 개의 출력 파일이 생성됩니다. 즉, IL 코드가 들어 있는 텍스트 파일이 생성되고, 관리되는 각 포함 리소스의 경우 메타데이터의 리소스 이름을 사용하여 .resources 파일이 생성됩니다.If you provide Ildasm.exe with a PEfilename argument that contains embedded resources, the tool produces multiple output files: a text file that contains IL code and, for each embedded managed resource, a .resources file produced using the resource's name from metadata. 관리되지 않는 리소스가 PEfilename에 포함되어 있으면 /output 옵션으로 IL 출력에 대해 지정한 파일 이름을 사용하여 .res 파일이 생성됩니다.If an unmanaged resource is embedded in PEfilename, a .res file is produced using the filename specified for IL output by the /output option.

참고

Ildasm.exe를 사용하면 .obj.lib 입력 파일에 대해 메타데이터 설명만 표시되며,Ildasm.exe shows only metadata descriptions for .obj and .lib input files. 이러한 파일 형식에 대한 IL 코드는 디스어셈블되지 않습니다.IL code for these file types is not disassembled.

.exe 또는 .dll 파일을 통해 Ildasm.exe를 실행하여 파일이 관리되는지 여부를 확인할 수 있습니다.You can run Ildasm.exe over an.exe or .dll file to determine whether the file is managed. 파일이 관리되지 않으면 파일에 올바른 공용 언어 런타임 헤더가 없어 디스어셈블될 수 없음을 나타내는 메시지가 표시됩니다.If the file is not managed, the tool displays a message stating that the file has no valid common language runtime header and cannot be disassembled. 파일이 관리되면 도구가 성공적으로 실행됩니다.If the file is managed, the tool runs successfully.

버전 정보Version Information

.NET Framework 4.5부터 제공되는 Ildasm.exe는 원시 이진 콘텐츠를 표시하여 인식할 수 없는 마샬 BLOB(Binary Large Object)을 처리합니다.Starting with the .NET Framework 4.5, Ildasm.exe handles an unrecognized marshal BLOB (binary large object) by displaying the raw binary content. 예를 들어, 다음 코드는 C# 프로그램에서 생성된 마샬 BLOB가 표시되는 방법을 보여 줍니다.For example, the following code shows how a marshal BLOB generated by a C# program is displayed:

public void Test([MarshalAs((short)70)] int test) { }
// IL from Ildasm.exe output
.method public hidebysig instance void Test(int32  marshal({ 46 }) test) cil managed

.NET Framework 4.5부터 제공되는 Ildasm.exeIldasm.exe 출력에서 발췌한 다음 예제에서와 같이 인터페이스 구현에 적용되는 특성을 표시합니다.Starting with the .NET Framework 4.5, Ildasm.exe displays attributes that are applied to interface implementations, as shown in the following excerpt from Ildasm.exe output:

.class public auto ansi beforefieldinit MyClass
  extends [mscorlib]System.Object
  implements IMyInterface
  {
    .interfaceimpl type IMyInterface
    .custom instance void
      [mscorlib]System.Diagnostics.DebuggerNonUserCodeAttribute::.ctor() = ( 01 00 00 00 )
      …

예제Examples

다음 명령을 사용하여 PE 파일 MyHello.exe에 대한 메타데이터 및 디스어셈블된 코드를 Ildasm.exe의 기본 GUI에 표시합니다.The following command causes the metadata and disassembled code for the PE file MyHello.exe to display in the Ildasm.exe default GUI.

ildasm myHello.exe

다음 명령을 사용하여 MyFile.exe 파일을 디스어셈블하고 그 결과로 만들어지는 IL 어셈블러 텍스트를 MyFile.il 파일에 저장합니다.The following command disassembles the file MyFile.exe and stores the resulting IL Assembler text in the file MyFile.il.

ildasm MyFile.exe /output:MyFile.il

다음 명령을 사용하여 MyFile.exe 파일을 디스어셈블하고 그 결과로 만들어지는 IL 어셈블러 텍스트를 콘솔 창에 표시합니다.The following command disassembles the file MyFile.exe and displays the resulting IL Assembler text to the console window.

ildasm MyFile.exe /text

MyApp.exe 파일에 관리되는 포함 리소스와 관리되지 않는 포함 리소스가 들어 있는 경우, 다음 명령을 사용하여 다음과 같은 4개 파일을 생성합니다. MyApp.il, MyApp.res, Icons.resourcesMessage.resources.If the file MyApp.exe contains embedded managed and unmanaged resources, the following command produces four files: MyApp.il, MyApp.res, Icons.resources, and Message.resources:

ildasm MyApp.exe /output:MyApp.il

다음 명령을 사용하여 MyFile.exeMyClass 클래스 내에 있는 MyMethod 메서드를 디스어셈블하고 해당 출력을 콘솔 창에 표시합니다.The following command disassembles the method MyMethod within the class MyClass in MyFile.exe and displays the output to the console window.

ildasm /item:MyClass::MyMethod MyFile.exe /text

앞의 예제에서는 시그니처가 서로 다른 MyMethod 메서드가 여러 개 있을 수 있습니다.In the previous example, there could be several methods named MyMethod with different signatures. 다음 명령을 사용하여 반환 형식이 void이고 매개 변수 형식이 int32string인 인스턴스 메서드 MyMethod를 디스어셈블합니다.The following command disassembles the instance method MyMethod with the return type of void and the parameter types int32 and string.

ildasm /item:"MyClass::MyMethod(instance void(int32,string)" MyFile.exe /text

참고

.NET Framework 버전 1.0 및 1.1에서는 MyMethod(instance void(int32))와 같이 메서드 이름 다음의 왼쪽 괄호와 시그니처 다음의 오른쪽 괄호가 짝을 이뤄야 합니다.In the .NET Framework versions 1.0 and 1.1, the left parenthesis that follows the method name must be balanced by a right parenthesis after the signature: MyMethod(instance void(int32)). .NET Framework 2.0부터는 MyMethod(instance void(int32)와 같이 닫는 괄호를 생략해야 합니다.Starting with the .NET Framework 2.0 the closing parenthesis must be omitted: MyMethod(instance void(int32).

static 메서드(Visual Basic의 경우 Shared 메서드)를 검색하려면 instance 키워드를 생략합니다.To retrieve a static method (Shared method in Visual Basic), omit the keyword instance. int32string과 같이 기본 형식이 아닌 클래스 형식은 네임스페이스를 포함해야 하며 앞에 class 키워드가 있어야 합니다.Class types that are not primitive types like int32 and string must include the namespace and must be preceded by the keyword class. 외부 형식 앞에는 대괄호로 묶인 라이브러리 이름이 있어야 합니다.External types must be preceded by the library name in square brackets. 다음 명령은 MyMethod 형식의 매개 변수가 하나 있고 반환 형식이 AppDomainAppDomain라는 정적 메서드를 디스어셈블합니다.The following command disassembles a static method named MyMethod that has one parameter of type AppDomain and has a return type of AppDomain.

ildasm /item:"MyClass::MyMethod(class [mscorlib]System.AppDomain(class [mscorlib]System.AppDomain)" MyFile.exe /text

중첩 형식은 해당 형식을 포함하는 클래스와 슬래시 다음에 있어야 합니다.A nested type must be preceded by its containing class, delimited by a forward slash. 예를 들어, MyNamespace.MyClass 클래스에 NestedClass라는 중첩 클래스가 들어 있으면 중첩 클래스는 class MyNamespace.MyClass/NestedClass로 식별됩니다.For example, if the MyNamespace.MyClass class contains a nested class named NestedClass, the nested class is identified as follows: class MyNamespace.MyClass/NestedClass.

참고 항목See also