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.