Provided by: clang-tools-9_9.0.1-12_amd64 
NAME
sancov - manual page for sancov 9
DESCRIPTION
OVERVIEW: Sanitizer Coverage Processing Tool (sancov)
This tool can extract various coverage-related information from:
coverage-instrumented binary files, raw .sancov files and their symbolized .symcov
version. Depending on chosen action the tool expects different input files:
-print-coverage-pcs - coverage-instrumented binary files
-print-coverage - .sancov files
<other actions>
- .sancov files & corresponding binary files, .symcov files
USAGE: sancov [options] <action> <binary files...> <.sancov files...> <.symcov files...>
OPTIONS:
Color Options:
--color - Use colors in output
(default=autodetect)
General options:
--aarch64-neon-syntax=<value> - Choose style of NEON code to emit
from AArch64 backend:
=generic
- Emit generic NEON assembly
=apple - Emit Apple-style NEON assembly
--amdgpu-disable-loop-alignment - Do not align and prefetch loops
--amdgpu-disable-power-sched - Disable scheduling to minimize mAI
power bursts
--amdgpu-dpp-combine - Enable DPP combiner
--amdgpu-dump-hsa-metadata - Dump AMDGPU HSA Metadata
--amdgpu-enable-global-sgpr-addr - Enable use of SGPR regs for GLOBAL
LOAD/STORE instructions
--amdgpu-enable-merge-m0 - Merge and hoist M0 initializations
--amdgpu-sdwa-peephole - Enable SDWA peepholer
--amdgpu-spill-sgpr-to-smem - Use scalar stores to spill SGPRs if
supported by subtarget
--amdgpu-verify-hsa-metadata - Verify AMDGPU HSA Metadata
--amdgpu-vgpr-index-mode - Use GPR indexing mode instead of
movrel for vector indexing
--arm-add-build-attributes -
--arm-implicit-it=<value> - Allow conditional instructions
outdside of an IT block
=always
- Accept in both ISAs, emit implicit ITs in Thumb
=never - Warn in ARM, reject in Thumb
=arm - Accept in ARM, reject in Thumb
=thumb - Warn in ARM, emit implicit ITs in Thumb
--atomic-counter-update-promoted - Do counter update using atomic fetch
add
for promoted counters only
--blacklist=<string> - Blacklist file (sanitizer blacklist
format).
--bounds-checking-single-trap - Use one trap block per function
--cost-kind=<value> - Target cost kind
=throughput
- Reciprocal throughput
=latency
- Instruction latency
=code-size
- Code size
--cvp-dont-add-nowrap-flags -
--demangle - Print demangled function name.
--disable-promote-alloca-to-lds - Disable promote alloca to LDS
--disable-promote-alloca-to-vector - Disable promote alloca to vector
--do-counter-promotion - Do counter register promotion
--emscripten-cxx-exceptions-whitelist=<string> - The list of function names in which
Emscripten-style exception handling is enabled (see emscripten
EMSCRIPTEN_CATCHING_WHITELIST options)
--enable-cse-in-irtranslator - Should enable CSE in irtranslator
--enable-cse-in-legalizer - Should enable CSE in Legalizer
--enable-emscripten-cxx-exceptions - WebAssembly Emscripten-style
exception handling
--enable-emscripten-sjlj - WebAssembly Emscripten-style
setjmp/longjmp handling
--enable-gvn-memdep -
--enable-load-pre -
--enable-loop-simplifycfg-term-folding -
--enable-name-compression - Enable name string compression
--expensive-combines - Enable expensive instruction combines
--gpsize=<uint> - Global Pointer Addressing Size.
The default size is 8.
--hash-based-counter-split - Rename counter variable of a comdat
function based on cfg hash
--import-all-index - Import all external functions in
index.
--instcombine-code-sinking - Enable code sinking
--instcombine-guard-widening-window=<uint> - How wide an instruction window to
bypass looking for another guard
--instcombine-max-num-phis=<uint> - Maximum number phis to handle in
intptr/ptrint folding
--instcombine-maxarray-size=<uint> - Maximum array size considered when
doing a combine
--instrprof-atomic-counter-update-all - Make all profile counter updates
atomic (for testing only)
--internalize-public-api-file=<filename> - A file containing list of symbol
names to preserve
--internalize-public-api-list=<list> - A list of symbol names to preserve
--iterative-counter-promotion - Allow counter promotion across the
whole loop nest.
--lto-pass-remarks-filter=<regex> - Only record optimization remarks from
passes whose names match the given regular expression
--lto-pass-remarks-format=<format> - The format used for serializing
remarks (default: YAML)
--lto-pass-remarks-output=<filename> - Output filename for pass remarks
--max-counter-promotions=<int> - Max number of allowed counter
promotions
--max-counter-promotions-per-loop=<uint> - Max number counter promotions per
loop to avoid increasing register pressure too much
--memop-size-large=<uint> - Set large value thresthold in memory
intrinsic size profiling. Value of 0 disables the large value profiling.
--memop-size-range=<string> - Set the range of size in memory
intrinsic calls to be profiled precisely, in a format of <start_val>:<end_val>
--merror-missing-parenthesis - Error for missing parenthesis around
predicate registers
--merror-noncontigious-register - Error for register names that aren't
contigious
--mhvx - Enable Hexagon Vector eXtensions
--mhvx=<value> - Enable Hexagon Vector eXtensions
=v60 - Build for HVX v60
=v62 - Build for HVX v62
=v65 - Build for HVX v65
=v66 - Build for HVX v66
--mips-compact-branches=<value> - MIPS Specific: Compact branch policy.
=never
- Do not use compact branches if possible.
=optimal
- Use compact branches where appropiate (default).
=always
- Always use compact branches if possible.
--mips16-constant-islands - Enable mips16 constant islands.
--mips16-hard-float - Enable mips16 hard float.
--mno-compound - Disable looking for compound
instructions for Hexagon
--mno-fixup - Disable fixing up resolved
relocations for Hexagon
--mno-ldc1-sdc1 - Expand double precision loads and
stores to their single precision counterparts
--mno-pairing - Disable looking for duplex
instructions for Hexagon
--mwarn-missing-parenthesis - Warn for missing parenthesis around
predicate registers
--mwarn-noncontigious-register - Warn for register names that arent
contigious
--mwarn-sign-mismatch - Warn for mismatching a signed and
unsigned value
--no-discriminators - Disable generation of discriminator
information.
--nvptx-sched4reg - NVPTX Specific: schedule for register
pressue
--poison-checking-function-local - Check that returns are non-poison
(for testing)
Action (required)
--print - Print coverage addresses
--print-coverage-pcs - Print coverage instrumentation points
addresses.
--covered-functions - Print all covered funcions.
--not-covered-functions - Print all not covered funcions.
--print-coverage-stats - Print coverage statistics.
--html-report - REMOVED. Use -symbolize &
coverage-report-server.py.
--symbolize - Produces a symbolized JSON report from
binary report.
--merge - Merges reports.
--r600-ir-structurize - Use StructurizeCFG IR pass
--rdf-dump -
--rdf-limit=<uint> -
--remarks-section - Emit a section containing remark
diagnostics metadata
--safepoint-ir-verifier-print-only -
--sample-profile-check-record-coverage=<N> - Emit a warning if less than N% of
records in the input profile are matched to the IR.
--sample-profile-check-sample-coverage=<N> - Emit a warning if less than N% of
samples in the input profile are matched to the IR.
--sample-profile-max-propagate-iterations=<uint> - Maximum number of iterations to go
through when propagating sample block/edge weights through the CFG.
--skip-dead-files - Do not list dead source files in
reports.
--speculative-counter-promotion-max-exiting=<uint> - The max number of exiting blocks of a
loop to allow
speculative counter promotion
--speculative-counter-promotion-to-loop - When the option is false, if the
target block is in a loop, the promotion will be disallowed unless the promoted counter
update can be further/iteratively promoted into an acyclic region.
--strip_path_prefix=<string> - Strip this prefix from file paths in
reports.
--summary-file=<string> - The summary file to use for function
importing.
--threads=<int> -
--time-trace-granularity=<uint> - Minimum time granularity (in
microseconds) traced by time profiler
--verify-region-info - Verify region info (time consuming)
--vp-counters-per-site=<number> - The average number of profile
counters allocated per value profiling site.
--vp-static-alloc - Do static counter allocation for
value profiler
Generic Options:
--help - Display available options
(--help-hidden for more)
--help-list - Display list of available options
(--help-list-hidden for more)
--version - Display the version of this program