verilator/docs/guide/exe_verilator_profcfunc.rst

30 lines
914 B
ReStructuredText
Raw Normal View History

2024-01-01 08:19:59 +00:00
.. Copyright 2003-2024 by Wilson Snyder.
.. SPDX-License-Identifier: LGPL-3.0-only OR Artistic-2.0
2021-09-05 15:33:20 +00: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 01:09:47 +00:00
--prof-cfuncs, and a report printed showing the percentage of the time,
etc., in each Verilog block.
2021-09-05 15:33:20 +00:00
Due to rounding errors in gprof reports, the input report's percentages may
2022-12-11 01:09:47 +00:00
not total 100%. In the verilator_profcfunc report this will get
2021-09-05 15:33:20 +00:00
reported as a rounding error.
2022-12-11 01:09:47 +00:00
For an overview of the use of verilator_profcfunc, see :ref:`Profiling`.
2021-09-05 15:33:20 +00: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.