Provided by: clang-5.0_5.0-3~16.04.1_amd64 
NAME
sancov - manual page for sancov 5.0
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:
General options:
-aarch64-neon-syntax - Choose style of NEON code to emit from
AArch64 backend:
=generic
- Emit generic NEON assembly
=apple - Emit Apple-style NEON assembly
-amdgpu-dump-comd - Dump AMDGPU Code Object Metadata
-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-comd - Verify AMDGPU Code Object Metadata
-amdgpu-vgpr-index-mode - Use GPR indexing mode instead of
movrel for vector indexing
-arm-add-build-attributes -
-arm-implicit-it - 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
-color - use colored syntax highlighting
(default=autodetect)
-cvp-dont-process-adds -
-debug-counter - Comma separated list of debug counter
skip and count
=predicateinfo-rename
- Controls which variables are renamed with predicateinfo
=newgvn-vn
- Controls which instructions are value numbered
=newgvn-phi
- Controls which instructions we create phi of ops for
-demangle - Print demangled function name.
-disable-spill-fusing - Disable fusing of spill code into
instructions
-do-counter-promotion - Do counter register promotion
-enable-implicit-null-checks - Fold null checks into faulting memory
operations
-enable-load-pre -
-enable-name-compression - Enable name string compression
-enable-objc-arc-opts - enable/disable all ARC Optimizations
-enable-packed-inlinable-literals - Enable packed inlinable literals
(v2f16, v2i16)
-enable-scoped-noalias -
-enable-si-insert-waitcnts - Use new waitcnt insertion pass
-enable-tbaa -
-exhaustive-register-search - Exhaustive Search for registers
bypassing the depth and interference cutoffs of last chance recoloring
-expensive-combines - Enable expensive instruction combines
-filter-print-funcs=<function names> - Only print IR for functions whose name
match this for all print-[before|after][-all] options
-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
-imp-null-check-page-size=<int> - The page size of the target in bytes
-imp-null-max-insts-to-consider=<uint> - The max number of instructions to
consider hoisting loads over (the algorithm is quadratic over this number)
-instcombine-maxarray-size=<uint> - Maximum array size considered when
doing a combine
-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.
-join-liveintervals - Coalesce copies (default=true)
-limit-float-precision=<uint> - Generate low-precision inline
sequences for some float libcalls
-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
-mfuture-regs - Enable future registers
-mips-compact-branches - 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
-print-after-all - Print IR after each pass
-print-before-all - Print IR before each pass
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.
-print-machineinstrs=<pass-name> - Print machine instrs
-r600-ir-structurize - Use StructurizeCFG IR pass
-rdf-dump -
-rdf-limit=<uint> -
-regalloc - Register allocator to use
=pbqp - PBQP register allocator
=greedy
- greedy register allocator
=fast - fast register allocator
=basic - basic register allocator
=default
- pick register allocator based on -O option
-rewrite-map-file=<filename> - Symbol Rewrite Map
-rng-seed=<seed> - Seed for the random number generator
-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-inline-hot-threshold=<N> - Inlined functions that account for
more than N% of all samples collected in the parent function, will be inlined
again.
-sample-profile-max-propagate-iterations=<uint> - Maximum number of iterations to go
through when propagating sample block/edge weights through the CFG.
-simplify-mir - Leave out unnecessary information when
printing MIR
-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.
-stackmap-version=<int> - Specify the stackmap encoding version
(default = 3)
-static-func-full-module-prefix - Use full module build paths in the
profile counter names for static functions.
-static-func-strip-dirname-prefix=<uint> - Strip specified level of directory
name from source path in the profile counter name for static functions.
-stats - Enable statistics output from program
(available with Asserts)
-stats-json - Display statistics as json data
-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-passes - Time each pass, printing elapsed time
for each on exit
-unfold-element-atomic-memcpy-max-elements=<uint> - Maximum number of elements in atomic
memcpy the optimizer is allowed to unfold
-verify-debug-info -
-verify-dom-info - Verify dominator info (time consuming)
-verify-loop-info - Verify loop info (time consuming)
-verify-loop-lcssa - Verify loop lcssa form (time
consuming)
-verify-machine-dom-info - Verify machine dominator info (time
consuming)
-verify-regalloc - Verify during register allocation
-verify-region-info - Verify region info (time consuming)
-verify-scev - Verify ScalarEvolution's backedge
taken counts (slow)
-verify-scev-maps - Verify no dangling value in
ScalarEvolution's ExprValueMap (slow)
-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
-x86-asm-syntax - Choose style of code to emit from X86
backend:
=att - Emit AT&T-style assembly
=intel - Emit Intel-style assembly
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
SEE ALSO
The full documentation for sancov is maintained as a Texinfo manual. If the info and
sancov programs are properly installed at your site, the command
info sancov
should give you access to the complete manual.