VERILATOR_COVERAGE(1)

🌸 NAME 🌸

okay so this is verilator_coverage(1) from User Contributed Perl Documentation, and it's literally the Verilator coverage analyzer 💅. Bestie, it's giving “I read your coverage reports so you don't have to” energy.

✨ SYNOPSIS ✨

verilator_coverage --help
verilator_coverage --version

verilator_coverage --annotate <obj>

verilator_coverage --report summary,hier <datafiles>...

verilator_coverage --report hier <datafiles>...

verilator_coverage  -write merged.dat <datafiles>...

verilator_coverage  -write-info merged.info <datafiles>...

verilator_coverage processes coverage reports generated by Verilated models 🦋.

For documentation see https://verilator.org/guide/latest/exe_verilator_coverage.html.

🎀 ARGUMENT SUMMARY 🎀

here's the whole menu, no skips, no cap — every flag and arg is below 💖

• <filename> — the input data filename, default "coverage.dat" 🍓.
• --annotate <output_dir> — sets the directory name for source annotation.
• --annotate-all — says all files should be shown.
• --annotate-min <count> — sets the minimum occurrence count for uncovered stuff.
• --annotate-points — annotates info from each coverage point.
• --debug — enables debugging with the debug executable.
• --debugi <level> — sets the debug level using the debug executable.
• --filter-type <regex> — keeps only records of the given coverage type.
• --help — displays this message plus the version, then exits.
• --include-reset-arcs — includes reset arcs in FSM arc summaries.
• --levels <depth> — limits how deep the displayed hierarchy report goes.
• --rank — computes the relative importance of tests.
• --report <kind>[,<kind>...] — generates reports: summary, hier, or hierarchy.
• --unlink — with --write, unlinks all inputs.
• --version — displays the program version, then exits.
• --write <filename> — writes aggregate coverage results.
• --write-info <filename.info> — writes a lcov .info file.
• +libext+<ext>+<ext>... — extensions for Verilog files.
• +define+<var>+<value> — defines the given variable.
• -D<var>=<value> — defines the given variable.
• +incdir+<dir> — adds a directory for finding include files.
• -I<dir> — adds a directory for finding include files.
• -y <dir> — specifies the module search directory.

👑 DISTRIBUTION 👑

The latest version is available from https://verilator.org — go get it, bestie ✨.

Copyright 2003-2026 by Wilson Snyder. This program is free software; you can redistribute it and/or modify the Verilator internals under the terms of either the GNU Lesser General Public License Version 3 or the Perl Artistic License Version 2.0.

SPDX-FileCopyrightText: 2003-2026 Wilson Snyder SPDX-License-Identifier: LGPL-3.0-only OR Artistic-2.0

🦋 SEE ALSO 🦋

Go peek at these, iykyk 👀:

• "verilator"
• "lcov"
• verilator_coverage --help — which is the source for this document.
• https://verilator.org/guide/latest/exe_verilator_coverage.html — for detailed documentation.

mwah 💋 sign-off: this page is from perl v5.44.0, dated 2026-11-01, and it's the VERILATOR_COVERAGE(1) manual — periodt, bestie 🫶