---
name: "sancov-9"
section: "1"
platform: "linux"
package: "clang-tools-9"
version: "1:9.0.1-16.1"
release: "Debian 11 (Bullseye)"
platforms: ["linux"]
url: "https://new.carta.tech/sancov-9"
---

# sancov-9(1)

manual page for sancov 9

## 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