mcs/tools/aprofutil/README.md

   1 **aprofutil** is a tool to inspect AOT profiler files
   2
   3 ```
   4 Usage: aprofutil.exe OPTIONS* <aotprofile-file>
   5
   6 Processes AOTPROFILE files created by Mono's AOT Profiler
   7
   8 Copyright 2019 Microsoft Corporation
   9
  10 Options:
  11   -h, --help, -?             Show this message and exit
  12   -a, --all                  Show modules, types and methods in the profile
  13   -d, --modules              Show modules in the profile
  14       --filter-method=VALUE  Filter by method with regex VALUE
  15       --filter-module=VALUE  Filter by module with regex VALUE
  16       --filter-type=VALUE    Filter by type with regex VALUE
  17   -m, --methods              Show methods in the profile
  18   -s, --summary              Show summary of the profile
  19   -t, --types                Show types in the profile
  20   -v, --verbose              Output information about progress during the run
  21                                of the tool
  22
  23 If no other option than -v is used then --all is used by default
  24 ```
  25
  26 It can be use to show and filter the profiler file content in readable text form.
  27
  28 ### Example usage
  29
  30 Display modules and summary of XA startup profile
  31 ```
  32 mono aprofutil.exe -sd startup.aotprofile
  33 Modules:
  34         41C38B0A-2032-45CE-8638-0299CED65330 mscorlib
  35         0326DF03-2158-4F7A-9A2B-B7A9419F021D Mono.Android
  36         8FB63BB4-1195-4173-A9ED-0EC341B07C32 System
  37         74C06E06-C1C7-4A4C-B64E-EAC7DBB08BBC Java.Interop
  38         11E2319F-6A26-461C-9C46-C972248BEE4B System.Core
  39         7999CC4B-D566-4ECA-8A72-469344172CA3 Xamarin.Forms.Platform.Android
  40         C5089213-328B-451D-BA87-D6585C120780 Xamarin.Forms.Performance.Integration.Droid
  41         D754F8AE-503C-41C8-B16F-647FC662507A Xamarin.Android.Support.v7.AppCompat
  42         929ECB6D-1171-4C66-8470-DD32AC608969 Xamarin.Android.Support.Fragment
  43         F841E23B-59A8-4AE2-9A84-D2FC1D891B4A Xamarin.Forms.Core
  44         945CCBF8-C2DB-468B-B3BD-D7ACA37B69AD Xamarin.Forms.Performance.Integration
  45         AF20FA19-F07E-4BD4-B5ED-104706EA660E Xamarin.Forms.Xaml
  46         629C84F8-0988-42EF-8BC5-872173A0A71F FormsViewGroup
  47         60398815-8E62-487E-A553-781F56A0849D Xamarin.Android.Support.Design
  48         F0C550D7-665A-40B5-A307-8E9B49976D87 Xamarin.Android.Support.Core.UI
  49         23A34485-DE75-440E-BA9D-E235F664E990 Xamarin.Android.Support.Compat
  50 Summary:
  51         Modules:         16
  52         Types:          907
  53         Methods:      4,230
  54 ```
  55
  56 Filter Java.Interop.Runtime type in XA startup profile:
  57 ```
  58 mono aprofutil.exe --filter-type Java.Interop.Runtime -sa startup.aotprofile
  59 Modules:
  60         0326DF03-2158-4F7A-9A2B-B7A9419F021D Mono.Android
  61 Types:
  62         Java.Interop.Runtime
  63 Methods:
  64         bool Java.Interop.Runtime:IsGCUserPeer (Android.Runtime.IJavaObject)
  65         bool Java.Interop.Runtime:IsGCUserPeer (intptr)
  66 Summary:
  67         Modules:          1  (of 16)
  68         Types:            1  (of 907)
  69         Methods:          2  (of 4230)
  70 ```