verilator/docs/guide/exe_verilator_profcfunc.rst

30 lines
914 B
ReStructuredText
Raw Normal View History

2024-01-01 09:19:59 +01:00
.. Copyright 2003-2024 by Wilson Snyder.
.. SPDX-License-Identifier: LGPL-3.0-only OR Artistic-2.0
2021-09-05 17:33:20 +02:00
verilator_profcfunc
===================
Verilator_profcfunc reads a profile report created by gprof. The names of
the functions are then transformed, assuming the user used Verilator's
2022-12-11 02:09:47 +01:00
--prof-cfuncs, and a report printed showing the percentage of the time,
etc., in each Verilog block.
2021-09-05 17:33:20 +02:00
Due to rounding errors in gprof reports, the input report's percentages may
2022-12-11 02:09:47 +01:00
not total 100%. In the verilator_profcfunc report this will get
2021-09-05 17:33:20 +02:00
reported as a rounding error.
2022-12-11 02:09:47 +01:00
For an overview of the use of verilator_profcfunc, see :ref:`Profiling`.
2021-09-05 17:33:20 +02:00
verilator_profcfunc Arguments
-----------------------------
.. program:: verilator_profcfunc
.. option:: <filename>
The :command:`gprof`-generated filename to read data from. Typically "gprof.out".
.. option:: --help
Displays a help summary, the program version, and exits.