SANCOV(1)

📦
version 15.0.7 · 3 versions
, in ubuntu jammy

💖 NAME 💖

sancov — bestie, this is the manual page for sancov 15, and it's a whole User Commands situation. no cap. 🎀

✨ DESCRIPTION ✨

🦋 OVERVIEW: Sanitizer Coverage Processing Tool (sancov)

okay so listen. this tool is your girl for pulling coverage-related information out of literally everything, and it can do it from all of these:

  • coverage-instrumented binary files
  • raw .sancov files
  • their symbolized .symcov version

the vibe is that depending on which action you pick, it expects different input files. so like, read the room before you feed it stuff:

  • -print-coverage-pcs — wants coverage-instrumented binary files
  • -print-coverage — wants .sancov files
  • <other actions> — wants .sancov files & corresponding binary files, and .symcov files

🌸 USAGE 🌸

sancov [options] <action> <binary files...> <.sancov files...> <.symcov files...>

🎀 OPTIONS 🎀

💅 Generic Options

  • --help — shows you the available options (and if you want more, there's --help-hidden for that 👀)
  • --help-list — shows you the list of available options (again, --help-list-hidden exists for the extra-spicy version)
  • --version — prints out the version of this program, slay

🧚 sancov Options

  • Action — required. like, mandatory mandatory. you cannot skip this one bestie 💀
  • --print — prints the coverage addresses
  • --print-coverage-pcs — prints the coverage instrumentation points addresses.
  • --covered-functions — prints all the covered functions.
  • --not-covered-functions — prints all the not-covered functions.
  • --print-coverage-stats — prints the coverage statistics.
  • --html-report — REMOVED. 😭 use -symbolize & coverage-report-server.py instead.
  • --symbolize — produces a symbolized JSON report from a binary report.
  • --merge — merges reports.
  • --demangle — prints the demangled function name
  • --ignorelist=<string> — the ignorelist file (in sanitizer ignorelist format)
  • --skip-dead-files — does not list dead source files in the reports
  • --strip_path_prefix=<string> — strips this prefix off file paths in the reports
fr fr that's the whole page, nothing got left out, we ate and left no crumbs 👑

anyway, that's the tea — this page is from sancov 15, dated July 2023, and it shipped out as part of User Commands. mwah, go read some coverage data, i'm obsessed with you 🫶🌈✨

📦 where this page comes from