Skip to content

troubleshooting.md

Latest commit

 

History

History
10 lines (8 loc) · 1.32 KB

troubleshooting.md

File metadata and controls

10 lines (8 loc) · 1.32 KB

Troubleshooting NativeAOT compiler

Sometimes you want to have more information how NativeAOT works. The compiler provides several switches for that:

  • <IlcGenerateMetadataLog>true</IlcGenerateMetadataLog>: Enable generation of metadata log. This class is CSV format with following structure: Handle, Kind, Name, Children.
  • <IlcGenerateDgmlFile>true</IlcGenerateDgmlFile>: Generates log files ProjectName.codegen.dgml.xml and ProjectName.scan.dgml.xml in DGML format.
  • <IlcGenerateMapFile>true</IlcGenerateMapFile>: Generates log files ProjectName.map.xml which describe layout of objects.
  • <IlcSingleThreaded>true</IlcSingleThreaded>: Perform compilation on single thread.
  • <IlcDumpGeneratedIL>true</IlcDumpGeneratedIL>: Dump IL for method bodies the compiler generated on the fly into ProjectName.il. This can be helpful when debugging IL generation - e.g. marshalling. The compiler maps debug information to this file, so it's possible to step in it and set breakpoints.
  • <IlcGenerateMstatFile>true</IlcGenerateMstatFile>: Generates an mstat file which contains size information about types, methods and blobs emitted. The mstat file is a .NET assembly that encodes this data in a structured and space efficient way and can be parsed like this: dotnet#73913 (comment).