Provided by: clang-5.0_5.0-3~16.04.1_amd64 bug

NAME

       modularize - manual page for modularize 5.0

DESCRIPTION

       OVERVIEW: modularize.

       USAGE:  modularize  [options]  <list  of  one or more header list files> <arguments to be passed to front
       end>...

       OPTIONS:

       General options:

       -I=<path>                                         - Include path for coverage check.

       -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

       -block-check-header-list-only                     - Only warn if #include directives are inside extern or
              namespace blocks if the included header is in the header list.

       -bounds-checking-single-trap                      - Use one trap block per function

       -color                                            - use colored syntax highlighting (default=autodetect)

       -coverage-check-only                              - Only do the coverage check.

       -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

       -disable-spill-fusing                             - Disable fusing of spill code into instructions

       -display-file-lists                               - Display lists of  good  files  (no  compile  errors),
              problem files, and a combined list with problem files preceded by a '#'.

       -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

       -module-map-path=<string>                         - Turn on module map output and specify output path  or
              file name. If no path is specified and if prefix option is specified, use prefix for file path.

       -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-coverage-check                                - Don't do the coverage check.

       -no-discriminators                                - Disable generation of discriminator information.

       -nvptx-sched4reg                                  - NVPTX Specific: schedule for register pressue

       -prefix=<string>                                  - Prepend header file paths with this  prefix.  If  not
              specified, the files are considered to be relative to the header list file.

       -print-after-all                                  - Print IR after each pass

       -print-before-all                                 - Print IR before each pass

       -print-machineinstrs=<pass-name>                  - Print machine instrs

       -problem-files-list=<string>                      - List of files with compilation or modularization
       problems for assistant mode.
              This will be excluded.

       -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

       -root-module=<string>                             - Specify the name of the root module.

       -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

       -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

       -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 modularize is maintained as a Texinfo manual.   If  the  info  and  modularize
       programs are properly installed at your site, the command

              info modularize

       should give you access to the complete manual.

modularize 5.0                                    October 2017                                     MODULARIZE(1)