Disassembler MSIL (Ildasm.exe)
Aggiornamento: novembre 2007
Disassembler MSIL è uno strumento abbinato ad Assembler MSIL (Ilasm.exe). Ildasm.exe opera su un file eseguibile portabile (PE, Portable Executable) contenente codice MSIL (Microsoft Intermediate Language) e crea un file di testo adatto come input per Ilasm.exe.
ildasm [options] [PEfilename] [options]
Parametri
Le opzioni che seguono sono disponibili per i file EXE, DLL, OBJ e LIB.
Opzione |
Descrizione |
|---|---|
/output=nomefile |
Crea un file di output con il nomefile specificato anziché visualizzare i risultati in un'interfaccia utente grafica. |
/rtf |
Genera l'output in formato RTF (Rich Text Format). Non è valida con l'opzione /text. Questa è una nuova opzione di .NET Framework versione 2.0. |
/text |
Visualizza i risultati nella finestra di console, anziché in un'interfaccia utente grafica o come file di output. |
/html |
Genera l'output in formato HTML. È valida solo con l'opzione /output. Questa è una nuova opzione di .NET Framework versione 2.0. |
/? |
Visualizza la sintassi e le opzioni dei comandi dello strumento. |
Le altre opzioni che seguono sono disponibili per i file EXE e DLL.
Opzione |
Descrizione |
|---|---|
/bytes |
Indica i byte effettivi, in formato esadecimale, come commenti di istruzioni. |
/caverbal |
Genera blob di attributo personalizzato in forma descrittiva. La forma predefinita è quella binaria. Questa è una nuova opzione di .NET Framework versione 2.0. |
/linenum |
Include riferimenti alle righe di origine. |
/nobar |
Evita la visualizzazione della finestra popup contenente l'indicatore di stato del disassembler. |
/noca |
Evita la generazione dell'output di attributi personalizzati. Questa è una nuova opzione di .NET Framework versione 2.0. |
/pubonly |
Disassembla solo membri e tipi pubblici. Equivale a /visibility:PUB. |
/quoteallnames |
Racchiude tutti i nomi tra virgolette singole. |
/raweh |
Indica clausole di gestione delle eccezioni in formato non elaborato. |
/source |
Indica le righe di origine come commenti. |
/tokens |
Indica i token dei metadati di classi e membri. |
/visibility:vis[+vis...] |
Disassembla solo tipi o membri che presentano la visibilità specificata. Di seguito sono riportati i valori validi per vis: PUB (Public) PRI (Private) FAM (Family) ASM (Assembly) FAA (Family and Assembly) FOA (Family or Assembly) PSC (Private Scope) Per le definizioni di questi modificatori di visibilità, vedere MethodAttributes e TypeAttributes. |
Le opzioni che seguono sono valide per i file EXE e DLL e per il solo output su file o su console.
Opzione |
Descrizione |
|---|---|
/all |
Specifica una combinazione delle opzioni /header, /bytes, /stats, /classlist e /tokens. Nota In .NET Framework versioni 1.0 e 1.1, specifica una combinazione delle opzioni /header, /bytes e /tokens. |
/classlist |
Include un elenco di classi definite nel modulo. Questa è una nuova opzione di .NET Framework versione 2.0. |
/forward |
Utilizza la dichiarazione con prototipo della classe. Questa è una nuova opzione di .NET Framework versione 2.0. |
/header |
Include nell'output le informazioni sull'intestazione del file. |
/item:classe[::member[(sig]] |
Disassembla quanto segue a seconda dell'argomento fornito:
|
/noil |
Evita la visualizzazione dell'output del codice assembly MSIL. |
/stats |
Include le statistiche relative all'immagine. Questa è una nuova opzione di .NET Framework versione 2.0. |
/typelist |
Genera l'elenco completo dei tipi per mantenere l'ordinamento dei tipi in un round trip. Questa è una nuova opzione di .NET Framework versione 2.0. |
/unicode |
Utilizza la codifica Unicode per l'output. |
/utf8 |
Utilizza la codifica UTF-8 per l'output. ANSI è il valore predefinito. |
Le opzioni che seguono sono valide per i file EXE, DLL, OBJ e LIB solo per l'output su file o console.
Opzione |
Descrizione |
|---|---|
/metadata[=specifier] |
Mostra i metadati, dove specifier è: MDHEADER: mostra le informazioni sull'intestazione e le dimensioni dei metadati. HEX: mostra le informazioni in esadecimali e in parole. CSV: mostra i conteggi di record e le dimensioni heap. UNREX: mostra riferimenti esterni non risolti. SCHEMA: mostra le informazioni sull'intestazione e lo schema dei metadati. RAW: mostra le tabelle di metadati non elaborate. HEAPS: mostra gli heap non elaborati. VALIDATE: convalida l'uniformità dei metadati. È possibile specificare /metadata più volte, con valori differenti per specifier. Questa è una nuova opzione di .NET Framework versione 2.0. |
Le opzioni che seguono sono valide per i file LIB e per il solo output su file o su console.
Opzione |
Descrizione |
|---|---|
/objectfile=filename |
Mostra i metadati di un singolo file oggetto nella libreria specificata. Questa è una nuova opzione di .NET Framework versione 2.0. |
Nota
Per tutte le opzioni di Ildasm.exe l'esatta combinazione di maiuscole e minuscole non è rilevante ed inoltre tali opzioni vengono riconosciute dalle prime tre lettere. /quo equivale ad esempio a /quoteallnames. Le opzioni che specificano argomenti accettano i due punti (:) o un segno di uguale (=) come separatore tra l'opzione e l'argomento. /output:nomefile equivale ad esempio a /output=nomefile.
Note
Ildasm.exe opera solo su file PE su disco e non su file installati nella Global Assembly Cache.
Il file di testo prodotto da Ildasm.exe è utilizzabile come input per Assembler MSIL (Ilasm.exe). Questo è utile, ad esempio, quando si compila del codice in un linguaggio di programmazione che non supporta tutti gli attributi di metadati del runtime. Dopo aver compilato il codice ed eseguito l'output tramite Ildasm.exe, il file di testo MSIL ottenuto potrà essere modificato manualmente per aggiungere gli attributi mancanti. Sarà quindi possibile eseguire questo file di testo mediante Assembler MSIL per produrre un file eseguibile finale.
Nota
Attualmente non è possibile avvalersi di questa tecnica con file PE contenenti codice nativo incorporato, ad esempio file PE prodotti da Visual C++ .NET.
È possibile utilizzare la GUI predefinita di Disassembler MSIL per visualizzare i metadati e il codice disassemblato di qualsiasi file PE esistente in una visualizzazione struttura di tipo gerarchico. Per utilizzare la GUI, digitare ildasm alla riga di comando senza fornire l'argomento PEfilename né alcuna opzione. Dal menu File è possibile selezionare il file PE che si desidera caricare in Ildasm.exe. Per salvare i metadati e il codice disassemblato visualizzati per il file PE selezionato, scegliere il comando Dump dal menu File. Per salvare solo la visualizzazione struttura gerarchica, scegliere Esegui il dump di TreeView dal menu File. Per una guida dettagliata per il caricamento dei file in Ildasm.exe e per l'interpretazione dell'output, vedere l'esercitazione di Ildasm.exe, contenuta nella cartella Samples fornita con Windows Software Development Kit (SDK).
Se si fornisce a Ildasm.exe un argomento PEfilename che contiene risorse incorporate, lo strumento produrrà più file di output: un file di testo contenente codice MSIL e, per ciascuna risorsa gestita incorporata, un file RESOURCES prodotto utilizzando il nome della risorsa dai metadati. Se in PEfilename è incorporata una risorsa non gestita, verrà prodotto un file RES utilizzando il nome file specificato dall'opzione /output per l'output MSIL*.*
Nota
In Ildasm.exe sono presenti solo descrizioni di metadati per i file di input OBJ e LIB. Il codice MSIL di questi tipi di file non viene disassemblato.
Per determinare se il file è gestito è possibile eseguire Ildasm.exe su un file EXE o DLL. Se il file non è gestito, verrà visualizzato un messaggio che comunica che il file non include alcuna intestazione common language runtime valida e non può essere disassemblato. Se invece il file è gestito, l'operazione verrà eseguita correttamente.
Esempi
Il comando che segue fa sì che i metadati e il codice disassemblato del file PE MyHello.exe vengano visualizzati nella GUI predefinita di Ildasm.exe.
ildasm myHello.exe
Il comando che segue disassembla il file MyFile.exe e archivia nel file MyFile.il il testo ottenuto per Assembler MSIL.
ildasm MyFile.exe /output:MyFile.il
Il comando che segue disassembla il file MyFile.exe e visualizza nella finestra di console il testo ottenuto per MSIL Assembler.
ildasm MyFile.exe /text
Se il file MyApp.exe contiene risorse incorporate gestite e non gestite, il comando che segue produrrà quattro file: MyApp.il, MyApp.res, Icons.resources, e Message.resources.
ildasm MyApp.exe /output:MyApp.il
Il comando che segue disassembla il metodo MyMethod nella classe MyClass di MyFile.exe e visualizza l'output nella finestra di console.
ildasm /item:MyClass::MyMethod MyFile.exe /text
Nell'esempio precedente potrebbero essere presenti più metodi denominati MyMethod con firme diverse. Il comando che segue disassembla il metodo di istanza MyMethod con il tipo restituito di void e i tipi di parametri int32 e string.
ildasm /item:"MyClass::MyMethod(instance void(int32,string)" MyFile.exe /text
Nota
In .NET Framework versioni 1.0 e 1.1 la parentesi sinistra che segue il nome del metodo deve essere bilanciata da una parentesi destra dopo la firma: MyMethod(instance void(int32)). In .NET Framework versione 2.0 la parentesi di chiusura deve essere omessa: MyMethod(instance void(int32).
Per recuperare un metodo static (metodoShared in Visual Basic), omettere la parola chiave instance. I tipi di classe che non sono tipi primitivi come int32 e string devono includere lo spazio dei nomi e devono essere preceduti dalla parola chiave class. I tipi esterni devono essere preceduti dal nome della libreria tra parentesi quadre. Il comando che segue disassembla un metodo statico denominato MyMethod che ha un parametro di tipo AppDomain e un tipo restituito di AppDomain.
ildasm /item:"MyClass::MyMethod(class [mscorlib]System.AppDomain(class [mscorlib]System.AppDomain)" MyFile.exe /text
Un tipo nidificato deve essere preceduto dalla classe in cui è contenuto, delimitata da una barra. Se ad esempio nella classe MyNamespace.MyClass è contenuta una classe nidificata denominata NestedClass, la classe nidificata viene identificata come segue: class MyNamespace.MyClass/NestedClass.