diff options
| author | Djordje Todorovic <djordje.todorovic@rt-rk.com> | 2020-01-15 11:50:59 +0100 |
|---|---|---|
| committer | Djordje Todorovic <djordje.todorovic@rt-rk.com> | 2020-01-15 12:00:43 +0100 |
| commit | ada964661e2b4d86b0753c99265c812029a3d1d2 (patch) | |
| tree | 9af38fbdb62be0f2b35e0df9f6fc57ab67609446 /llvm/docs/CommandGuide/llvm-locstats.rst | |
| parent | 46d11e30ee807accefd14e0b7f306647963a39b5 (diff) | |
| download | bcm5719-llvm-ada964661e2b4d86b0753c99265c812029a3d1d2.tar.gz bcm5719-llvm-ada964661e2b4d86b0753c99265c812029a3d1d2.zip | |
[llvm-locstats] Add the --draw-plot option
When using the option, draw the histogram representing the debug
location buckets. The resulting histogram will be saved in a png
file.
Differential Revision: https://reviews.llvm.org/D71869
Diffstat (limited to 'llvm/docs/CommandGuide/llvm-locstats.rst')
| -rw-r--r-- | llvm/docs/CommandGuide/llvm-locstats.rst | 69 |
1 files changed, 45 insertions, 24 deletions
diff --git a/llvm/docs/CommandGuide/llvm-locstats.rst b/llvm/docs/CommandGuide/llvm-locstats.rst index 8fce21df5a9..227c069aca9 100644 --- a/llvm/docs/CommandGuide/llvm-locstats.rst +++ b/llvm/docs/CommandGuide/llvm-locstats.rst @@ -38,40 +38,61 @@ OPTIONS ignore the location statistics on locations containing the debug entry values DWARF operation +.. option:: --draw-plot + + make histogram of location buckets generated (requires + matplotlib) + EXIT STATUS ----------- :program:`llvm-locstats` returns 0 if the input file were parsed successfully. Otherwise, it returns 1. -OUTPUT EXAMPLE +EXAMPLE 1 -------------- +Pretty print the location coverage on the standard output. + .. code-block:: none - ================================================= - Debug Location Statistics - ================================================= - cov% samples percentage(~) - ------------------------------------------------- - 0% 1 16% - (0%,10%) 0 0% - [10%,20%) 0 0% - [20%,30%) 0 0% - [30%,40%) 0 0% - [40%,50%) 0 0% - [50%,60%) 1 16% - [60%,70%) 0 0% - [70%,80%) 0 0% - [80%,90%) 1 16% - [90%,100%) 0 0% - 100% 3 50% - ================================================= - -the number of debug variables processed: 6 - -PC ranges covered: 81% - ------------------------------------------------- - -total availability: 83% - ================================================= + llvm-locstats a.out + + ================================================= + Debug Location Statistics + ================================================= + cov% samples percentage(~) + ------------------------------------------------- + 0% 1 16% + (0%,10%) 0 0% + [10%,20%) 0 0% + [20%,30%) 0 0% + [30%,40%) 0 0% + [40%,50%) 0 0% + [50%,60%) 1 16% + [60%,70%) 0 0% + [70%,80%) 0 0% + [80%,90%) 1 16% + [90%,100%) 0 0% + 100% 3 50% + ================================================= + -the number of debug variables processed: 6 + -PC ranges covered: 81% + ------------------------------------------------- + -total availability: 83% + ================================================= + +EXAMPLE 2 +-------------- + +Generate a plot as an image file. + +.. code-block:: none + + llvm-locstats --draw-plot file1.out + +.. image:: locstats-draw-plot.png + :align: center SEE ALSO -------- |
