Documentation/dev-options.rst

   1 sparse - extra options for developers
   2 =====================================
   3
   4 SYNOPSIS
   5 --------
   6 ``tools`` [`options`]... `file.c``
   7
   8 DESCRIPTION
   9 -----------
  10
  11 This file is a complement of sparse's man page meant to
  12 document options only useful for development on sparse itself.
  13
  14 OPTIONS
  15 -------
  16
  17 .. option:: -fdump-ir=pass,[pass]
  18
  19   Dump the IR at each of the given passes.
  20
  21   The passes currently understood are:
  22
  23     * ``linearize``
  24     * ``mem2reg``
  25     * ``final``
  26
  27   The default pass is ``linearize``.
  28
  29 .. option:: -f<name-of-the-pass>[-disable|-enable|=last]
  30
  31   If ``=last`` is used, all passes after the specified one are disabled.
  32   By default all passes are enabled.
  33
  34   The passes currently understood are:
  35
  36     * ``linearize`` (can't be disabled)
  37     * ``mem2reg``
  38     * ``optim``
  39
  40 .. option:: -vcompound
  41
  42   Print all compound global data symbols with their sizes and alignment.
  43
  44 .. option:: -vdead
  45
  46   Add ``OP_DEATHNOTE`` annotations to dead pseudos.
  47
  48 .. option:: -vdomtree
  49
  50   Dump the dominance tree after its calculation.
  51
  52 .. option:: -ventry
  53
  54   Dump the IR after all optimization passes.
  55
  56 .. option:: -vpostorder
  57
  58   Dump the reverse postorder traversal of the CFG.