InlineXmlUtilities

Various utilities for analyzing and manipulating RyuJit's inline Xml.

Inline xml gives a full hierarchical description of all the inlines done by the jit. It is both an output format describing what happend and an input format that can script the behavior of the inliner.

You can produce and consume inline XML from RyuJit, with DEBUG or CHK builds. or from release builds with INLINE_DATA defined.

To produce Inline Xml

Set

COMPlus_JitInlineDumpXml=N

where N is

• 0 -- no xml
• 1 -- full xml for all methods, including failures (in DEBUG/CHK)
• 2 -- xml only for methods with inlines, including failures (in DEBUG/CHK)
• 3 -- xml only for methods with inlines, no failures

The inline xml is current written to stderr.

To analyze Inline Xml

The utilities in this repo allow you to analyze inline xml and summarize the inliner's behavior.

To use Inline Xml to script (replay) inlining

You can feed inline Xml into the jit to force it perform particular inlines. The inline xml can come from the jit as above, or you can hand craft the xml or modify the jit's xml.

To enable replay, set

COMPlus_JitInlinePolicyReplay=1 COMPlus_JitInlineReplayFile=inlines.xml

Methods not mentioned in the inline XML will not have any inlines performed.

For an example of how all this can be used to programmatically explore the impact of inlines on a program, see the PerformanceExplorer repo.