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.